3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.7 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2017 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
29 * Test APIv3 civicrm_contribute_* functions
31 * @package CiviCRM_APIv3
32 * @subpackage API_Contribution
35 class api_v3_ContributionTest
extends CiviUnitTestCase
{
38 * Assume empty database with just civicrm_data.
40 protected $_individualId;
41 protected $_contribution;
42 protected $_financialTypeId = 1;
43 protected $_apiversion;
44 protected $_entity = 'Contribution';
47 protected $_ids = array();
48 protected $_pageParams = array();
50 * Payment processor ID (dummy processor).
54 protected $paymentProcessorID;
57 * Parameters to create payment processor.
61 protected $_processorParams = array();
64 * ID of created event.
78 public function setUp() {
81 $this->_apiversion
= 3;
82 $this->_individualId
= $this->individualCreate();
83 $this->_params
= array(
84 'contact_id' => $this->_individualId
,
85 'receive_date' => '20120511',
86 'total_amount' => 100.00,
87 'financial_type_id' => $this->_financialTypeId
,
88 'non_deductible_amount' => 10.00,
90 'net_amount' => 95.00,
92 'contribution_status_id' => 1,
94 $this->_processorParams
= array(
97 'payment_processor_type_id' => CRM_Core_PseudoConstant
::getKey('CRM_Financial_BAO_PaymentProcessor', 'payment_processor_type_id', 'Dummy'),
98 'financial_account_id' => 12,
101 'url_site' => 'http://dummy.com',
102 'url_recur' => 'http://dummy.com',
105 $this->paymentProcessorID
= $this->processorCreate();
106 $this->_pageParams
= array(
107 'title' => 'Test Contribution Page',
108 'financial_type_id' => 1,
110 'financial_account_id' => 1,
111 'payment_processor' => $this->paymentProcessorID
,
113 'is_allow_other_amount' => 1,
115 'max_amount' => 1000,
120 * Clean up after each test.
122 public function tearDown() {
123 $this->quickCleanUpFinancialEntities();
124 $this->quickCleanup(array('civicrm_uf_match'));
130 public function testGetContribution() {
132 'contact_id' => $this->_individualId
,
133 'receive_date' => '2010-01-20',
134 'total_amount' => 100.00,
135 'financial_type_id' => $this->_financialTypeId
,
136 'non_deductible_amount' => 10.00,
137 'fee_amount' => 5.00,
138 'net_amount' => 95.00,
140 'invoice_id' => 78910,
142 'contribution_status_id' => 1,
144 $this->_contribution
= $this->callAPISuccess('contribution', 'create', $p);
147 'contribution_id' => $this->_contribution
['id'],
150 $contributions = $this->callAPIAndDocument('contribution', 'get', $params, __FUNCTION__
, __FILE__
);
151 $financialParams['id'] = $this->_financialTypeId
;
153 CRM_Financial_BAO_FinancialType
::retrieve($financialParams, $default);
155 $this->assertEquals(1, $contributions['count']);
156 $contribution = $contributions['values'][$contributions['id']];
157 $this->assertEquals($contribution['contact_id'], $this->_individualId
);
158 // Note there was an assertion converting financial_type_id to 'Donation' which wasn't working.
159 // Passing back a string rather than an id seems like an error/cruft.
160 // If it is to be introduced we should discuss.
161 $this->assertEquals($contribution['financial_type_id'], 1);
162 $this->assertEquals($contribution['total_amount'], 100.00);
163 $this->assertEquals($contribution['non_deductible_amount'], 10.00);
164 $this->assertEquals($contribution['fee_amount'], 5.00);
165 $this->assertEquals($contribution['net_amount'], 95.00);
166 $this->assertEquals($contribution['trxn_id'], 23456);
167 $this->assertEquals($contribution['invoice_id'], 78910);
168 $this->assertEquals($contribution['contribution_source'], 'SSF');
169 $this->assertEquals($contribution['contribution_status'], 'Completed');
170 // Create a second contribution - we are testing that 'id' gets the right contribution id (not the contact id).
171 $p['trxn_id'] = '3847';
172 $p['invoice_id'] = '3847';
174 $contribution2 = $this->callAPISuccess('contribution', 'create', $p);
176 // Now we have 2 - test getcount.
177 $contribution = $this->callAPISuccess('contribution', 'getcount', array());
178 $this->assertEquals(2, $contribution);
179 // Test id only format.
180 $contribution = $this->callAPISuccess('contribution', 'get', array(
181 'id' => $this->_contribution
['id'],
182 'format.only_id' => 1,
184 $this->assertEquals($this->_contribution
['id'], $contribution, print_r($contribution, TRUE));
185 // Test id only format.
186 $contribution = $this->callAPISuccess('contribution', 'get', array(
187 'id' => $contribution2['id'],
188 'format.only_id' => 1,
190 $this->assertEquals($contribution2['id'], $contribution);
192 $contribution = $this->callAPISuccess('contribution', 'get', array(
193 'id' => $this->_contribution
['id'],
195 $this->assertEquals(1, $contribution['count']);
197 // Test get by contact id works.
198 $contribution = $this->callAPISuccess('contribution', 'get', array('contact_id' => $this->_individualId
));
200 $this->assertEquals(2, $contribution['count']);
201 $this->callAPISuccess('Contribution', 'Delete', array(
202 'id' => $this->_contribution
['id'],
204 $this->callAPISuccess('Contribution', 'Delete', array(
205 'id' => $contribution2['id'],
210 * Test that test contributions can be retrieved.
212 public function testGetTestContribution() {
213 $this->callAPISuccess('Contribution', 'create', array_merge($this->_params
, array('is_test' => 1)));
214 $this->callAPISuccessGetSingle('Contribution', array('is_test' => 1));
218 * Test the 'return' param works for all fields.
220 public function testGetContributionReturnFunctionality() {
221 $params = $this->_params
;
222 $params['check_number'] = 'bouncer';
223 $params['payment_instrument_id'] = 'Check';
224 $params['cancel_date'] = 'yesterday';
225 $params['receipt_date'] = 'yesterday';
226 $params['thankyou_date'] = 'yesterday';
227 $params['revenue_recognition_date'] = 'yesterday';
228 $params['amount_level'] = 'Unreasonable';
229 $params['cancel_reason'] = 'You lose sucker';
230 $params['creditnote_id'] = 'sudo rm -rf';
231 $params['tax_amount'] = '1';
232 $address = $this->callAPISuccess('Address', 'create', array(
233 'street_address' => 'Knockturn Alley',
234 'contact_id' => $this->_individualId
,
235 'location_type_id' => 'Home',
237 $params['address_id'] = $address['id'];
238 $contributionPage = $this->contributionPageCreate();
239 $params['contribution_page_id'] = $contributionPage['id'];
240 $contributionRecur = $this->callAPISuccess('ContributionRecur', 'create', array(
241 'contact_id' => $this->_individualId
,
242 'frequency_interval' => 1,
245 $params['contribution_recur_id'] = $contributionRecur['id'];
247 $params['campaign_id'] = $this->campaignCreate();
249 $contributionID = $this->contributionCreate($params);
250 $contribution = $this->callAPISuccessGetSingle('Contribution', array('id' => $contributionID));
251 $this->assertEquals('bouncer', $contribution['check_number']);
252 $this->assertEquals('bouncer', $contribution['contribution_check_number']);
254 $fields = CRM_Contribute_BAO_Contribution
::fields();
255 // Re-add these 2 to the fields to check. They were locked in but the metadata changed so we
256 // need to specify them.
257 $fields['address_id'] = $fields['contribution_address_id'];
258 $fields['check_number'] = $fields['contribution_check_number'];
260 $fieldsLockedIn = array(
261 'contribution_id', 'contribution_contact_id', 'financial_type_id', 'contribution_page_id',
262 'payment_instrument_id', 'receive_date', 'non_deductible_amount', 'total_amount',
263 'fee_amount', 'net_amount', 'trxn_id', 'invoice_id', 'currency', 'cancel_date', 'cancel_reason',
264 'receipt_date', 'thankyou_date', 'contribution_source', 'amount_level', 'contribution_recur_id',
265 'is_test', 'is_pay_later', 'contribution_status_id', 'address_id', 'check_number', 'contribution_campaign_id',
266 'creditnote_id', 'tax_amount', 'revenue_recognition_date', 'decoy',
268 $missingFields = array_diff($fieldsLockedIn, array_keys($fields));
269 // If any of the locked in fields disappear from the $fields array we need to make sure it is still
270 // covered as the test contract now guarantees them in the return array.
271 $this->assertEquals($missingFields, array(29 => 'decoy'), 'A field which was covered by the test contract has changed.');
272 foreach ($fields as $fieldName => $fieldSpec) {
273 $contribution = $this->callAPISuccessGetSingle('Contribution', array('id' => $contributionID, 'return' => $fieldName));
274 $returnField = $fieldName;
275 if ($returnField == 'contribution_contact_id') {
276 $returnField = 'contact_id';
278 $this->assertTrue((!empty($contribution[$returnField]) ||
$contribution[$returnField] === "0"), $returnField);
283 * We need to ensure previous tested behaviour still works as part of the api contract.
285 public function testGetContributionLegacyBehaviour() {
287 'contact_id' => $this->_individualId
,
288 'receive_date' => '2010-01-20',
289 'total_amount' => 100.00,
290 'contribution_type_id' => $this->_financialTypeId
,
291 'non_deductible_amount' => 10.00,
292 'fee_amount' => 5.00,
293 'net_amount' => 95.00,
295 'invoice_id' => 78910,
297 'contribution_status_id' => 1,
299 $this->_contribution
= $this->callAPISuccess('Contribution', 'create', $p);
302 'contribution_id' => $this->_contribution
['id'],
304 $contribution = $this->callAPISuccess('contribution', 'get', $params);
305 $financialParams['id'] = $this->_financialTypeId
;
307 CRM_Financial_BAO_FinancialType
::retrieve($financialParams, $default);
309 $this->assertEquals(1, $contribution['count']);
310 $this->assertEquals($contribution['values'][$contribution['id']]['contact_id'], $this->_individualId
);
311 $this->assertEquals($contribution['values'][$contribution['id']]['financial_type_id'], $this->_financialTypeId
);
312 $this->assertEquals($contribution['values'][$contribution['id']]['contribution_type_id'], $this->_financialTypeId
);
313 $this->assertEquals($contribution['values'][$contribution['id']]['total_amount'], 100.00);
314 $this->assertEquals($contribution['values'][$contribution['id']]['non_deductible_amount'], 10.00);
315 $this->assertEquals($contribution['values'][$contribution['id']]['fee_amount'], 5.00);
316 $this->assertEquals($contribution['values'][$contribution['id']]['net_amount'], 95.00);
317 $this->assertEquals($contribution['values'][$contribution['id']]['trxn_id'], 23456);
318 $this->assertEquals($contribution['values'][$contribution['id']]['invoice_id'], 78910);
319 $this->assertEquals($contribution['values'][$contribution['id']]['contribution_source'], 'SSF');
320 $this->assertEquals($contribution['values'][$contribution['id']]['contribution_status'], 'Completed');
322 // Create a second contribution - we are testing that 'id' gets the right contribution id (not the contact id).
323 $p['trxn_id'] = '3847';
324 $p['invoice_id'] = '3847';
326 $contribution2 = $this->callAPISuccess('contribution', 'create', $p);
328 // now we have 2 - test getcount
329 $contribution = $this->callAPISuccess('contribution', 'getcount', array());
330 $this->assertEquals(2, $contribution);
331 //test id only format
332 $contribution = $this->callAPISuccess('contribution', 'get', array(
333 'id' => $this->_contribution
['id'],
334 'format.only_id' => 1,
336 $this->assertEquals($this->_contribution
['id'], $contribution, print_r($contribution, TRUE));
337 //test id only format
338 $contribution = $this->callAPISuccess('contribution', 'get', array(
339 'id' => $contribution2['id'],
340 'format.only_id' => 1,
342 $this->assertEquals($contribution2['id'], $contribution);
343 $contribution = $this->callAPISuccess('contribution', 'get', array(
344 'id' => $this->_contribution
['id'],
347 $this->assertEquals(1, $contribution['count']);
348 // $this->assertEquals($this->_contribution['id'], $contribution['id'] ) ;
349 //test get by contact id works
350 $contribution = $this->callAPISuccess('contribution', 'get', array('contact_id' => $this->_individualId
));
352 $this->assertEquals(2, $contribution['count']);
353 $this->callAPISuccess('Contribution', 'Delete', array(
354 'id' => $this->_contribution
['id'],
356 $this->callAPISuccess('Contribution', 'Delete', array(
357 'id' => $contribution2['id'],
362 * Create an contribution_id=FALSE and financial_type_id=Donation.
364 public function testCreateEmptyContributionIDUseDonation() {
366 'contribution_id' => FALSE,
369 'check_permissions' => FALSE,
370 'financial_type_id' => 'Donation',
372 $this->callAPISuccess('contribution', 'create', $params);
376 * Check with complete array + custom field.
378 * Note that the test is written on purpose without any
379 * variables specific to participant so it can be replicated into other entities
380 * and / or moved to the automated test suite
382 public function testCreateWithCustom() {
383 $ids = $this->entityCustomGroupWithSingleFieldCreate(__FUNCTION__
, __FILE__
);
385 $params = $this->_params
;
386 $params['custom_' . $ids['custom_field_id']] = "custom string";
388 $result = $this->callAPIAndDocument($this->_entity
, 'create', $params, __FUNCTION__
, __FILE__
);
389 $this->assertEquals($result['id'], $result['values'][$result['id']]['id']);
390 $check = $this->callAPISuccess($this->_entity
, 'get', array(
391 'return.custom_' . $ids['custom_field_id'] => 1,
392 'id' => $result['id'],
394 $this->customFieldDelete($ids['custom_field_id']);
395 $this->customGroupDelete($ids['custom_group_id']);
396 $this->assertEquals("custom string", $check['values'][$check['id']]['custom_' . $ids['custom_field_id']]);
400 * Check with complete array + custom field.
402 * Note that the test is written on purpose without any
403 * variables specific to participant so it can be replicated into other entities
404 * and / or moved to the automated test suite
406 public function testCreateGetFieldsWithCustom() {
407 $ids = $this->entityCustomGroupWithSingleFieldCreate(__FUNCTION__
, __FILE__
);
408 $idsContact = $this->entityCustomGroupWithSingleFieldCreate(__FUNCTION__
, 'ContactTest.php');
409 $result = $this->callAPISuccess('Contribution', 'getfields', array());
410 $this->assertArrayHasKey('custom_' . $ids['custom_field_id'], $result['values']);
411 $this->assertArrayNotHasKey('custom_' . $idsContact['custom_field_id'], $result['values']);
412 $this->customFieldDelete($ids['custom_field_id']);
413 $this->customGroupDelete($ids['custom_group_id']);
414 $this->customFieldDelete($idsContact['custom_field_id']);
415 $this->customGroupDelete($idsContact['custom_group_id']);
418 public function testCreateContributionNoLineItems() {
421 'contact_id' => $this->_individualId
,
422 'receive_date' => '20120511',
423 'total_amount' => 100.00,
424 'financial_type_id' => $this->_financialTypeId
,
425 'payment_instrument_id' => 1,
426 'non_deductible_amount' => 10.00,
427 'fee_amount' => 50.00,
428 'net_amount' => 90.00,
430 'invoice_id' => 67890,
432 'contribution_status_id' => 1,
436 $contribution = $this->callAPISuccess('contribution', 'create', $params);
437 $lineItems = $this->callAPISuccess('line_item', 'get', array(
438 'entity_id' => $contribution['id'],
439 'entity_table' => 'civicrm_contribution',
442 $this->assertEquals(0, $lineItems['count']);
446 * Test checks that passing in line items suppresses the create mechanism.
448 public function testCreateContributionChainedLineItems() {
450 'contact_id' => $this->_individualId
,
451 'receive_date' => '20120511',
452 'total_amount' => 100.00,
453 'financial_type_id' => $this->_financialTypeId
,
454 'payment_instrument_id' => 1,
455 'non_deductible_amount' => 10.00,
456 'fee_amount' => 50.00,
457 'net_amount' => 90.00,
459 'invoice_id' => 67890,
461 'contribution_status_id' => 1,
463 'api.line_item.create' => array(
465 'price_field_id' => 1,
467 'line_total' => '20',
468 'unit_price' => '10',
471 'price_field_id' => 1,
473 'line_total' => '80',
474 'unit_price' => '80',
479 $description = "Create Contribution with Nested Line Items.";
480 $subfile = "CreateWithNestedLineItems";
481 $contribution = $this->callAPIAndDocument('contribution', 'create', $params, __FUNCTION__
, __FILE__
, $description, $subfile);
483 $lineItems = $this->callAPISuccess('line_item', 'get', array(
484 'entity_id' => $contribution['id'],
485 'contribution_id' => $contribution['id'],
486 'entity_table' => 'civicrm_contribution',
489 $this->assertEquals(2, $lineItems['count']);
492 public function testCreateContributionOffline() {
494 'contact_id' => $this->_individualId
,
495 'receive_date' => '20120511',
496 'total_amount' => 100.00,
497 'financial_type_id' => 1,
499 'invoice_id' => 67890,
501 'contribution_status_id' => 1,
504 $contribution = $this->callAPISuccess('contribution', 'create', $params);
505 $this->assertEquals($contribution['values'][$contribution['id']]['contact_id'], $this->_individualId
);
506 $this->assertEquals($contribution['values'][$contribution['id']]['total_amount'], 100.00);
507 $this->assertEquals($contribution['values'][$contribution['id']]['financial_type_id'], 1);
508 $this->assertEquals($contribution['values'][$contribution['id']]['trxn_id'], 12345);
509 $this->assertEquals($contribution['values'][$contribution['id']]['invoice_id'], 67890);
510 $this->assertEquals($contribution['values'][$contribution['id']]['source'], 'SSF');
511 $this->assertEquals($contribution['values'][$contribution['id']]['contribution_status_id'], 1);
512 $lineItems = $this->callAPISuccess('line_item', 'get', array(
513 'entity_id' => $contribution['id'],
514 'contribution_id' => $contribution['id'],
515 'entity_table' => 'civicrm_contribution',
518 $this->assertEquals(1, $lineItems['count']);
519 $this->assertEquals($contribution['id'], $lineItems['values'][0]['entity_id']);
520 $this->assertEquals($contribution['id'], $lineItems['values'][0]['contribution_id']);
521 $this->_checkFinancialRecords($contribution, 'offline');
522 $this->contributionGetnCheck($params, $contribution['id']);
526 * Test create with valid payment instrument.
528 public function testCreateContributionWithPaymentInstrument() {
529 $params = $this->_params +
array('payment_instrument' => 'EFT');
530 $contribution = $this->callAPISuccess('contribution', 'create', $params);
531 $contribution = $this->callAPISuccess('contribution', 'get', array(
533 'id' => $contribution['id'],
535 $this->assertArrayHasKey('payment_instrument', $contribution['values'][0]);
536 $this->assertEquals('EFT', $contribution['values'][0]['payment_instrument']);
538 $this->callAPISuccess('contribution', 'create', array(
539 'id' => $contribution['id'],
540 'payment_instrument' => 'Credit Card',
542 $contribution = $this->callAPISuccess('contribution', 'get', array(
544 'id' => $contribution['id'],
546 $this->assertArrayHasKey('payment_instrument', $contribution['values'][0]);
547 $this->assertEquals('Credit Card', $contribution['values'][0]['payment_instrument']);
550 public function testGetContributionByPaymentInstrument() {
551 $params = $this->_params +
array('payment_instrument' => 'EFT');
552 $params2 = $this->_params +
array('payment_instrument' => 'Cash');
553 $this->callAPISuccess('contribution', 'create', $params);
554 $this->callAPISuccess('contribution', 'create', $params2);
555 $contribution = $this->callAPISuccess('contribution', 'get', array(
557 'contribution_payment_instrument' => 'Cash',
559 $this->assertArrayHasKey('payment_instrument', $contribution['values'][0]);
560 $this->assertEquals('Cash', $contribution['values'][0]['payment_instrument']);
561 $this->assertEquals(1, $contribution['count']);
562 $contribution = $this->callAPISuccess('contribution', 'get', array('sequential' => 1, 'payment_instrument' => 'Cash'));
563 $this->assertArrayHasKey('payment_instrument', $contribution['values'][0]);
564 $this->assertEquals('Cash', $contribution['values'][0]['payment_instrument']);
565 $this->assertEquals(1, $contribution['count']);
566 $contribution = $this->callAPISuccess('contribution', 'get', array(
568 'payment_instrument_id' => 5,
570 $this->assertArrayHasKey('payment_instrument', $contribution['values'][0]);
571 $this->assertEquals('EFT', $contribution['values'][0]['payment_instrument']);
572 $this->assertEquals(1, $contribution['count']);
573 $contribution = $this->callAPISuccess('contribution', 'get', array(
575 'payment_instrument' => 'EFT',
577 $this->assertArrayHasKey('payment_instrument', $contribution['values'][0]);
578 $this->assertEquals('EFT', $contribution['values'][0]['payment_instrument']);
579 $this->assertEquals(1, $contribution['count']);
580 $contribution = $this->callAPISuccess('contribution', 'create', array(
581 'id' => $contribution['id'],
582 'payment_instrument' => 'Credit Card',
584 $contribution = $this->callAPISuccess('contribution', 'get', array('sequential' => 1, 'id' => $contribution['id']));
585 $this->assertArrayHasKey('payment_instrument', $contribution['values'][0]);
586 $this->assertEquals('Credit Card', $contribution['values'][0]['payment_instrument']);
587 $this->assertEquals(1, $contribution['count']);
591 * CRM-16227 introduces invoice_id as a parameter.
593 public function testGetContributionByInvoice() {
594 $this->callAPISuccess('Contribution', 'create', array_merge($this->_params
, array('invoice_id' => 'curly')));
595 $this->callAPISuccess('Contribution', 'create', array_merge($this->_params
), array('invoice_id' => 'churlish'));
596 $this->callAPISuccessGetCount('Contribution', array(), 2);
597 $this->callAPISuccessGetSingle('Contribution', array('invoice_id' => 'curly'));
598 // The following don't work. They are the format we are trying to introduce but although the form uses this format
599 // CRM_Contact_BAO_Query::convertFormValues puts them into the other format & the where only supports that.
600 // ideally the where clause would support this format (as it does on contact_BAO_Query) and those lines would
601 // come out of convertFormValues
602 // $this->callAPISuccessGetSingle('Contribution', array('invoice_id' => array('LIKE' => '%ish%')));
603 // $this->callAPISuccessGetSingle('Contribution', array('invoice_id' => array('NOT IN' => array('curly'))));
604 // $this->callAPISuccessGetCount('Contribution', array('invoice_id' => array('LIKE' => '%ly%')), 2);
605 // $this->callAPISuccessGetCount('Contribution', array('invoice_id' => array('IN' => array('curly', 'churlish'))),
610 * Check the credit note retrieval is case insensitive.
612 public function testGetCreditNoteCaseInsensitive() {
613 $this->contributionCreate(array('contact_id' => $this->_individualId
));
614 $this->contributionCreate(array('creditnote_id' => 'cN1234', 'contact_id' => $this->_individualId
, 'invoice_id' => rand(), 'trxn_id' => rand()));
615 $contribution = $this->callAPISuccess('Contribution', 'getsingle', array('creditnote_id' => 'CN1234'));
616 $this->assertEquals($contribution['creditnote_id'], 'cN1234');
620 * Test retrieval by total_amount works.
624 public function testGetContributionByTotalAmount() {
625 $this->callAPISuccess('Contribution', 'create', array_merge($this->_params
, array('total_amount' => '5')));
626 $this->callAPISuccess('Contribution', 'create', array_merge($this->_params
, array('total_amount' => '10')));
627 $this->callAPISuccessGetCount('Contribution', array('total_amount' => 10), 1);
628 $this->callAPISuccessGetCount('Contribution', array('total_amount' => array('>' => 6)), 1);
629 $this->callAPISuccessGetCount('Contribution', array('total_amount' => array('>' => 0)), 2);
630 $this->callAPISuccessGetCount('Contribution', array('total_amount' => array('>' => -5)), 2);
631 $this->callAPISuccessGetCount('Contribution', array('total_amount' => array('<' => 0)), 0);
632 $this->callAPISuccessGetCount('Contribution', array(), 2);
636 * Create test with unique field name on source.
638 public function testCreateContributionSource() {
641 'contact_id' => $this->_individualId
,
642 'receive_date' => date('Ymd'),
643 'total_amount' => 100.00,
644 'financial_type_id' => $this->_financialTypeId
,
645 'payment_instrument_id' => 1,
646 'non_deductible_amount' => 10.00,
647 'fee_amount' => 50.00,
648 'net_amount' => 90.00,
650 'invoice_id' => 67890,
651 'contribution_source' => 'SSF',
652 'contribution_status_id' => 1,
655 $contribution = $this->callAPISuccess('contribution', 'create', $params);
656 $this->assertEquals($contribution['values'][$contribution['id']]['total_amount'], 100.00);
657 $this->assertEquals($contribution['values'][$contribution['id']]['source'], 'SSF');
661 * Create test with unique field name on source.
663 public function testCreateDefaultNow() {
665 $params = $this->_params
;
666 unset($params['receive_date']);
668 $contribution = $this->callAPISuccess('contribution', 'create', $params);
669 $contribution = $this->callAPISuccessGetSingle('contribution', array('id' => $contribution['id']));
670 $this->assertEquals(date('Y-m-d'), date('Y-m-d', strtotime($contribution['receive_date'])));
674 * Create test with unique field name on source.
676 public function testCreateContributionSourceInvalidContact() {
680 'receive_date' => date('Ymd'),
681 'total_amount' => 100.00,
682 'financial_type_id' => $this->_financialTypeId
,
683 'payment_instrument_id' => 1,
684 'non_deductible_amount' => 10.00,
685 'fee_amount' => 50.00,
686 'net_amount' => 90.00,
688 'invoice_id' => 67890,
689 'contribution_source' => 'SSF',
690 'contribution_status_id' => 1,
693 $this->callAPIFailure('contribution', 'create', $params, 'contact_id is not valid : 999');
696 public function testCreateContributionSourceInvalidContContact() {
699 'contribution_contact_id' => 999,
700 'receive_date' => date('Ymd'),
701 'total_amount' => 100.00,
702 'financial_type_id' => $this->_financialTypeId
,
703 'payment_instrument_id' => 1,
704 'non_deductible_amount' => 10.00,
705 'fee_amount' => 50.00,
706 'net_amount' => 90.00,
708 'invoice_id' => 67890,
709 'contribution_source' => 'SSF',
710 'contribution_status_id' => 1,
713 $this->callAPIFailure('contribution', 'create', $params);
717 * Test note created correctly.
719 public function testCreateContributionWithNote() {
720 $description = "Demonstrates creating contribution with Note Entity.";
721 $subfile = "ContributionCreateWithNote";
723 'contact_id' => $this->_individualId
,
724 'receive_date' => '2012-01-01',
725 'total_amount' => 100.00,
726 'financial_type_id' => $this->_financialTypeId
,
727 'payment_instrument_id' => 1,
728 'non_deductible_amount' => 10.00,
729 'fee_amount' => 50.00,
730 'net_amount' => 90.00,
732 'invoice_id' => 67890,
734 'contribution_status_id' => 1,
735 'note' => 'my contribution note',
738 $contribution = $this->callAPIAndDocument('contribution', 'create', $params, __FUNCTION__
, __FILE__
, $description, $subfile);
739 $result = $this->callAPISuccess('note', 'get', array(
740 'entity_table' => 'civicrm_contribution',
741 'entity_id' => $contribution['id'],
744 $this->assertEquals('my contribution note', $result['values'][0]['note']);
745 $this->callAPISuccess('contribution', 'delete', array('id' => $contribution['id']));
748 public function testCreateContributionWithNoteUniqueNameAliases() {
750 'contact_id' => $this->_individualId
,
751 'receive_date' => '2012-01-01',
752 'total_amount' => 100.00,
753 'financial_type_id' => $this->_financialTypeId
,
754 'payment_instrument_id' => 1,
755 'non_deductible_amount' => 10.00,
756 'fee_amount' => 50.00,
757 'net_amount' => 90.00,
759 'invoice_id' => 67890,
761 'contribution_status_id' => 1,
762 'contribution_note' => 'my contribution note',
765 $contribution = $this->callAPISuccess('contribution', 'create', $params);
766 $result = $this->callAPISuccess('note', 'get', array(
767 'entity_table' => 'civicrm_contribution',
768 'entity_id' => $contribution['id'],
771 $this->assertEquals('my contribution note', $result['values'][0]['note']);
772 $this->callAPISuccess('contribution', 'delete', array('id' => $contribution['id']));
776 * This is the test for creating soft credits.
778 public function testCreateContributionWithSoftCredit() {
779 $description = "Demonstrates creating contribution with SoftCredit.";
780 $subfile = "ContributionCreateWithSoftCredit";
781 $contact2 = $this->callAPISuccess('Contact', 'create', array(
782 'display_name' => 'superman',
783 'contact_type' => 'Individual',
786 'contact_id' => $contact2['id'],
788 'soft_credit_type_id' => 3,
791 $params = $this->_params +
array('soft_credit' => array(1 => $softParams));
792 $contribution = $this->callAPIAndDocument('contribution', 'create', $params, __FUNCTION__
, __FILE__
, $description, $subfile);
793 $result = $this->callAPISuccess('contribution', 'get', array('return' => 'soft_credit', 'sequential' => 1));
795 $this->assertEquals($softParams['contact_id'], $result['values'][0]['soft_credit'][1]['contact_id']);
796 $this->assertEquals($softParams['amount'], $result['values'][0]['soft_credit'][1]['amount']);
797 $this->assertEquals($softParams['soft_credit_type_id'], $result['values'][0]['soft_credit'][1]['soft_credit_type']);
799 $this->callAPISuccess('contribution', 'delete', array('id' => $contribution['id']));
800 $this->callAPISuccess('contact', 'delete', array('id' => $contact2['id']));
803 public function testCreateContributionWithSoftCreditDefaults() {
804 $description = "Demonstrates creating contribution with Soft Credit defaults for amount and type.";
805 $subfile = "ContributionCreateWithSoftCreditDefaults";
806 $contact2 = $this->callAPISuccess('Contact', 'create', array(
807 'display_name' => 'superman',
808 'contact_type' => 'Individual',
810 $params = $this->_params +
array(
811 'soft_credit_to' => $contact2['id'],
813 $contribution = $this->callAPIAndDocument('contribution', 'create', $params, __FUNCTION__
, __FILE__
, $description, $subfile);
814 $result = $this->callAPISuccess('contribution', 'get', array('return' => 'soft_credit', 'sequential' => 1));
816 $this->assertEquals($contact2['id'], $result['values'][0]['soft_credit'][1]['contact_id']);
817 // Default soft credit amount = contribution.total_amount
818 $this->assertEquals($this->_params
['total_amount'], $result['values'][0]['soft_credit'][1]['amount']);
819 $this->assertEquals(CRM_Core_OptionGroup
::getDefaultValue("soft_credit_type"), $result['values'][0]['soft_credit'][1]['soft_credit_type']);
821 $this->callAPISuccess('contribution', 'delete', array('id' => $contribution['id']));
822 $this->callAPISuccess('contact', 'delete', array('id' => $contact2['id']));
826 * Test creating contribution with Soft Credit by passing in honor_contact_id.
828 public function testCreateContributionWithHonoreeContact() {
829 $description = "Demonstrates creating contribution with Soft Credit by passing in honor_contact_id.";
830 $subfile = "ContributionCreateWithHonoreeContact";
831 $contact2 = $this->callAPISuccess('Contact', 'create', array(
832 'display_name' => 'superman',
833 'contact_type' => 'Individual',
835 $params = $this->_params +
array(
836 'honor_contact_id' => $contact2['id'],
838 $contribution = $this->callAPIAndDocument('contribution', 'create', $params, __FUNCTION__
, __FILE__
, $description, $subfile);
839 $result = $this->callAPISuccess('contribution', 'get', array('return' => 'soft_credit', 'sequential' => 1));
841 $this->assertEquals($contact2['id'], $result['values'][0]['soft_credit'][1]['contact_id']);
842 // Default soft credit amount = contribution.total_amount
843 // Legacy mode in create api (honor_contact_id param) uses the standard "In Honor of" soft credit type
844 $this->assertEquals($this->_params
['total_amount'], $result['values'][0]['soft_credit'][1]['amount']);
845 $softCreditValueTypeID = $result['values'][0]['soft_credit'][1]['soft_credit_type'];
846 $this->assertEquals('in_honor_of', CRM_Core_PseudoConstant
::getName('CRM_Contribute_BAO_ContributionSoft', 'soft_credit_type_id', $softCreditValueTypeID));
848 $this->callAPISuccess('contribution', 'delete', array('id' => $contribution['id']));
849 $this->callAPISuccess('contact', 'delete', array('id' => $contact2['id']));
853 * Test using example code.
855 public function testContributionCreateExample() {
856 //make sure at least on page exists since there is a truncate in tear down
857 $this->callAPISuccess('contribution_page', 'create', $this->_pageParams
);
858 require_once 'api/v3/examples/Contribution/Create.php';
859 $result = contribution_create_example();
861 $expectedResult = contribution_create_expectedresult();
862 $this->checkArrayEquals($expectedResult, $result);
863 $this->contributionDelete($id);
867 * Function tests that additional financial records are created when fee amount is recorded.
869 public function testCreateContributionWithFee() {
871 'contact_id' => $this->_individualId
,
872 'receive_date' => '20120511',
873 'total_amount' => 100.00,
875 'financial_type_id' => 1,
877 'invoice_id' => 67890,
879 'contribution_status_id' => 1,
882 $contribution = $this->callAPISuccess('contribution', 'create', $params);
883 $this->assertEquals($contribution['values'][$contribution['id']]['contact_id'], $this->_individualId
);
884 $this->assertEquals($contribution['values'][$contribution['id']]['total_amount'], 100.00);
885 $this->assertEquals($contribution['values'][$contribution['id']]['fee_amount'], 50.00);
886 $this->assertEquals($contribution['values'][$contribution['id']]['net_amount'], 50.00);
887 $this->assertEquals($contribution['values'][$contribution['id']]['financial_type_id'], 1);
888 $this->assertEquals($contribution['values'][$contribution['id']]['trxn_id'], 12345);
889 $this->assertEquals($contribution['values'][$contribution['id']]['invoice_id'], 67890);
890 $this->assertEquals($contribution['values'][$contribution['id']]['source'], 'SSF');
891 $this->assertEquals($contribution['values'][$contribution['id']]['contribution_status_id'], 1);
893 $lineItems = $this->callAPISuccess('line_item', 'get', array(
895 'entity_id' => $contribution['id'],
896 'entity_table' => 'civicrm_contribution',
899 $this->assertEquals(1, $lineItems['count']);
900 $this->assertEquals($contribution['id'], $lineItems['values'][0]['entity_id']);
901 $this->assertEquals($contribution['id'], $lineItems['values'][0]['contribution_id']);
902 $lineItems = $this->callAPISuccess('line_item', 'get', array(
904 'entity_id' => $contribution['id'],
905 'contribution_id' => $contribution['id'],
906 'entity_table' => 'civicrm_contribution',
909 $this->assertEquals(1, $lineItems['count']);
910 $this->_checkFinancialRecords($contribution, 'feeAmount');
915 * Function tests that additional financial records are created when online contribution is created.
917 public function testCreateContributionOnline() {
918 CRM_Financial_BAO_PaymentProcessor
::create($this->_processorParams
);
919 $contributionPage = $this->callAPISuccess('contribution_page', 'create', $this->_pageParams
);
920 $this->assertAPISuccess($contributionPage);
922 'contact_id' => $this->_individualId
,
923 'receive_date' => '20120511',
924 'total_amount' => 100.00,
925 'financial_type_id' => 1,
926 'contribution_page_id' => $contributionPage['id'],
927 'payment_processor' => $this->paymentProcessorID
,
929 'invoice_id' => 67890,
931 'contribution_status_id' => 1,
935 $contribution = $this->callAPISuccess('contribution', 'create', $params);
936 $this->assertEquals($contribution['values'][$contribution['id']]['contact_id'], $this->_individualId
);
937 $this->assertEquals($contribution['values'][$contribution['id']]['total_amount'], 100.00);
938 $this->assertEquals($contribution['values'][$contribution['id']]['financial_type_id'], 1);
939 $this->assertEquals($contribution['values'][$contribution['id']]['trxn_id'], 12345);
940 $this->assertEquals($contribution['values'][$contribution['id']]['invoice_id'], 67890);
941 $this->assertEquals($contribution['values'][$contribution['id']]['source'], 'SSF');
942 $this->assertEquals($contribution['values'][$contribution['id']]['contribution_status_id'], 1);
943 $contribution['payment_instrument_id'] = $this->callAPISuccessGetValue('PaymentProcessor', array(
944 'id' => $this->paymentProcessorID
,
945 'return' => 'payment_instrument_id',
947 $this->_checkFinancialRecords($contribution, 'online');
951 * Check handling of financial type.
953 * In the interests of removing financial type / contribution type checks from
954 * legacy format function lets test that the api is doing this for us
956 public function testCreateInvalidFinancialType() {
957 $params = $this->_params
;
958 $params['financial_type_id'] = 99999;
959 $this->callAPIFailure($this->_entity
, 'create', $params, "'99999' is not a valid option for field financial_type_id");
963 * Check handling of financial type.
965 * In the interests of removing financial type / contribution type checks from
966 * legacy format function lets test that the api is doing this for us
968 public function testValidNamedFinancialType() {
969 $params = $this->_params
;
970 $params['financial_type_id'] = 'Donation';
971 $this->callAPISuccess($this->_entity
, 'create', $params);
975 * Tests that additional financial records are created.
977 * Checks when online contribution with pay later option is created
979 public function testCreateContributionPayLaterOnline() {
980 CRM_Financial_BAO_PaymentProcessor
::create($this->_processorParams
);
981 $this->_pageParams
['is_pay_later'] = 1;
982 $contributionPage = $this->callAPISuccess('contribution_page', 'create', $this->_pageParams
);
983 $this->assertAPISuccess($contributionPage);
985 'contact_id' => $this->_individualId
,
986 'receive_date' => '20120511',
987 'total_amount' => 100.00,
988 'financial_type_id' => 1,
989 'contribution_page_id' => $contributionPage['id'],
992 'invoice_id' => 67890,
994 'contribution_status_id' => 2,
998 $contribution = $this->callAPIAndDocument('contribution', 'create', $params, __FUNCTION__
, __FILE__
);
999 $this->assertEquals($contribution['values'][$contribution['id']]['contact_id'], $this->_individualId
);
1000 $this->assertEquals($contribution['values'][$contribution['id']]['total_amount'], 100.00);
1001 $this->assertEquals($contribution['values'][$contribution['id']]['financial_type_id'], 1);
1002 $this->assertEquals($contribution['values'][$contribution['id']]['trxn_id'], 12345);
1003 $this->assertEquals($contribution['values'][$contribution['id']]['invoice_id'], 67890);
1004 $this->assertEquals($contribution['values'][$contribution['id']]['source'], 'SSF');
1005 $this->assertEquals($contribution['values'][$contribution['id']]['contribution_status_id'], 2);
1006 $this->_checkFinancialRecords($contribution, 'payLater');
1010 * Function tests that additional financial records are created for online contribution with pending option.
1012 public function testCreateContributionPendingOnline() {
1013 $paymentProcessor = CRM_Financial_BAO_PaymentProcessor
::create($this->_processorParams
);
1014 $contributionPage = $this->callAPISuccess('contribution_page', 'create', $this->_pageParams
);
1015 $this->assertAPISuccess($contributionPage);
1017 'contact_id' => $this->_individualId
,
1018 'receive_date' => '20120511',
1019 'total_amount' => 100.00,
1020 'financial_type_id' => 1,
1021 'contribution_page_id' => $contributionPage['id'],
1023 'invoice_id' => 67890,
1025 'contribution_status_id' => 2,
1028 $contribution = $this->callAPISuccess('contribution', 'create', $params);
1029 $this->assertEquals($contribution['values'][$contribution['id']]['contact_id'], $this->_individualId
);
1030 $this->assertEquals($contribution['values'][$contribution['id']]['total_amount'], 100.00);
1031 $this->assertEquals($contribution['values'][$contribution['id']]['financial_type_id'], 1);
1032 $this->assertEquals($contribution['values'][$contribution['id']]['trxn_id'], 12345);
1033 $this->assertEquals($contribution['values'][$contribution['id']]['invoice_id'], 67890);
1034 $this->assertEquals($contribution['values'][$contribution['id']]['source'], 'SSF');
1035 $this->assertEquals($contribution['values'][$contribution['id']]['contribution_status_id'], 2);
1036 $this->_checkFinancialRecords($contribution, 'pending');
1040 * Test that BAO defaults work.
1042 public function testCreateBAODefaults() {
1043 unset($this->_params
['contribution_source_id'], $this->_params
['payment_instrument_id']);
1044 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
1045 $contribution = $this->callAPISuccess('contribution', 'getsingle', array(
1046 'id' => $contribution['id'],
1047 'api.contribution.delete' => 1,
1049 $this->assertEquals(1, $contribution['contribution_status_id']);
1050 $this->assertEquals('Check', $contribution['payment_instrument']);
1054 * Function tests that line items, financial records are updated when contribution amount is changed.
1056 public function testCreateUpdateContributionChangeTotal() {
1057 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
1058 $lineItems = $this->callAPISuccess('line_item', 'getvalue', array(
1060 'entity_id' => $contribution['id'],
1061 'entity_table' => 'civicrm_contribution',
1063 'return' => 'line_total',
1065 $this->assertEquals('100.00', $lineItems);
1066 $trxnAmount = $this->_getFinancialTrxnAmount($contribution['id']);
1067 // Financial trxn SUM = 100 + 5 (fee)
1068 $this->assertEquals('105.00', $trxnAmount);
1071 'id' => $contribution['id'],
1072 'total_amount' => '125',
1074 $contribution = $this->callAPISuccess('contribution', 'create', $newParams);
1076 $lineItems = $this->callAPISuccess('line_item', 'getvalue', array(
1078 'entity_id' => $contribution['id'],
1079 'entity_table' => 'civicrm_contribution',
1081 'return' => 'line_total',
1084 $this->assertEquals('125.00', $lineItems);
1085 $trxnAmount = $this->_getFinancialTrxnAmount($contribution['id']);
1087 // Financial trxn SUM = 125 + 5 (fee).
1088 $this->assertEquals('130.00', $trxnAmount);
1089 $this->assertEquals('125.00', $this->_getFinancialItemAmount($contribution['id']));
1093 * Function tests that line items, financial records are updated when pay later contribution is received.
1095 public function testCreateUpdateContributionPayLater() {
1096 $contribParams = array(
1097 'contact_id' => $this->_individualId
,
1098 'receive_date' => '2012-01-01',
1099 'total_amount' => 100.00,
1100 'financial_type_id' => $this->_financialTypeId
,
1101 'payment_instrument_id' => 1,
1102 'contribution_status_id' => 2,
1103 'is_pay_later' => 1,
1106 $contribution = $this->callAPISuccess('contribution', 'create', $contribParams);
1108 $newParams = array_merge($contribParams, array(
1109 'id' => $contribution['id'],
1110 'contribution_status_id' => 1,
1113 $contribution = $this->callAPISuccess('contribution', 'create', $newParams);
1114 $contribution = $contribution['values'][$contribution['id']];
1115 $this->assertEquals($contribution['contribution_status_id'], '1');
1116 $this->_checkFinancialItem($contribution['id'], 'paylater');
1117 $this->_checkFinancialTrxn($contribution, 'payLater');
1121 * Function tests that financial records are updated when Payment Instrument is changed.
1123 public function testCreateUpdateContributionPaymentInstrument() {
1124 $instrumentId = $this->_addPaymentInstrument();
1125 $contribParams = array(
1126 'contact_id' => $this->_individualId
,
1127 'total_amount' => 100.00,
1128 'financial_type_id' => $this->_financialTypeId
,
1129 'payment_instrument_id' => 4,
1130 'contribution_status_id' => 1,
1133 $contribution = $this->callAPISuccess('contribution', 'create', $contribParams);
1135 $newParams = array_merge($contribParams, array(
1136 'id' => $contribution['id'],
1137 'payment_instrument_id' => $instrumentId,
1140 $contribution = $this->callAPISuccess('contribution', 'create', $newParams);
1141 $this->assertAPISuccess($contribution);
1142 $this->_checkFinancialTrxn($contribution, 'paymentInstrument', $instrumentId);
1146 * Function tests that financial records are updated when Payment Instrument is changed when amount is negative.
1148 public function testCreateUpdateNegativeContributionPaymentInstrument() {
1149 $instrumentId = $this->_addPaymentInstrument();
1150 $contribParams = array(
1151 'contact_id' => $this->_individualId
,
1152 'total_amount' => -100.00,
1153 'financial_type_id' => $this->_financialTypeId
,
1154 'payment_instrument_id' => 4,
1155 'contribution_status_id' => 1,
1158 $contribution = $this->callAPISuccess('contribution', 'create', $contribParams);
1160 $newParams = array_merge($contribParams, array(
1161 'id' => $contribution['id'],
1162 'payment_instrument_id' => $instrumentId,
1165 $contribution = $this->callAPISuccess('contribution', 'create', $newParams);
1166 $this->assertAPISuccess($contribution);
1167 $this->_checkFinancialTrxn($contribution, 'paymentInstrument', $instrumentId, array('total_amount' => '-100.00'));
1171 * Function tests that financial records are added when Contribution is Refunded.
1173 public function testCreateUpdateContributionRefund() {
1174 $contributionParams = array(
1175 'contact_id' => $this->_individualId
,
1176 'receive_date' => '2012-01-01',
1177 'total_amount' => 100.00,
1178 'financial_type_id' => $this->_financialTypeId
,
1179 'payment_instrument_id' => 4,
1180 'contribution_status_id' => 1,
1181 'trxn_id' => 'original_payment',
1183 $contribution = $this->callAPISuccess('contribution', 'create', $contributionParams);
1184 $newParams = array_merge($contributionParams, array(
1185 'id' => $contribution['id'],
1186 'contribution_status_id' => 'Refunded',
1187 'cancel_date' => '2015-01-01 09:00',
1188 'refund_trxn_id' => 'the refund',
1192 $contribution = $this->callAPISuccess('contribution', 'create', $newParams);
1193 $this->_checkFinancialTrxn($contribution, 'refund');
1194 $this->_checkFinancialItem($contribution['id'], 'refund');
1195 $this->assertEquals('original_payment', $this->callAPISuccessGetValue('Contribution', array(
1196 'id' => $contribution['id'],
1197 'return' => 'trxn_id',
1202 * Refund a contribution for a financial type with a contra account.
1204 * CRM-17951 the contra account is a financial account with a relationship to a
1205 * financial type. It is not always configured but should be reflected
1206 * in the financial_trxn & financial_item table if it is.
1208 public function testCreateUpdateChargebackContributionDefaultAccount() {
1209 $contribution = $this->callAPISuccess('Contribution', 'create', $this->_params
);
1210 $this->callAPISuccess('Contribution', 'create', array(
1211 'id' => $contribution['id'],
1212 'contribution_status_id' => 'Chargeback',
1214 $this->callAPISuccessGetSingle('Contribution', array('contribution_status_id' => 'Chargeback'));
1216 $lineItems = $this->callAPISuccessGetSingle('LineItem', array(
1217 'contribution_id' => $contribution['id'],
1218 'api.FinancialItem.getsingle' => array('amount' => array('<' => 0)),
1220 $this->assertEquals(1, $lineItems['api.FinancialItem.getsingle']['financial_account_id']);
1221 $this->callAPISuccessGetSingle('FinancialTrxn', array(
1222 'total_amount' => -100,
1223 'status_id' => 'Chargeback',
1224 'to_financial_account_id' => 6,
1229 * Refund a contribution for a financial type with a contra account.
1231 * CRM-17951 the contra account is a financial account with a relationship to a
1232 * financial type. It is not always configured but should be reflected
1233 * in the financial_trxn & financial_item table if it is.
1235 public function testCreateUpdateChargebackContributionCustomAccount() {
1236 $financialAccount = $this->callAPISuccess('FinancialAccount', 'create', array(
1237 'name' => 'Chargeback Account',
1238 'is_active' => TRUE,
1241 $entityFinancialAccount = $this->callAPISuccess('EntityFinancialAccount', 'create', array(
1242 'entity_id' => $this->_financialTypeId
,
1243 'entity_table' => 'civicrm_financial_type',
1244 'account_relationship' => 'Chargeback Account is',
1245 'financial_account_id' => 'Chargeback Account',
1248 $contribution = $this->callAPISuccess('Contribution', 'create', $this->_params
);
1249 $this->callAPISuccess('Contribution', 'create', array(
1250 'id' => $contribution['id'],
1251 'contribution_status_id' => 'Chargeback',
1253 $this->callAPISuccessGetSingle('Contribution', array('contribution_status_id' => 'Chargeback'));
1255 $lineItems = $this->callAPISuccessGetSingle('LineItem', array(
1256 'contribution_id' => $contribution['id'],
1257 'api.FinancialItem.getsingle' => array('amount' => array('<' => 0)),
1259 $this->assertEquals($financialAccount['id'], $lineItems['api.FinancialItem.getsingle']['financial_account_id']);
1261 $this->callAPISuccess('Contribution', 'delete', array('id' => $contribution['id']));
1262 $this->callAPISuccess('EntityFinancialAccount', 'delete', array('id' => $entityFinancialAccount['id']));
1263 $this->callAPISuccess('FinancialAccount', 'delete', array('id' => $financialAccount['id']));
1267 * Refund a contribution for a financial type with a contra account.
1269 * CRM-17951 the contra account is a financial account with a relationship to a
1270 * financial type. It is not always configured but should be reflected
1271 * in the financial_trxn & financial_item table if it is.
1273 public function testCreateUpdateRefundContributionConfiguredContraAccount() {
1274 $financialAccount = $this->callAPISuccess('FinancialAccount', 'create', array(
1275 'name' => 'Refund Account',
1276 'is_active' => TRUE,
1279 $entityFinancialAccount = $this->callAPISuccess('EntityFinancialAccount', 'create', array(
1280 'entity_id' => $this->_financialTypeId
,
1281 'entity_table' => 'civicrm_financial_type',
1282 'account_relationship' => 'Credit/Contra Revenue Account is',
1283 'financial_account_id' => 'Refund Account',
1286 $contribution = $this->callAPISuccess('Contribution', 'create', $this->_params
);
1287 $this->callAPISuccess('Contribution', 'create', array(
1288 'id' => $contribution['id'],
1289 'contribution_status_id' => 'Refunded',
1292 $lineItems = $this->callAPISuccessGetSingle('LineItem', array(
1293 'contribution_id' => $contribution['id'],
1294 'api.FinancialItem.getsingle' => array('amount' => array('<' => 0)),
1296 $this->assertEquals($financialAccount['id'], $lineItems['api.FinancialItem.getsingle']['financial_account_id']);
1298 $this->callAPISuccess('Contribution', 'delete', array('id' => $contribution['id']));
1299 $this->callAPISuccess('EntityFinancialAccount', 'delete', array('id' => $entityFinancialAccount['id']));
1300 $this->callAPISuccess('FinancialAccount', 'delete', array('id' => $financialAccount['id']));
1304 * Function tests that trxn_id is set when passed in.
1306 * Here we ensure that the civicrm_financial_trxn.trxn_id & the civicrm_contribution.trxn_id are set
1307 * when trxn_id is passed in.
1309 public function testCreateUpdateContributionRefundTrxnIDPassedIn() {
1310 $contributionParams = array(
1311 'contact_id' => $this->_individualId
,
1312 'receive_date' => '2012-01-01',
1313 'total_amount' => 100.00,
1314 'financial_type_id' => $this->_financialTypeId
,
1315 'payment_instrument_id' => 4,
1316 'contribution_status_id' => 1,
1317 'trxn_id' => 'original_payment',
1319 $contribution = $this->callAPISuccess('contribution', 'create', $contributionParams);
1320 $newParams = array_merge($contributionParams, array(
1321 'id' => $contribution['id'],
1322 'contribution_status_id' => 'Refunded',
1323 'cancel_date' => '2015-01-01 09:00',
1324 'trxn_id' => 'the refund',
1328 $contribution = $this->callAPISuccess('contribution', 'create', $newParams);
1329 $this->_checkFinancialTrxn($contribution, 'refund');
1330 $this->_checkFinancialItem($contribution['id'], 'refund');
1331 $this->assertEquals('the refund', $this->callAPISuccessGetValue('Contribution', array(
1332 'id' => $contribution['id'],
1333 'return' => 'trxn_id',
1338 * Function tests that trxn_id is set when passed in.
1340 * Here we ensure that the civicrm_contribution.trxn_id is set
1341 * when trxn_id is passed in but if refund_trxn_id is different then that
1342 * is kept for the refund transaction.
1344 public function testCreateUpdateContributionRefundRefundAndTrxnIDPassedIn() {
1345 $contributionParams = array(
1346 'contact_id' => $this->_individualId
,
1347 'receive_date' => '2012-01-01',
1348 'total_amount' => 100.00,
1349 'financial_type_id' => $this->_financialTypeId
,
1350 'payment_instrument_id' => 4,
1351 'contribution_status_id' => 1,
1352 'trxn_id' => 'original_payment',
1354 $contribution = $this->callAPISuccess('contribution', 'create', $contributionParams);
1355 $newParams = array_merge($contributionParams, array(
1356 'id' => $contribution['id'],
1357 'contribution_status_id' => 'Refunded',
1358 'cancel_date' => '2015-01-01 09:00',
1359 'trxn_id' => 'cont id',
1360 'refund_trxn_id' => 'the refund',
1364 $contribution = $this->callAPISuccess('contribution', 'create', $newParams);
1365 $this->_checkFinancialTrxn($contribution, 'refund');
1366 $this->_checkFinancialItem($contribution['id'], 'refund');
1367 $this->assertEquals('cont id', $this->callAPISuccessGetValue('Contribution', array(
1368 'id' => $contribution['id'],
1369 'return' => 'trxn_id',
1374 * Function tests that refund_trxn_id is set when passed in empty.
1376 * Here we ensure that the civicrm_contribution.trxn_id is set
1377 * when trxn_id is passed in but if refund_trxn_id isset but empty then that
1378 * is kept for the refund transaction.
1380 public function testCreateUpdateContributionRefundRefundNullTrxnIDPassedIn() {
1381 $contributionParams = array(
1382 'contact_id' => $this->_individualId
,
1383 'receive_date' => '2012-01-01',
1384 'total_amount' => 100.00,
1385 'financial_type_id' => $this->_financialTypeId
,
1386 'payment_instrument_id' => 4,
1387 'contribution_status_id' => 1,
1388 'trxn_id' => 'original_payment',
1390 $contribution = $this->callAPISuccess('contribution', 'create', $contributionParams);
1391 $newParams = array_merge($contributionParams, array(
1392 'id' => $contribution['id'],
1393 'contribution_status_id' => 'Refunded',
1394 'cancel_date' => '2015-01-01 09:00',
1395 'trxn_id' => 'cont id',
1396 'refund_trxn_id' => '',
1400 $contribution = $this->callAPISuccess('contribution', 'create', $newParams);
1401 $this->_checkFinancialTrxn($contribution, 'refund', NULL, array('trxn_id' => NULL));
1402 $this->_checkFinancialItem($contribution['id'], 'refund');
1403 $this->assertEquals('cont id', $this->callAPISuccessGetValue('Contribution', array(
1404 'id' => $contribution['id'],
1405 'return' => 'trxn_id',
1410 * Function tests invalid contribution status change.
1412 public function testCreateUpdateContributionInValidStatusChange() {
1413 $contribParams = array(
1415 'receive_date' => '2012-01-01',
1416 'total_amount' => 100.00,
1417 'financial_type_id' => 1,
1418 'payment_instrument_id' => 1,
1419 'contribution_status_id' => 1,
1421 $contribution = $this->callAPISuccess('contribution', 'create', $contribParams);
1422 $newParams = array_merge($contribParams, array(
1423 'id' => $contribution['id'],
1424 'contribution_status_id' => 2,
1427 $this->callAPIFailure('contribution', 'create', $newParams, ts('Cannot change contribution status from Completed to Pending.'));
1432 * Function tests that financial records are added when Pending Contribution is Canceled.
1434 public function testCreateUpdateContributionCancelPending() {
1435 $contribParams = array(
1436 'contact_id' => $this->_individualId
,
1437 'receive_date' => '2012-01-01',
1438 'total_amount' => 100.00,
1439 'financial_type_id' => $this->_financialTypeId
,
1440 'payment_instrument_id' => 1,
1441 'contribution_status_id' => 2,
1442 'is_pay_later' => 1,
1445 $contribution = $this->callAPISuccess('contribution', 'create', $contribParams);
1446 $newParams = array_merge($contribParams, array(
1447 'id' => $contribution['id'],
1448 'contribution_status_id' => 3,
1449 'cancel_date' => '2012-02-02 09:00',
1452 //Check if trxn_date is same as cancel_date.
1453 $checkTrxnDate = array(
1454 'trxn_date' => '2012-02-02 09:00:00',
1456 $contribution = $this->callAPISuccess('contribution', 'create', $newParams);
1457 $this->_checkFinancialTrxn($contribution, 'cancelPending', NULL, $checkTrxnDate);
1458 $this->_checkFinancialItem($contribution['id'], 'cancelPending');
1462 * Function tests that financial records are added when Financial Type is Changed.
1464 public function testCreateUpdateContributionChangeFinancialType() {
1465 $contribParams = array(
1466 'contact_id' => $this->_individualId
,
1467 'receive_date' => '2012-01-01',
1468 'total_amount' => 100.00,
1469 'financial_type_id' => 1,
1470 'payment_instrument_id' => 1,
1471 'contribution_status_id' => 1,
1474 $contribution = $this->callAPISuccess('contribution', 'create', $contribParams);
1475 $newParams = array_merge($contribParams, array(
1476 'id' => $contribution['id'],
1477 'financial_type_id' => 3,
1480 $contribution = $this->callAPISuccess('contribution', 'create', $newParams);
1481 $this->_checkFinancialTrxn($contribution, 'changeFinancial');
1482 $this->_checkFinancialItem($contribution['id'], 'changeFinancial');
1486 * Test that update does not change status id CRM-15105.
1488 public function testCreateUpdateWithoutChangingPendingStatus() {
1489 $contribution = $this->callAPISuccess('contribution', 'create', array_merge($this->_params
, array('contribution_status_id' => 2)));
1490 $this->callAPISuccess('contribution', 'create', array('id' => $contribution['id'], 'source' => 'new source'));
1491 $contribution = $this->callAPISuccess('contribution', 'getsingle', array(
1492 'id' => $contribution['id'],
1493 'api.contribution.delete' => 1,
1495 $this->assertEquals(2, $contribution['contribution_status_id']);
1499 * Test Updating a Contribution.
1501 * CHANGE: we require the API to do an incremental update
1503 public function testCreateUpdateContribution() {
1504 $contributionID = $this->contributionCreate(array(
1505 'contact_id' => $this->_individualId
,
1506 'trxn_id' => 212355,
1507 'financial_type_id' => $this->_financialTypeId
,
1508 'invoice_id' => 'old_invoice',
1510 $old_params = array(
1511 'contribution_id' => $contributionID,
1513 $original = $this->callAPISuccess('contribution', 'get', $old_params);
1514 $this->assertEquals($original['id'], $contributionID);
1515 //set up list of old params, verify
1517 //This should not be required on update:
1518 $old_contact_id = $original['values'][$contributionID]['contact_id'];
1519 $old_payment_instrument = $original['values'][$contributionID]['instrument_id'];
1520 $old_fee_amount = $original['values'][$contributionID]['fee_amount'];
1521 $old_source = $original['values'][$contributionID]['contribution_source'];
1523 $old_trxn_id = $original['values'][$contributionID]['trxn_id'];
1524 $old_invoice_id = $original['values'][$contributionID]['invoice_id'];
1526 //check against values in CiviUnitTestCase::createContribution()
1527 $this->assertEquals($old_contact_id, $this->_individualId
);
1528 $this->assertEquals($old_fee_amount, 5.00);
1529 $this->assertEquals($old_source, 'SSF');
1530 $this->assertEquals($old_trxn_id, 212355);
1531 $this->assertEquals($old_invoice_id, 'old_invoice');
1533 'id' => $contributionID,
1534 'contact_id' => $this->_individualId
,
1535 'total_amount' => 105.00,
1536 'fee_amount' => 7.00,
1537 'financial_type_id' => $this->_financialTypeId
,
1538 'non_deductible_amount' => 22.00,
1539 'contribution_status_id' => 1,
1540 'note' => 'Donating for Noble Cause',
1543 $contribution = $this->callAPISuccess('contribution', 'create', $params);
1545 $new_params = array(
1546 'contribution_id' => $contribution['id'],
1549 $contribution = $this->callAPISuccessGetSingle('contribution', $new_params);
1551 $this->assertEquals($contribution['contact_id'], $this->_individualId
);
1552 $this->assertEquals($contribution['total_amount'], 105.00);
1553 $this->assertEquals($contribution['financial_type_id'], $this->_financialTypeId
);
1554 $this->assertEquals($contribution['financial_type'], 'Donation');
1555 $this->assertEquals($contribution['instrument_id'], $old_payment_instrument);
1556 $this->assertEquals($contribution['non_deductible_amount'], 22.00);
1557 $this->assertEquals($contribution['fee_amount'], 7.00);
1558 $this->assertEquals($contribution['trxn_id'], $old_trxn_id);
1559 $this->assertEquals($contribution['invoice_id'], $old_invoice_id);
1560 $this->assertEquals($contribution['contribution_source'], $old_source);
1561 $this->assertEquals($contribution['contribution_status'], 'Completed');
1563 $this->assertEquals($contribution['net_amount'], $contribution['total_amount'] - $contribution['fee_amount']);
1566 'contribution_id' => $contributionID,
1569 $result = $this->callAPISuccess('contribution', 'delete', $params);
1570 $this->assertAPISuccess($result);
1574 * Attempt (but fail) to delete a contribution without parameters.
1576 public function testDeleteEmptyParamsContribution() {
1578 $this->callAPIFailure('contribution', 'delete', $params);
1581 public function testDeleteParamsNotArrayContribution() {
1582 $params = 'contribution_id= 1';
1583 $contribution = $this->callAPIFailure('contribution', 'delete', $params);
1584 $this->assertEquals($contribution['error_message'], 'Input variable `params` is not an array');
1587 public function testDeleteWrongParamContribution() {
1589 'contribution_source' => 'SSF',
1592 $this->callAPIFailure('contribution', 'delete', $params);
1595 public function testDeleteContribution() {
1596 $contributionID = $this->contributionCreate(array(
1597 'contact_id' => $this->_individualId
,
1598 'financial_type_id' => $this->_financialTypeId
,
1601 'id' => $contributionID,
1603 $this->callAPIAndDocument('contribution', 'delete', $params, __FUNCTION__
, __FILE__
);
1607 * Test civicrm_contribution_search with empty params.
1609 * All available contributions expected.
1611 public function testSearchEmptyParams() {
1615 'contact_id' => $this->_individualId
,
1616 'receive_date' => date('Ymd'),
1617 'total_amount' => 100.00,
1618 'financial_type_id' => $this->_financialTypeId
,
1619 'non_deductible_amount' => 10.00,
1620 'fee_amount' => 5.00,
1621 'net_amount' => 95.00,
1623 'invoice_id' => 78910,
1625 'contribution_status_id' => 1,
1628 $contribution = $this->callAPISuccess('contribution', 'create', $p);
1630 $result = $this->callAPISuccess('contribution', 'get', $params);
1631 // We're taking the first element.
1632 $res = $result['values'][$contribution['id']];
1634 $this->assertEquals($p['contact_id'], $res['contact_id']);
1635 $this->assertEquals($p['total_amount'], $res['total_amount']);
1636 $this->assertEquals($p['financial_type_id'], $res['financial_type_id']);
1637 $this->assertEquals($p['net_amount'], $res['net_amount']);
1638 $this->assertEquals($p['non_deductible_amount'], $res['non_deductible_amount']);
1639 $this->assertEquals($p['fee_amount'], $res['fee_amount']);
1640 $this->assertEquals($p['trxn_id'], $res['trxn_id']);
1641 $this->assertEquals($p['invoice_id'], $res['invoice_id']);
1642 $this->assertEquals($p['source'], $res['contribution_source']);
1643 // contribution_status_id = 1 => Completed
1644 $this->assertEquals('Completed', $res['contribution_status']);
1646 $this->contributionDelete($contribution['id']);
1650 * Test civicrm_contribution_search. Success expected.
1652 public function testSearch() {
1654 'contact_id' => $this->_individualId
,
1655 'receive_date' => date('Ymd'),
1656 'total_amount' => 100.00,
1657 'financial_type_id' => $this->_financialTypeId
,
1658 'non_deductible_amount' => 10.00,
1659 'contribution_status_id' => 1,
1662 $contribution1 = $this->callAPISuccess('contribution', 'create', $p1);
1665 'contact_id' => $this->_individualId
,
1666 'receive_date' => date('Ymd'),
1667 'total_amount' => 200.00,
1668 'financial_type_id' => $this->_financialTypeId
,
1669 'non_deductible_amount' => 20.00,
1670 'trxn_id' => 5454565,
1671 'invoice_id' => 1212124,
1672 'fee_amount' => 50.00,
1673 'net_amount' => 60.00,
1674 'contribution_status_id' => 2,
1677 $contribution2 = $this->callAPISuccess('contribution', 'create', $p2);
1680 'contribution_id' => $contribution2['id'],
1683 $result = $this->callAPISuccess('contribution', 'get', $params);
1684 $res = $result['values'][$contribution2['id']];
1686 $this->assertEquals($p2['contact_id'], $res['contact_id']);
1687 $this->assertEquals($p2['total_amount'], $res['total_amount']);
1688 $this->assertEquals($p2['financial_type_id'], $res['financial_type_id']);
1689 $this->assertEquals($p2['net_amount'], $res['net_amount']);
1690 $this->assertEquals($p2['non_deductible_amount'], $res['non_deductible_amount']);
1691 $this->assertEquals($p2['fee_amount'], $res['fee_amount']);
1692 $this->assertEquals($p2['trxn_id'], $res['trxn_id']);
1693 $this->assertEquals($p2['invoice_id'], $res['invoice_id']);
1694 // contribution_status_id = 2 => Pending
1695 $this->assertEquals('Pending', $res['contribution_status']);
1697 $this->contributionDelete($contribution1['id']);
1698 $this->contributionDelete($contribution2['id']);
1702 * Test completing a transaction via the API.
1704 * Note that we are creating a logged in user because email goes out from
1707 public function testCompleteTransaction() {
1708 $mut = new CiviMailUtils($this, TRUE);
1709 $this->swapMessageTemplateForTestTemplate();
1710 $this->createLoggedInUser();
1711 $params = array_merge($this->_params
, array('contribution_status_id' => 2));
1712 $contribution = $this->callAPISuccess('contribution', 'create', $params);
1713 $this->callAPISuccess('contribution', 'completetransaction', array(
1714 'id' => $contribution['id'],
1716 $contribution = $this->callAPISuccess('contribution', 'getsingle', array('id' => $contribution['id']));
1717 $this->assertEquals('SSF', $contribution['contribution_source']);
1718 $this->assertEquals('Completed', $contribution['contribution_status']);
1719 $this->assertEquals(date('Y-m-d'), date('Y-m-d', strtotime($contribution['receipt_date'])));
1720 $mut->checkMailLog(array(
1721 'email:::anthony_anderson@civicrm.org',
1725 'receive_date:::' . date('Ymd', strtotime($contribution['receive_date'])),
1726 "receipt_date:::\n",
1727 'contributeMode:::notify',
1728 'title:::Contribution',
1729 'displayName:::Mr. Anthony Anderson II',
1732 $this->revertTemplateToReservedTemplate();
1736 * Test to ensure mail is sent on chosing pay later
1738 public function testpayLater() {
1739 $mut = new CiviMailUtils($this, TRUE);
1740 $this->swapMessageTemplateForTestTemplate();
1741 $this->createLoggedInUser();
1743 // create contribution page first
1744 $contributionPageParams = array(
1745 'title' => 'Help Support CiviCRM!',
1746 'financial_type_id' => 1,
1747 'is_monetary' => TRUE,
1748 'is_pay_later' => 1,
1749 'is_quick_config' => TRUE,
1750 'pay_later_text' => 'I will send payment by check',
1751 'pay_later_receipt' => 'This is a pay later reciept',
1752 'is_allow_other_amount' => 1,
1753 'min_amount' => 10.00,
1754 'max_amount' => 10000.00,
1755 'goal_amount' => 100000.00,
1756 'is_email_receipt' => 1,
1758 'amount_block_is_active' => 1,
1759 'currency' => 'USD',
1760 'is_billing_required' => 0,
1762 $contributionPageResult = $this->callAPISuccess('contribution_page', 'create', $contributionPageParams);
1764 // submit form values
1765 $priceSet = $this->callAPISuccess('price_set', 'getsingle', array('name' => 'default_contribution_amount'));
1767 'id' => $contributionPageResult['id'],
1768 'contact_id' => $this->_individualId
,
1769 'email-5' => 'anthony_anderson@civicrm.org',
1770 'payment_processor_id' => 0,
1773 'currencyID' => 'USD',
1774 'is_pay_later' => 1,
1775 'invoiceID' => 'f28e1ddc86f8c4a0ff5bcf46393e4bc8',
1776 'is_quick_config' => 1,
1777 'description' => 'Online Contribution: Help Support CiviCRM!',
1778 'price_set_id' => $priceSet['id'],
1780 $this->callAPISuccess('contribution_page', 'submit', $params);
1782 $mut->checkMailLog(array(
1784 'email:::anthony_anderson@civicrm.org',
1785 'pay_later_receipt:::' . $contributionPageParams['pay_later_receipt'],
1786 'displayName:::Mr. Anthony Anderson II',
1787 'contributionPageId:::' . $contributionPageResult['id'],
1788 'title:::' . $contributionPageParams['title'],
1789 'amount:::' . $params['amount'],
1792 $this->revertTemplateToReservedTemplate();
1796 * Test to check whether contact billing address is used when no contribution address
1798 public function testBillingAddress() {
1799 $mut = new CiviMailUtils($this, TRUE);
1800 $this->swapMessageTemplateForTestTemplate();
1801 $this->createLoggedInUser();
1803 //Scenario 1: When Contact don't have any address
1804 $params = array_merge($this->_params
, array('contribution_status_id' => 2));
1805 $contribution = $this->callAPISuccess('contribution', 'create', $params);
1806 $this->callAPISuccess('contribution', 'completetransaction', array(
1807 'id' => $contribution['id'],
1809 $mut->checkMailLog(array(
1813 // Scenario 2: Contribution using address
1814 $address = $this->callAPISuccess('address', 'create', array(
1815 'street_address' => 'contribution billing st',
1816 'location_type_id' => 2,
1817 'contact_id' => $this->_params
['contact_id'],
1819 $params = array_merge($this->_params
, array(
1820 'contribution_status_id' => 2,
1821 'address_id' => $address['id'],
1824 $contribution = $this->callAPISuccess('contribution', 'create', $params);
1825 $this->callAPISuccess('contribution', 'completetransaction', array(
1826 'id' => $contribution['id'],
1828 $mut->checkMailLog(array(
1829 'address:::contribution billing st',
1832 // Scenario 3: Contribution wtth no address but contact has a billing address
1833 $this->callAPISuccess('address', 'create', array(
1834 'id' => $address['id'],
1835 'street_address' => 'is billing st',
1836 'contact_id' => $this->_params
['contact_id'],
1838 $params = array_merge($this->_params
, array('contribution_status_id' => 2));
1839 $contribution = $this->callAPISuccess('contribution', 'create', $params);
1840 $this->callAPISuccess('contribution', 'completetransaction', array(
1841 'id' => $contribution['id'],
1843 $mut->checkMailLog(array(
1844 'address:::is billing st',
1848 $this->revertTemplateToReservedTemplate();
1852 * Test completing a transaction via the API.
1854 * Note that we are creating a logged in user because email goes out from
1857 public function testCompleteTransactionFeeAmount() {
1858 $this->createLoggedInUser();
1859 $params = array_merge($this->_params
, array('contribution_status_id' => 2));
1860 $contribution = $this->callAPISuccess('contribution', 'create', $params);
1861 $this->callAPISuccess('contribution', 'completetransaction', array(
1862 'id' => $contribution['id'],
1863 'fee_amount' => '.56',
1864 'trxn_id' => '7778888',
1866 $contribution = $this->callAPISuccess('contribution', 'getsingle', array('id' => $contribution['id'], 'sequential' => 1));
1867 $this->assertEquals('Completed', $contribution['contribution_status']);
1868 $this->assertEquals('7778888', $contribution['trxn_id']);
1869 $this->assertEquals('.56', $contribution['fee_amount']);
1870 $this->assertEquals('99.44', $contribution['net_amount']);
1874 * CRM-19126 Add test to verify when complete transaction is called tax amount is not changed
1876 public function testCheckTaxAmount() {
1877 $contact = $this->createLoggedInUser();
1878 $financialType = $this->callAPISuccess('financial_type', 'create', array(
1879 'name' => 'Test taxable financial Type',
1883 $financialAccount = $this->callAPISuccess('financial_account', 'create', array(
1884 'name' => 'Test Tax financial account ',
1885 'contact_id' => $contact,
1886 'financial_account_type_id' => 2,
1893 $financialTypeId = $financialType['id'];
1894 $financialAccountId = $financialAccount['id'];
1895 $financialAccountParams = array(
1896 'entity_table' => 'civicrm_financial_type',
1897 'entity_id' => $financialTypeId,
1898 'account_relationship' => 10,
1899 'financial_account_id' => $financialAccountId,
1901 CRM_Financial_BAO_FinancialTypeAccount
::add($financialAccountParams);
1903 $params = array_merge($this->_params
, array('contribution_status_id' => 2, 'financial_type_id' => $financialTypeId));
1904 $contribution = $this->callAPISuccess('contribution', 'create', $params);
1905 $contribution1 = $this->callAPISuccess('contribution', 'get', array('id' => $contribution['id'], 'return' => 'tax_amount', 'sequential' => 1));
1906 $this->callAPISuccess('contribution', 'completetransaction', array(
1907 'id' => $contribution['id'],
1908 'trxn_id' => '777788888',
1909 'fee_amount' => '6.00',
1911 $contribution2 = $this->callAPISuccess('contribution', 'get', array('id' => $contribution['id'], 'return' => array('tax_amount', 'fee_amount', 'net_amount'), 'sequential' => 1));
1912 $this->assertEquals($contribution1['values'][0]['tax_amount'], $contribution2['values'][0]['tax_amount']);
1913 $this->assertEquals('6.00', $contribution2['values'][0]['fee_amount']);
1914 $this->assertEquals('99.00', $contribution2['values'][0]['net_amount']);
1918 * Test repeat contribution successfully creates line item.
1920 public function testRepeatTransaction() {
1921 $originalContribution = $this->setUpRepeatTransaction($recurParams = array(), 'single');
1922 $this->callAPISuccess('contribution', 'repeattransaction', array(
1923 'original_contribution_id' => $originalContribution['id'],
1924 'contribution_status_id' => 'Completed',
1925 'trxn_id' => uniqid(),
1927 $lineItemParams = array(
1928 'entity_id' => $originalContribution['id'],
1936 'financial_type_id',
1937 'deductible_amount',
1938 'price_field_value_id',
1942 $lineItem1 = $this->callAPISuccess('line_item', 'get', array_merge($lineItemParams, array(
1943 'entity_id' => $originalContribution['id'],
1945 $lineItem2 = $this->callAPISuccess('line_item', 'get', array_merge($lineItemParams, array(
1946 'entity_id' => $originalContribution['id'] +
1,
1948 unset($lineItem1['values'][0]['id'], $lineItem1['values'][0]['entity_id']);
1949 unset($lineItem2['values'][0]['id'], $lineItem2['values'][0]['entity_id']);
1950 $this->assertEquals($lineItem1['values'][0], $lineItem2['values'][0]);
1951 $this->_checkFinancialRecords(array(
1952 'id' => $originalContribution['id'] +
1,
1953 'payment_instrument_id' => $this->callAPISuccessGetValue('PaymentProcessor', array(
1954 'id' => $originalContribution['payment_processor_id'],
1955 'return' => 'payment_instrument_id',
1958 $this->quickCleanUpFinancialEntities();
1962 * Test repeat contribution successfully creates line items (plural).
1964 public function testRepeatTransactionLineItems() {
1966 $originalContribution = $this->setUpRepeatTransaction($recurParams = array(), 'multiple');
1967 $this->callAPISuccess('contribution', 'repeattransaction', array(
1968 'original_contribution_id' => $originalContribution['id'],
1969 'contribution_status_id' => 'Completed',
1970 'trxn_id' => uniqid(),
1973 $lineItemParams = array(
1974 'entity_id' => $originalContribution['id'],
1982 'financial_type_id',
1983 'deductible_amount',
1984 'price_field_value_id',
1988 $lineItem1 = $this->callAPISuccess('line_item', 'get', array_merge($lineItemParams, array(
1989 'entity_id' => $originalContribution['id'],
1991 $lineItem2 = $this->callAPISuccess('line_item', 'get', array_merge($lineItemParams, array(
1992 'entity_id' => $originalContribution['id'] +
1,
1995 // unset id and entity_id for all of them to be able to compare the lineItems:
1996 unset($lineItem1['values'][0]['id'], $lineItem1['values'][0]['entity_id']);
1997 unset($lineItem2['values'][0]['id'], $lineItem2['values'][0]['entity_id']);
1998 $this->assertEquals($lineItem1['values'][0], $lineItem2['values'][0]);
2000 unset($lineItem1['values'][1]['id'], $lineItem1['values'][1]['entity_id']);
2001 unset($lineItem2['values'][1]['id'], $lineItem2['values'][1]['entity_id']);
2002 $this->assertEquals($lineItem1['values'][1], $lineItem2['values'][1]);
2004 // CRM-19309 so in future we also want to:
2005 // check that financial_line_items have been created for entity_id 3 and 4;
2007 $this->callAPISuccessGetCount('FinancialItem', array('description' => 'Sales Tax', 'amount' => 0), 0);
2008 $this->quickCleanUpFinancialEntities();
2012 * Test repeat contribution successfully creates is_test transaction.
2014 public function testRepeatTransactionIsTest() {
2015 $this->_params
['is_test'] = 1;
2016 $originalContribution = $this->setUpRepeatTransaction(array('is_test' => 1), 'single');
2018 $this->callAPISuccess('contribution', 'repeattransaction', array(
2019 'original_contribution_id' => $originalContribution['id'],
2020 'contribution_status_id' => 'Completed',
2021 'trxn_id' => uniqid(),
2023 $this->callAPISuccessGetCount('Contribution', array('contribution_test' => 1), 2);
2027 * Test repeat contribution passed in status.
2029 public function testRepeatTransactionPassedInStatus() {
2030 $originalContribution = $this->setUpRepeatTransaction($recurParams = array(), 'single');
2032 $this->callAPISuccess('contribution', 'repeattransaction', array(
2033 'original_contribution_id' => $originalContribution['id'],
2034 'contribution_status_id' => 'Pending',
2035 'trxn_id' => uniqid(),
2037 $this->callAPISuccessGetCount('Contribution', array('contribution_status_id' => 2), 1);
2041 * Test repeat contribution accepts recur_id instead of original_contribution_id.
2043 public function testRepeatTransactionAcceptRecurID() {
2044 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array(
2045 'contact_id' => $this->_individualId
,
2046 'installments' => '12',
2047 'frequency_interval' => '1',
2049 'contribution_status_id' => 1,
2050 'start_date' => '2012-01-01 00:00:00',
2051 'currency' => 'USD',
2052 'frequency_unit' => 'month',
2053 'payment_processor_id' => $this->paymentProcessorID
,
2055 $this->callAPISuccess('contribution', 'create', array_merge(
2057 array('contribution_recur_id' => $contributionRecur['id']))
2060 $this->callAPISuccess('contribution', 'repeattransaction', array(
2061 'contribution_recur_id' => $contributionRecur['id'],
2062 'contribution_status_id' => 'Completed',
2063 'trxn_id' => uniqid(),
2066 $this->quickCleanUpFinancialEntities();
2070 * CRM-19873 Test repattransaction if contribution_recur_id is a test.
2072 public function testRepeatTransactionTestRecurId() {
2073 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array(
2074 'contact_id' => $this->_individualId
,
2075 'frequency_interval' => '1',
2077 'contribution_status_id' => 1,
2078 'start_date' => '2017-01-01 00:00:00',
2079 'currency' => 'USD',
2080 'frequency_unit' => 'month',
2081 'payment_processor_id' => $this->paymentProcessorID
,
2084 $this->callAPISuccess('contribution', 'create', array_merge(
2087 'contribution_recur_id' => $contributionRecur['id'],
2092 $repeatedContribution = $this->callAPISuccess('contribution', 'repeattransaction', array(
2093 'contribution_recur_id' => $contributionRecur['id'],
2094 'contribution_status_id' => 'Completed',
2095 'trxn_id' => uniqid(),
2098 $this->assertEquals($contributionRecur['values'][1]['is_test'], $repeatedContribution['values'][2]['is_test']);
2099 $this->quickCleanUpFinancialEntities();
2102 * CRM-19945 Tests repeattransaction is using a completed contribution for the template.
2104 * ( Tests membership is renewed after repeattransaction. )
2106 public function testRepeatTransactionUsesCompleted() {
2107 list($originalContribution, $membership) = $this->setUpAutoRenewMembership();
2109 $this->callAPISuccess('contribution', 'create', array(
2110 'contact_id' => $originalContribution['values'][1]['contact_id'],
2111 'financial_type_id' => $originalContribution['values'][1]['financial_type_id'],
2112 'total_amount' => $originalContribution['values'][1]['total_amount'],
2113 'contribution_recur_id' => $originalContribution['values'][1]['contribution_recur_id'],
2114 'contribution_status_id' => "Failed",
2117 $this->callAPISuccess('membership', 'create', array(
2118 'id' => $membership['id'],
2119 'end_date' => 'yesterday',
2123 $contribution = $this->callAPISuccess('contribution', 'repeattransaction', array(
2124 'contribution_recur_id' => $originalContribution['values'][1]['contribution_recur_id'],
2125 'contribution_status_id' => 'Completed',
2126 'trxn_id' => 'bobsled',
2129 $membershipStatusId = $this->callAPISuccess('membership', 'getvalue', array(
2130 'id' => $membership['id'],
2131 'return' => 'status_id',
2134 $this->assertEquals('New', CRM_Core_PseudoConstant
::getLabel('CRM_Member_BAO_Membership', 'status_id', $membershipStatusId));
2136 $lineItem = $this->callAPISuccessGetSingle('LineItem', array('contribution_id' => $contribution['id']));
2137 $this->assertEquals('civicrm_membership', $lineItem['entity_table']);
2138 $this->callAPISuccessGetCount('MembershipPayment', array('membership_id' => $membership['id']));
2139 $this->quickCleanUpFinancialEntities();
2140 $this->contactDelete($originalContribution['values'][1]['contact_id']);
2144 * CRM-16397 test appropriate action if total amount has changed for single line items.
2146 public function testRepeatTransactionAlteredAmount() {
2147 $paymentProcessorID = $this->paymentProcessorCreate();
2148 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array(
2149 'contact_id' => $this->_individualId
,
2150 'installments' => '12',
2151 'frequency_interval' => '1',
2153 'contribution_status_id' => 1,
2154 'start_date' => '2012-01-01 00:00:00',
2155 'currency' => 'USD',
2156 'frequency_unit' => 'month',
2157 'payment_processor_id' => $paymentProcessorID,
2159 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
2162 'contribution_recur_id' => $contributionRecur['id'],
2166 $this->callAPISuccess('contribution', 'repeattransaction', array(
2167 'original_contribution_id' => $originalContribution['id'],
2168 'contribution_status_id' => 'Completed',
2169 'trxn_id' => uniqid(),
2170 'total_amount' => '400',
2174 $lineItemParams = array(
2175 'entity_id' => $originalContribution['id'],
2183 'financial_type_id',
2184 'deductible_amount',
2185 'price_field_value_id',
2189 $this->callAPISuccessGetSingle('contribution', array(
2190 'total_amount' => 400,
2192 'net_amount' => 350,
2194 $lineItem1 = $this->callAPISuccess('line_item', 'get', array_merge($lineItemParams, array(
2195 'entity_id' => $originalContribution['id'],
2197 $expectedLineItem = array_merge(
2198 $lineItem1['values'][0], array(
2199 'line_total' => '400.00',
2200 'unit_price' => '400.00',
2204 $lineItem2 = $this->callAPISuccess('line_item', 'get', array_merge($lineItemParams, array(
2205 'entity_id' => $originalContribution['id'] +
1,
2208 unset($expectedLineItem['id'], $expectedLineItem['entity_id']);
2209 unset($lineItem2['values'][0]['id'], $lineItem2['values'][0]['entity_id']);
2210 $this->assertEquals($expectedLineItem, $lineItem2['values'][0]);
2214 * CRM-17718 test appropriate action if financial type has changed for single line items.
2216 public function testRepeatTransactionPassedInFinancialType() {
2217 $originalContribution = $this->setUpRecurringContribution();
2219 $this->callAPISuccess('contribution', 'repeattransaction', array(
2220 'original_contribution_id' => $originalContribution['id'],
2221 'contribution_status_id' => 'Completed',
2222 'trxn_id' => uniqid(),
2223 'financial_type_id' => 2,
2225 $lineItemParams = array(
2226 'entity_id' => $originalContribution['id'],
2234 'financial_type_id',
2235 'deductible_amount',
2236 'price_field_value_id',
2241 $this->callAPISuccessGetSingle('contribution', array(
2242 'total_amount' => 100,
2243 'financial_type_id' => 2,
2245 $lineItem1 = $this->callAPISuccess('line_item', 'get', array_merge($lineItemParams, array(
2246 'entity_id' => $originalContribution['id'],
2248 $expectedLineItem = array_merge(
2249 $lineItem1['values'][0], array(
2250 'line_total' => '100.00',
2251 'unit_price' => '100.00',
2252 'financial_type_id' => 2,
2253 'contribution_type_id' => 2,
2256 $lineItem2 = $this->callAPISuccess('line_item', 'get', array_merge($lineItemParams, array(
2257 'entity_id' => $originalContribution['id'] +
1,
2259 unset($expectedLineItem['id'], $expectedLineItem['entity_id']);
2260 unset($lineItem2['values'][0]['id'], $lineItem2['values'][0]['entity_id']);
2261 $this->assertEquals($expectedLineItem, $lineItem2['values'][0]);
2265 * CRM-17718 test appropriate action if financial type has changed for single line items.
2267 public function testRepeatTransactionUpdatedFinancialType() {
2268 $originalContribution = $this->setUpRecurringContribution(array(), array('financial_type_id' => 2));
2270 $this->callAPISuccess('contribution', 'repeattransaction', array(
2271 'contribution_recur_id' => $originalContribution['id'],
2272 'contribution_status_id' => 'Completed',
2273 'trxn_id' => uniqid(),
2275 $lineItemParams = array(
2276 'entity_id' => $originalContribution['id'],
2284 'financial_type_id',
2285 'deductible_amount',
2286 'price_field_value_id',
2291 $this->callAPISuccessGetSingle('contribution', array(
2292 'total_amount' => 100,
2293 'financial_type_id' => 2,
2295 $lineItem1 = $this->callAPISuccess('line_item', 'get', array_merge($lineItemParams, array(
2296 'entity_id' => $originalContribution['id'],
2298 $expectedLineItem = array_merge(
2299 $lineItem1['values'][0], array(
2300 'line_total' => '100.00',
2301 'unit_price' => '100.00',
2302 'financial_type_id' => 2,
2303 'contribution_type_id' => 2,
2307 $lineItem2 = $this->callAPISuccess('line_item', 'get', array_merge($lineItemParams, array(
2308 'entity_id' => $originalContribution['id'] +
1,
2310 unset($expectedLineItem['id'], $expectedLineItem['entity_id']);
2311 unset($lineItem2['values'][0]['id'], $lineItem2['values'][0]['entity_id']);
2312 $this->assertEquals($expectedLineItem, $lineItem2['values'][0]);
2316 * CRM-16397 test appropriate action if campaign has been passed in.
2318 public function testRepeatTransactionPassedInCampaign() {
2319 $paymentProcessorID = $this->paymentProcessorCreate();
2320 $campaignID = $this->campaignCreate();
2321 $campaignID2 = $this->campaignCreate();
2322 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array(
2323 'contact_id' => $this->_individualId
,
2324 'installments' => '12',
2325 'frequency_interval' => '1',
2327 'contribution_status_id' => 1,
2328 'start_date' => '2012-01-01 00:00:00',
2329 'currency' => 'USD',
2330 'frequency_unit' => 'month',
2331 'payment_processor_id' => $paymentProcessorID,
2333 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
2336 'contribution_recur_id' => $contributionRecur['id'],
2337 'campaign_id' => $campaignID,
2341 $this->callAPISuccess('contribution', 'repeattransaction', array(
2342 'original_contribution_id' => $originalContribution['id'],
2343 'contribution_status_id' => 'Completed',
2344 'trxn_id' => uniqid(),
2345 'campaign_id' => $campaignID2,
2348 $this->callAPISuccessGetSingle('contribution', array(
2349 'total_amount' => 100,
2350 'campaign_id' => $campaignID2,
2355 * CRM-17718 campaign stored on contribution recur gets priority.
2357 * This reflects the fact we permit people to update them.
2359 public function testRepeatTransactionUpdatedCampaign() {
2360 $paymentProcessorID = $this->paymentProcessorCreate();
2361 $campaignID = $this->campaignCreate();
2362 $campaignID2 = $this->campaignCreate();
2363 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array(
2364 'contact_id' => $this->_individualId
,
2365 'installments' => '12',
2366 'frequency_interval' => '1',
2368 'contribution_status_id' => 1,
2369 'start_date' => '2012-01-01 00:00:00',
2370 'currency' => 'USD',
2371 'frequency_unit' => 'month',
2372 'payment_processor_id' => $paymentProcessorID,
2373 'campaign_id' => $campaignID,
2375 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
2378 'contribution_recur_id' => $contributionRecur['id'],
2379 'campaign_id' => $campaignID2,
2383 $this->callAPISuccess('contribution', 'repeattransaction', array(
2384 'original_contribution_id' => $originalContribution['id'],
2385 'contribution_status_id' => 'Completed',
2386 'trxn_id' => uniqid(),
2389 $this->callAPISuccessGetSingle('contribution', array(
2390 'total_amount' => 100,
2391 'campaign_id' => $campaignID,
2396 * Test completing a transaction does not 'mess' with net amount (CRM-15960).
2398 public function testCompleteTransactionNetAmountOK() {
2399 $this->createLoggedInUser();
2400 $params = array_merge($this->_params
, array('contribution_status_id' => 2));
2401 unset($params['net_amount']);
2402 $contribution = $this->callAPISuccess('contribution', 'create', $params);
2403 $this->callAPISuccess('contribution', 'completetransaction', array(
2404 'id' => $contribution['id'],
2406 $contribution = $this->callAPISuccess('contribution', 'getsingle', array('id' => $contribution['id']));
2407 $this->assertEquals('Completed', $contribution['contribution_status']);
2408 $this->assertTrue(($contribution['total_amount'] - $contribution['net_amount']) == $contribution['fee_amount']);
2412 * CRM-14151 - Test completing a transaction via the API.
2414 public function testCompleteTransactionWithReceiptDateSet() {
2415 $this->swapMessageTemplateForTestTemplate();
2416 $mut = new CiviMailUtils($this, TRUE);
2417 $this->createLoggedInUser();
2418 $params = array_merge($this->_params
, array('contribution_status_id' => 2, 'receipt_date' => 'now'));
2419 $contribution = $this->callAPISuccess('contribution', 'create', $params);
2420 $this->callAPISuccess('contribution', 'completetransaction', array('id' => $contribution['id'], 'trxn_date' => date('Y-m-d')));
2421 $contribution = $this->callAPISuccess('contribution', 'get', array('id' => $contribution['id'], 'sequential' => 1));
2422 $this->assertEquals('Completed', $contribution['values'][0]['contribution_status']);
2423 $this->assertEquals(date('Y-m-d'), date('Y-m-d', strtotime($contribution['values'][0]['receive_date'])));
2424 $mut->checkMailLog(array(
2425 'Receipt - Contribution',
2426 'receipt_date:::' . date('Ymd'),
2429 $this->revertTemplateToReservedTemplate();
2433 * CRM-1960 - Test to ensure that completetransaction respects the is_email_receipt setting
2435 public function testCompleteTransactionWithEmailReceiptInput() {
2436 $contributionPage = $this->createReceiptableContributionPage();
2438 $this->_params
['contribution_page_id'] = $contributionPage['id'];
2439 $params = array_merge($this->_params
, array('contribution_status_id' => 2));
2440 $contribution = $this->callAPISuccess('contribution', 'create', $params);
2441 // Complete the transaction overriding is_email_receipt to = FALSE
2442 $this->callAPISuccess('contribution', 'completetransaction', array(
2443 'id' => $contribution['id'],
2444 'trxn_date' => date('2011-04-09'),
2445 'trxn_id' => 'kazam',
2446 'is_email_receipt' => 0,
2448 // Check if a receipt was issued
2449 $receipt_date = $this->callAPISuccess('Contribution', 'getvalue', array('id' => $contribution['id'], 'return' => 'receipt_date'));
2450 $this->assertEquals('', $receipt_date);
2454 * Test that $is_recur is assigned to the receipt.
2456 public function testCompleteTransactionForRecurring() {
2458 $this->swapMessageTemplateForTestTemplate();
2459 $recurring = $this->setUpRecurringContribution();
2460 $contributionPage = $this->createReceiptableContributionPage(array('is_recur' => TRUE, 'recur_frequency_unit' => 'month', 'recur_interval' => 1));
2462 $this->_params
['contribution_page_id'] = $contributionPage['id'];
2463 $this->_params
['contribution_recur_id'] = $recurring['id'];
2465 $contribution = $this->setUpForCompleteTransaction();
2467 $this->callAPISuccess('contribution', 'completetransaction', array(
2468 'id' => $contribution['id'],
2469 'trxn_date' => date('2011-04-09'),
2470 'trxn_id' => 'kazam',
2471 'is_email_receipt' => 1,
2474 $this->mut
->checkMailLog(array(
2476 'cancelSubscriptionUrl:::http://dummy.com',
2479 $this->revertTemplateToReservedTemplate();
2482 * CRM-19710 - Test to ensure that completetransaction respects the input for is_email_receipt setting.
2484 * If passed in it will override the default from contribution page.
2486 public function testCompleteTransactionWithEmailReceiptInputTrue() {
2487 $mut = new CiviMailUtils($this, TRUE);
2488 $this->createLoggedInUser();
2489 // Create a Contribution Page with is_email_receipt = FALSE
2490 $contributionPage = $this->callAPISuccess('ContributionPage', 'create', array(
2491 'receipt_from_name' => 'Mickey Mouse',
2492 'receipt_from_email' => 'mickey@mouse.com',
2493 'title' => "Test Contribution Page",
2494 'financial_type_id' => 1,
2495 'currency' => 'CAD',
2496 'is_monetary' => TRUE,
2497 'is_email_receipt' => 0,
2499 $this->_params
['contribution_page_id'] = $contributionPage['id'];
2500 $params = array_merge($this->_params
, array('contribution_status_id' => 2, 'receipt_date' => 'now'));
2501 $contribution = $this->callAPISuccess('contribution', 'create', $params);
2502 // Complete the transaction overriding is_email_receipt to = TRUE
2503 $this->callAPISuccess('contribution', 'completetransaction', array(
2504 'id' => $contribution['id'],
2505 'is_email_receipt' => 1,
2507 $mut->checkMailLog(array(
2508 'Please print this receipt for your records.',
2514 * Complete the transaction using the template with all the possible.
2516 public function testCompleteTransactionWithTestTemplate() {
2517 $this->swapMessageTemplateForTestTemplate();
2518 $contribution = $this->setUpForCompleteTransaction();
2519 $this->callAPISuccess('contribution', 'completetransaction', array(
2520 'id' => $contribution['id'],
2521 'trxn_date' => date('2011-04-09'),
2522 'trxn_id' => 'kazam',
2524 $receive_date = $this->callAPISuccess('Contribution', 'getvalue', array('id' => $contribution['id'], 'return' => 'receive_date'));
2525 $this->mut
->checkMailLog(array(
2526 'email:::anthony_anderson@civicrm.org',
2530 'receive_date:::' . date('Ymd', strtotime($receive_date)),
2531 'receipt_date:::' . date('Ymd'),
2532 'contributeMode:::notify',
2533 'title:::Contribution',
2534 'displayName:::Mr. Anthony Anderson II',
2536 'contactID:::' . $this->_params
['contact_id'],
2537 'contributionID:::' . $contribution['id'],
2538 'financialTypeId:::1',
2539 'financialTypeName:::Donation',
2542 $this->revertTemplateToReservedTemplate();
2546 * Complete the transaction using the template with all the possible.
2548 public function testCompleteTransactionContributionPageFromAddress() {
2549 $contributionPage = $this->callAPISuccess('ContributionPage', 'create', array(
2550 'receipt_from_name' => 'Mickey Mouse',
2551 'receipt_from_email' => 'mickey@mouse.com',
2552 'title' => "Test Contribution Page",
2553 'financial_type_id' => 1,
2554 'currency' => 'NZD',
2555 'goal_amount' => 50,
2556 'is_pay_later' => 1,
2557 'is_monetary' => TRUE,
2558 'is_email_receipt' => TRUE,
2560 $this->_params
['contribution_page_id'] = $contributionPage['id'];
2561 $contribution = $this->setUpForCompleteTransaction();
2562 $this->callAPISuccess('contribution', 'completetransaction', array('id' => $contribution['id']));
2563 $this->mut
->checkMailLog(array(
2571 * Test completing first transaction in a recurring series.
2573 * The status should be set to 'in progress' and the next scheduled payment date calculated.
2575 * @dataProvider getScheduledDateData
2577 * @param array $dataSet
2579 * @throws \Exception
2581 public function testCompleteTransactionSetStatusToInProgress($dataSet) {
2582 $paymentProcessorID = $this->paymentProcessorCreate();
2583 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array_merge(array(
2584 'contact_id' => $this->_individualId
,
2585 'installments' => '2',
2586 'frequency_interval' => '1',
2588 'contribution_status_id' => 'Pending',
2589 'start_date' => '2012-01-01 00:00:00',
2590 'currency' => 'USD',
2591 'frequency_unit' => 'month',
2592 'payment_processor_id' => $paymentProcessorID,
2593 ), $dataSet['data']));
2594 $contribution = $this->callAPISuccess('contribution', 'create', array_merge(
2597 'contribution_recur_id' => $contributionRecur['id'],
2598 'contribution_status_id' => 'Pending',
2599 'receive_date' => $dataSet['receive_date'],
2602 $this->callAPISuccess('Contribution', 'completetransaction', array(
2603 'id' => $contribution,
2604 'receive_date' => $dataSet['receive_date'],
2606 $contributionRecur = $this->callAPISuccessGetSingle('ContributionRecur', array(
2607 'id' => $contributionRecur['id'],
2608 'return' => array('next_sched_contribution_date', 'contribution_status_id'),
2610 $this->assertEquals(5, $contributionRecur['contribution_status_id']);
2611 $this->assertEquals($dataSet['expected'], $contributionRecur['next_sched_contribution_date']);
2612 $this->callAPISuccess('Contribution', 'create', array_merge(
2615 'contribution_recur_id' => $contributionRecur['id'],
2616 'contribution_status_id' => 'Completed',
2619 $contributionRecur = $this->callAPISuccessGetSingle('ContributionRecur', array(
2620 'id' => $contributionRecur['id'],
2621 'return' => array('contribution_status_id'),
2623 $this->assertEquals(1, $contributionRecur['contribution_status_id']);
2627 * Get dates for testing.
2631 public function getScheduledDateData() {
2633 $result[]['2016-08-31-1-month'] = array(
2635 'start_date' => '2016-08-31',
2636 'frequency_interval' => 1,
2637 'frequency_unit' => 'month',
2639 'receive_date' => '2016-08-31',
2640 'expected' => '2016-10-01 00:00:00',
2642 $result[]['2012-01-01-1-month'] = array(
2644 'start_date' => '2012-01-01',
2645 'frequency_interval' => 1,
2646 'frequency_unit' => 'month',
2648 'receive_date' => '2012-01-01',
2649 'expected' => '2012-02-01 00:00:00',
2651 $result[]['2012-01-01-1-month'] = array(
2653 'start_date' => '2012-01-01',
2654 'frequency_interval' => 1,
2655 'frequency_unit' => 'month',
2657 'receive_date' => '2012-02-29',
2658 'expected' => '2012-03-29 00:00:00',
2664 * Test completing a pledge with the completeTransaction api..
2666 * Note that we are creating a logged in user because email goes out from
2669 public function testCompleteTransactionUpdatePledgePayment() {
2670 $this->swapMessageTemplateForTestTemplate();
2671 $mut = new CiviMailUtils($this, TRUE);
2672 $mut->clearMessages();
2673 $this->createLoggedInUser();
2674 $contributionID = $this->createPendingPledgeContribution();
2675 $this->callAPISuccess('contribution', 'completetransaction', array(
2676 'id' => $contributionID,
2677 'trxn_date' => '1 Feb 2013',
2679 $pledge = $this->callAPISuccessGetSingle('Pledge', array(
2680 'id' => $this->_ids
['pledge'],
2682 $this->assertEquals('Completed', $pledge['pledge_status']);
2684 $status = $this->callAPISuccessGetValue('PledgePayment', array(
2685 'pledge_id' => $this->_ids
['pledge'],
2686 'return' => 'status_id',
2688 $this->assertEquals(1, $status);
2689 $mut->checkMailLog(array(
2691 'receive_date:::20130201000000',
2692 "receipt_date:::\n",
2695 $this->revertTemplateToReservedTemplate();
2699 * Test completing a transaction with an event via the API.
2701 * Note that we are creating a logged in user because email goes out from
2704 public function testCompleteTransactionWithParticipantRecord() {
2705 $mut = new CiviMailUtils($this, TRUE);
2706 $mut->clearMessages();
2707 $this->createLoggedInUser();
2708 $contributionID = $this->createPendingParticipantContribution();
2709 $this->callAPISuccess('contribution', 'completetransaction', array(
2710 'id' => $contributionID,
2713 $participantStatus = $this->callAPISuccessGetValue('participant', array(
2714 'id' => $this->_ids
['participant'],
2715 'return' => 'participant_status_id',
2717 $this->assertEquals(1, $participantStatus);
2718 $mut->checkMailLog(array(
2719 'Annual CiviCRM meet',
2721 'This letter is a confirmation that your registration has been received and your status has been updated to Registered.',
2727 * Test membership is renewed when transaction completed.
2729 public function testCompleteTransactionMembershipPriceSet() {
2730 $this->createPriceSetWithPage('membership');
2731 $stateOfGrace = $this->callAPISuccess('MembershipStatus', 'getvalue', array(
2735 $this->setUpPendingContribution($this->_ids
['price_field_value'][0]);
2736 $membership = $this->callAPISuccess('membership', 'getsingle', array('id' => $this->_ids
['membership']));
2737 $logs = $this->callAPISuccess('MembershipLog', 'get', array(
2738 'membership_id' => $this->_ids
['membership'],
2740 $this->assertEquals(1, $logs['count']);
2741 $this->assertEquals($stateOfGrace, $membership['status_id']);
2742 $contribution = $this->callAPISuccess('contribution', 'completetransaction', array('id' => $this->_ids
['contribution']));
2743 $membership = $this->callAPISuccess('membership', 'getsingle', array('id' => $this->_ids
['membership']));
2744 $this->assertEquals(date('Y-m-d', strtotime('yesterday + 1 year')), $membership['end_date']);
2745 $this->callAPISuccessGetSingle('LineItem', array(
2746 'entity_id' => $this->_ids
['membership'],
2747 'entity_table' => 'civicrm_membership',
2749 $logs = $this->callAPISuccess('MembershipLog', 'get', array(
2750 'membership_id' => $this->_ids
['membership'],
2752 //CRM-19600: Ensure that 'Membership Renewal' activity is created after successful membership regsitration
2753 $activity = $this->callAPISuccess('Activity', 'get', array(
2754 'activity_type_id' => 'Membership Renewal',
2755 'source_record_id' => $contribution['id'],
2757 $this->assertEquals(1, $activity['count']);
2758 $this->assertEquals(2, $logs['count']);
2759 $this->assertNotEquals($stateOfGrace, $logs['values'][2]['status_id']);
2760 $this->cleanUpAfterPriceSets();
2764 * Test if renewal activity is create after changing Pending contribution to Completed via offline
2766 public function testPendingToCompleteContribution() {
2767 $contributionPage = $this->createPriceSetWithPage('membership');
2768 $stateOfGrace = $this->callAPISuccess('MembershipStatus', 'getvalue', array(
2772 $this->setUpPendingContribution($this->_ids
['price_field_value'][0]);
2773 $this->callAPISuccess('membership', 'getsingle', array('id' => $this->_ids
['membership']));
2775 // change pending contribution to completed
2776 $form = new CRM_Contribute_Form_Contribution();
2778 $form->_params
= array(
2779 'id' => $this->_ids
['contribution'],
2780 'total_amount' => 20,
2783 'financial_type_id' => 1,
2784 'receive_date' => '04/21/2015',
2785 'receive_date_time' => '11:27PM',
2786 'contact_id' => $this->_individualId
,
2787 'contribution_status_id' => 1,
2788 'billing_middle_name' => '',
2789 'billing_last_name' => 'Adams',
2790 'billing_street_address-5' => '790L Lincoln St S',
2791 'billing_city-5' => 'Maryknoll',
2792 'billing_state_province_id-5' => 1031,
2793 'billing_postal_code-5' => 10545,
2794 'billing_country_id-5' => 1228,
2795 'frequency_interval' => 1,
2796 'frequency_unit' => 'month',
2797 'installments' => '',
2798 'hidden_AdditionalDetail' => 1,
2799 'hidden_Premium' => 1,
2800 'from_email_address' => '"civi45" <civi45@civicrm.com>',
2801 'receipt_date' => '',
2802 'receipt_date_time' => '',
2803 'payment_processor_id' => $this->paymentProcessorID
,
2804 'currency' => 'USD',
2805 'contribution_page_id' => $this->_ids
['contribution_page'],
2806 'contribution_mode' => 'membership',
2807 'source' => 'Membership Signup and Renewal',
2810 $form->testSubmit($form->_params
, CRM_Core_Action
::UPDATE
);
2812 catch (Civi\Payment\Exception\PaymentProcessorException
$e) {
2815 $activity = $this->callAPISuccess('Activity', 'get', array(
2816 'activity_type_id' => 'Membership Renewal',
2817 'source_record_id' => $this->_ids
['contribution'],
2819 $this->assertEquals(1, $activity['count']);
2823 * Test membership is renewed when transaction completed.
2825 public function testCompleteTransactionMembershipPriceSetTwoTerms() {
2826 $this->createPriceSetWithPage('membership');
2827 $this->setUpPendingContribution($this->_ids
['price_field_value'][1]);
2828 $this->callAPISuccess('contribution', 'completetransaction', array('id' => $this->_ids
['contribution']));
2829 $membership = $this->callAPISuccess('membership', 'getsingle', array('id' => $this->_ids
['membership']));
2830 $this->assertEquals(date('Y-m-d', strtotime('yesterday + 2 years')), $membership['end_date']);
2831 $this->cleanUpAfterPriceSets();
2834 public function cleanUpAfterPriceSets() {
2835 $this->quickCleanUpFinancialEntities();
2836 $this->contactDelete($this->_ids
['contact']);
2840 * Set up a pending transaction with a specific price field id.
2842 * @param int $priceFieldValueID
2844 public function setUpPendingContribution($priceFieldValueID) {
2845 $contactID = $this->individualCreate();
2846 $membership = $this->callAPISuccess('membership', 'create', array(
2847 'contact_id' => $contactID,
2848 'membership_type_id' => $this->_ids
['membership_type'],
2849 'start_date' => 'yesterday - 1 year',
2850 'end_date' => 'yesterday',
2851 'join_date' => 'yesterday - 1 year',
2853 $contribution = $this->callAPISuccess('contribution', 'create', array(
2855 'contact_id' => $contactID,
2856 'receive_date' => date('Ymd'),
2857 'total_amount' => 20.00,
2858 'financial_type_id' => 1,
2859 'payment_instrument_id' => 'Credit Card',
2860 'non_deductible_amount' => 10.00,
2861 'trxn_id' => 'jdhfi88',
2862 'invoice_id' => 'djfhiewuyr',
2864 'contribution_status_id' => 2,
2865 'contribution_page_id' => $this->_ids
['contribution_page'],
2866 'api.membership_payment.create' => array('membership_id' => $membership['id']),
2869 $this->callAPISuccess('line_item', 'create', array(
2870 'entity_id' => $contribution['id'],
2871 'entity_table' => 'civicrm_contribution',
2872 'contribution_id' => $contribution['id'],
2873 'price_field_id' => $this->_ids
['price_field'][0],
2877 'financial_type_id' => 1,
2878 'price_field_value_id' => $priceFieldValueID,
2880 $this->_ids
['contact'] = $contactID;
2881 $this->_ids
['contribution'] = $contribution['id'];
2882 $this->_ids
['membership'] = $membership['id'];
2886 * Test sending a mail via the API.
2888 public function testSendMail() {
2889 $mut = new CiviMailUtils($this, TRUE);
2890 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
2891 $this->callAPISuccess('contribution', 'sendconfirmation', array(
2892 'id' => $contribution['id'],
2893 'receipt_from_email' => 'api@civicrm.org',
2896 $mut->checkMailLog(array(
2898 'Contribution Information',
2899 'Please print this confirmation for your records',
2905 $this->checkCreditCardDetails($mut, $contribution['id']);
2910 * Check credit card details in sent mail via API
2912 * @param $mut obj CiviMailUtils instance
2913 * @param int $contributionID Contribution ID
2916 public function checkCreditCardDetails($mut, $contributionID) {
2917 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
2918 $this->callAPISuccess('contribution', 'sendconfirmation', array(
2919 'id' => $contributionID,
2920 'receipt_from_email' => 'api@civicrm.org',
2921 'payment_processor_id' => $this->paymentProcessorID
,
2924 $mut->checkMailLog(array(
2925 'Credit Card Information', // credit card header
2926 'Billing Name and Address', // billing header
2927 'anthony_anderson@civicrm.org', // billing name
2935 * Test sending a mail via the API.
2937 public function testSendMailEvent() {
2938 $mut = new CiviMailUtils($this, TRUE);
2939 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
2940 $event = $this->eventCreate(array(
2941 'is_email_confirm' => 1,
2942 'confirm_from_email' => 'test@civicrm.org',
2944 $this->_eventID
= $event['id'];
2945 $participantParams = array(
2946 'contact_id' => $this->_individualId
,
2947 'event_id' => $this->_eventID
,
2950 // to ensure it matches later on
2951 'register_date' => '2007-07-21 00:00:00',
2952 'source' => 'Online Event Registration: API Testing',
2955 $participant = $this->callAPISuccess('participant', 'create', $participantParams);
2956 $this->callAPISuccess('participant_payment', 'create', array(
2957 'participant_id' => $participant['id'],
2958 'contribution_id' => $contribution['id'],
2960 $this->callAPISuccess('contribution', 'sendconfirmation', array(
2961 'id' => $contribution['id'],
2962 'receipt_from_email' => 'api@civicrm.org',
2966 $mut->checkMailLog(array(
2967 'Annual CiviCRM meet',
2969 'To: "Mr. Anthony Anderson II" <anthony_anderson@civicrm.org>',
2976 * This function does a GET & compares the result against the $params.
2978 * Use as a double check on Creates.
2980 * @param array $params
2982 * @param bool $delete
2984 public function contributionGetnCheck($params, $id, $delete = TRUE) {
2986 $contribution = $this->callAPISuccess('Contribution', 'Get', array(
2992 $this->callAPISuccess('contribution', 'delete', array('id' => $id));
2994 $this->assertAPISuccess($contribution, 0);
2995 $values = $contribution['values'][$contribution['id']];
2996 $params['receive_date'] = date('Y-m-d H:i:s', strtotime($params['receive_date']));
2997 // this is not returned in id format
2998 unset($params['payment_instrument_id']);
2999 $params['contribution_source'] = $params['source'];
3000 unset($params['source']);
3001 foreach ($params as $key => $value) {
3002 $this->assertEquals($value, $values[$key], $key . " value: $value doesn't match " . print_r($values, TRUE));
3007 * Create a pending contribution & linked pending pledge record.
3009 public function createPendingPledgeContribution() {
3011 $pledgeID = $this->pledgeCreate(array('contact_id' => $this->_individualId
, 'installments' => 1, 'amount' => 500));
3012 $this->_ids
['pledge'] = $pledgeID;
3013 $contribution = $this->callAPISuccess('contribution', 'create', array_merge($this->_params
, array(
3014 'contribution_status_id' => 'Pending',
3015 'total_amount' => 500,
3018 $paymentID = $this->callAPISuccessGetValue('PledgePayment', array(
3019 'options' => array('limit' => 1),
3022 $this->callAPISuccess('PledgePayment', 'create', array(
3024 'contribution_id' =>
3025 $contribution['id'],
3026 'status_id' => 'Pending',
3027 'scheduled_amount' => 500,
3030 return $contribution['id'];
3034 * Create a pending contribution & linked pending participant record (along with an event).
3036 public function createPendingParticipantContribution() {
3037 $event = $this->eventCreate(array('is_email_confirm' => 1, 'confirm_from_email' => 'test@civicrm.org'));
3038 $participantID = $this->participantCreate(array('event_id' => $event['id'], 'status_id' => 6));
3039 $this->_ids
['participant'] = $participantID;
3040 $params = array_merge($this->_params
, array('contribution_status_id' => 2, 'financial_type_id' => 'Event Fee'));
3041 $contribution = $this->callAPISuccess('contribution', 'create', $params);
3042 $this->callAPISuccess('participant_payment', 'create', array(
3043 'contribution_id' => $contribution['id'],
3044 'participant_id' => $participantID,
3046 $this->callAPISuccess('line_item', 'get', array(
3047 'entity_id' => $contribution['id'],
3048 'entity_table' => 'civicrm_contribution',
3049 'api.line_item.create' => array(
3050 'entity_id' => $participantID,
3051 'entity_table' => 'civicrm_participant',
3054 return $contribution['id'];
3058 * Get financial transaction amount.
3060 * @param int $contId
3062 * @return null|string
3064 public function _getFinancialTrxnAmount($contId) {
3066 SUM( ft.total_amount ) AS total
3067 FROM civicrm_financial_trxn AS ft
3068 LEFT JOIN civicrm_entity_financial_trxn AS ceft ON ft.id = ceft.financial_trxn_id
3069 WHERE ceft.entity_table = 'civicrm_contribution'
3070 AND ceft.entity_id = {$contId}";
3072 $result = CRM_Core_DAO
::singleValueQuery($query);
3077 * @param int $contId
3079 * @return null|string
3081 public function _getFinancialItemAmount($contId) {
3082 $lineItem = key(CRM_Price_BAO_LineItem
::getLineItems($contId, 'contribution'));
3085 FROM civicrm_financial_item
3086 WHERE entity_table = 'civicrm_line_item'
3087 AND entity_id = {$lineItem}";
3088 $result = CRM_Core_DAO
::singleValueQuery($query);
3093 * @param int $contId
3096 public function _checkFinancialItem($contId, $context) {
3097 if ($context != 'paylater') {
3099 'entity_id' => $contId,
3100 'entity_table' => 'civicrm_contribution',
3102 $trxn = current(CRM_Financial_BAO_FinancialItem
::retrieveEntityFinancialTrxn($params, TRUE));
3103 $entityParams = array(
3104 'financial_trxn_id' => $trxn['financial_trxn_id'],
3105 'entity_table' => 'civicrm_financial_item',
3107 $entityTrxn = current(CRM_Financial_BAO_FinancialItem
::retrieveEntityFinancialTrxn($entityParams));
3109 'id' => $entityTrxn['entity_id'],
3112 if ($context == 'paylater') {
3113 $lineItems = CRM_Price_BAO_LineItem
::getLineItems($contId, 'contribution');
3114 foreach ($lineItems as $key => $item) {
3116 'entity_id' => $key,
3117 'entity_table' => 'civicrm_line_item',
3119 $compareParams = array('status_id' => 1);
3120 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialItem', $params, $compareParams);
3123 elseif ($context == 'refund') {
3124 $compareParams = array(
3126 'financial_account_id' => 1,
3130 elseif ($context == 'cancelPending') {
3131 $compareParams = array(
3133 'financial_account_id' => 1,
3137 elseif ($context == 'changeFinancial') {
3138 $lineKey = key(CRM_Price_BAO_LineItem
::getLineItems($contId, 'contribution'));
3140 'entity_id' => $lineKey,
3143 $compareParams = array(
3144 'financial_account_id' => 1,
3146 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialItem', $params, $compareParams);
3148 'financial_account_id' => 3,
3149 'entity_id' => $lineKey,
3151 $compareParams = array(
3155 if ($context != 'paylater') {
3156 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialItem', $params, $compareParams);
3161 * Check financial transaction.
3163 * @todo break this down into sensible functions - most calls to it only use a few lines out of the big if.
3165 * @param array $contribution
3166 * @param string $context
3167 * @param int $instrumentId
3168 * @param array $extraParams
3170 public function _checkFinancialTrxn($contribution, $context, $instrumentId = NULL, $extraParams = array()) {
3171 $trxnParams = array(
3172 'entity_id' => $contribution['id'],
3173 'entity_table' => 'civicrm_contribution',
3175 $trxn = current(CRM_Financial_BAO_FinancialItem
::retrieveEntityFinancialTrxn($trxnParams, TRUE));
3177 'id' => $trxn['financial_trxn_id'],
3179 if ($context == 'payLater') {
3180 $compareParams = array(
3182 'from_financial_account_id' => CRM_Contribute_PseudoConstant
::getRelationalFinancialAccount($contribution['financial_type_id'], 'Accounts Receivable Account is'),
3185 elseif ($context == 'refund') {
3186 $compareParams = array(
3187 'to_financial_account_id' => 6,
3188 'total_amount' => -100,
3190 'trxn_date' => '2015-01-01 09:00:00',
3191 'trxn_id' => 'the refund',
3194 elseif ($context == 'cancelPending') {
3195 $compareParams = array(
3196 'to_financial_account_id' => 7,
3197 'total_amount' => -100,
3201 elseif ($context == 'changeFinancial' ||
$context == 'paymentInstrument') {
3202 $entityParams = array(
3203 'entity_id' => $contribution['id'],
3204 'entity_table' => 'civicrm_contribution',
3207 $trxn = current(CRM_Financial_BAO_FinancialItem
::retrieveEntityFinancialTrxn($entityParams));
3208 $trxnParams1 = array(
3209 'id' => $trxn['financial_trxn_id'],
3211 if (empty($extraParams)) {
3212 $compareParams = array(
3213 'total_amount' => -100,
3218 $compareParams = array(
3219 'total_amount' => 100,
3223 if ($context == 'paymentInstrument') {
3224 $compareParams +
= array(
3225 'to_financial_account_id' => CRM_Financial_BAO_FinancialTypeAccount
::getInstrumentFinancialAccount(4),
3226 'payment_instrument_id' => 4,
3230 $compareParams['to_financial_account_id'] = 12;
3232 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialTrxn', $trxnParams1, array_merge($compareParams, $extraParams));
3233 $compareParams['total_amount'] = 100;
3234 if ($context == 'paymentInstrument') {
3235 $compareParams['to_financial_account_id'] = CRM_Financial_BAO_FinancialTypeAccount
::getInstrumentFinancialAccount($instrumentId);
3236 $compareParams['payment_instrument_id'] = $instrumentId;
3239 $compareParams['to_financial_account_id'] = 12;
3243 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialTrxn', $params, array_merge($compareParams, $extraParams));
3249 public function _addPaymentInstrument() {
3250 $gId = CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_OptionGroup', 'payment_instrument', 'id', 'name');
3251 $optionParams = array(
3252 'option_group_id' => $gId,
3253 'label' => 'Test Card',
3254 'name' => 'Test Card',
3259 $optionValue = $this->callAPISuccess('option_value', 'create', $optionParams);
3260 $relationTypeId = key(CRM_Core_PseudoConstant
::accountOptionValues('account_relationship', NULL, " AND v.name LIKE 'Asset Account is' "));
3261 $financialParams = array(
3262 'entity_table' => 'civicrm_option_value',
3263 'entity_id' => $optionValue['id'],
3264 'account_relationship' => $relationTypeId,
3265 'financial_account_id' => 7,
3267 CRM_Financial_BAO_FinancialTypeAccount
::add($financialParams, CRM_Core_DAO
::$_nullArray);
3268 $this->assertNotEmpty($optionValue['values'][$optionValue['id']]['value']);
3269 return $optionValue['values'][$optionValue['id']]['value'];
3273 * Set up the basic recurring contribution for tests.
3275 * @param array $generalParams
3276 * Parameters that can be merged into the recurring AND the contribution.
3278 * @param array $recurParams
3279 * Parameters to merge into the recur only.
3283 protected function setUpRecurringContribution($generalParams = array(), $recurParams = array()) {
3284 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array_merge(array(
3285 'contact_id' => $this->_individualId
,
3286 'installments' => '12',
3287 'frequency_interval' => '1',
3289 'contribution_status_id' => 1,
3290 'start_date' => '2012-01-01 00:00:00',
3291 'currency' => 'USD',
3292 'frequency_unit' => 'month',
3293 'payment_processor_id' => $this->paymentProcessorID
,
3294 ), $generalParams, $recurParams));
3295 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3298 'contribution_recur_id' => $contributionRecur['id'],
3301 return $originalContribution;
3305 * Set up a basic auto-renew membership for tests.
3307 * @param array $generalParams
3308 * Parameters that can be merged into the recurring AND the contribution.
3310 * @param array $recurParams
3311 * Parameters to merge into the recur only.
3315 protected function setUpAutoRenewMembership($generalParams = array(), $recurParams = array()) {
3316 $newContact = $this->callAPISuccess('Contact', 'create', array(
3317 'contact_type' => 'Individual',
3318 'sort_name' => 'McTesterson, Testy',
3319 'display_name' => 'Testy McTesterson',
3320 'preferred_language' => 'en_US',
3321 'preferred_mail_format' => 'Both',
3322 'first_name' => 'Testy',
3323 'last_name' => 'McTesterson',
3324 'contact_is_deleted' => '0',
3326 'email' => 'tmctesterson@example.com',
3329 $membershipType = $this->callAPISuccess('MembershipType', 'create', array(
3330 'domain_id' => "Default Domain Name",
3331 'member_of_contact_id' => 1,
3332 'financial_type_id' => "Member Dues",
3333 'duration_unit' => "month",
3334 'duration_interval' => 1,
3335 'period_type' => 'rolling',
3336 'name' => "Standard Member",
3337 'minimum_fee' => 100,
3339 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array_merge(array(
3340 'contact_id' => $newContact['id'],
3341 'installments' => '12',
3342 'frequency_interval' => '1',
3344 'contribution_status_id' => 1,
3345 'start_date' => '2012-01-01 00:00:00',
3346 'currency' => 'USD',
3347 'frequency_unit' => 'month',
3348 'payment_processor_id' => $this->paymentProcessorID
,
3349 ), $generalParams, $recurParams));
3351 $membership = $this->callAPISuccess('membership', 'create', array(
3352 'contact_id' => $newContact['id'],
3353 'contribution_recur_id' => $contributionRecur['id'],
3354 'financial_type_id' => "Member Dues",
3355 'membership_type_id' => $membershipType['id'],
3357 'skipLineItem' => TRUE,
3360 CRM_Price_BAO_LineItem
::getLineItemArray($this->_params
, NULL, 'membership', $membershipType['id']);
3361 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3364 'contact_id' => $newContact['id'],
3365 'contribution_recur_id' => $contributionRecur['id'],
3366 'financial_type_id' => "Member Dues",
3367 'contribution_status_id' => 1,
3368 'invoice_id' => uniqid(),
3371 $lineItem = $this->callAPISuccess('LineItem', 'getsingle', array());
3372 $this->assertEquals('civicrm_membership', $lineItem['entity_table']);
3373 $membership = $this->callAPISuccess('Membership', 'getsingle', array('id' => $lineItem['entity_id']));
3374 $this->callAPISuccess('LineItem', 'getsingle', array());
3375 $this->callAPISuccessGetCount('MembershipPayment', array('membership_id' => $membership['id']), 1);
3377 return array($originalContribution, $membership);
3380 * Set up a repeat transaction.
3382 * @param array $recurParams
3386 protected function setUpRepeatTransaction($recurParams = array(), $flag) {
3387 $paymentProcessorID = $this->paymentProcessorCreate();
3388 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array_merge(array(
3389 'contact_id' => $this->_individualId
,
3390 'installments' => '12',
3391 'frequency_interval' => '1',
3393 'contribution_status_id' => 1,
3394 'start_date' => '2012-01-01 00:00:00',
3395 'currency' => 'USD',
3396 'frequency_unit' => 'month',
3397 'payment_processor_id' => $paymentProcessorID,
3400 $originalContribution = '';
3401 if ($flag == 'multiple') {
3402 // CRM-19309 create a contribution + also add in line_items (plural):
3403 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3406 'contribution_recur_id' => $contributionRecur['id'],
3407 'skipLineItem' => 1,
3408 'api.line_item.create' => array(
3410 'price_field_id' => 1,
3412 'line_total' => '20',
3413 'unit_price' => '10',
3414 'financial_type_id' => 1,
3417 'price_field_id' => 1,
3419 'line_total' => '80',
3420 'unit_price' => '80',
3421 'financial_type_id' => 2,
3428 elseif ($flag == 'single') {
3429 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3431 array('contribution_recur_id' => $contributionRecur['id']))
3434 $originalContribution['payment_processor_id'] = $paymentProcessorID;
3435 return $originalContribution;
3439 * Common set up routine.
3443 protected function setUpForCompleteTransaction() {
3444 $this->mut
= new CiviMailUtils($this, TRUE);
3445 $this->createLoggedInUser();
3446 $params = array_merge($this->_params
, array('contribution_status_id' => 2, 'receipt_date' => 'now'));
3447 $contribution = $this->callAPISuccess('contribution', 'create', $params);
3448 return $contribution;
3452 * Test repeat contribution uses the Payment Processor' payment_instrument setting.
3454 public function testRepeatTransactionWithNonCreditCardDefault() {
3455 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array(
3456 'contact_id' => $this->_individualId
,
3457 'installments' => '12',
3458 'frequency_interval' => '1',
3460 'contribution_status_id' => 1,
3461 'start_date' => '2012-01-01 00:00:00',
3462 'currency' => 'USD',
3463 'frequency_unit' => 'month',
3464 'payment_processor_id' => $this->paymentProcessorID
,
3466 $contribution1 = $this->callAPISuccess('contribution', 'create', array_merge(
3468 array('contribution_recur_id' => $contributionRecur['id'], 'payment_instrument_id' => 2))
3470 $paymentInstruments = CRM_Contribute_PseudoConstant
::paymentInstrument('name');
3471 $contribution2 = $this->callAPISuccess('contribution', 'repeattransaction', array(
3472 'contribution_status_id' => 'Completed',
3473 'trxn_id' => uniqid(),
3474 'original_contribution_id' => $contribution1,
3476 $this->assertEquals(array_search('Debit Card', $paymentInstruments), $contribution2['values'][$contribution2['id']]['payment_instrument_id']);
3477 $this->quickCleanUpFinancialEntities();
3481 * CRM-20008 Tests repeattransaction creates pending membership.
3483 public function testRepeatTransactionPendingMembership() {
3484 list($originalContribution, $membership) = $this->setUpAutoRenewMembership();
3485 $this->callAPISuccess('membership', 'create', array(
3486 'id' => $membership['id'],
3487 'end_date' => 'yesterday',
3488 'status_id' => 'Expired',
3490 $repeatedContribution = $this->callAPISuccess('contribution', 'repeattransaction', array(
3491 'contribution_recur_id' => $originalContribution['values'][1]['contribution_recur_id'],
3492 'contribution_status_id' => 'Pending',
3493 'trxn_id' => uniqid(),
3495 $membershipStatusId = $this->callAPISuccess('membership', 'getvalue', array(
3496 'id' => $membership['id'],
3497 'return' => 'status_id',
3500 // Let's see if the membership payments got created while we're at it.
3501 $membershipPayments = $this->callAPISuccess('MembershipPayment', 'get', array(
3502 'memberhip_id' => $membership['id'],
3504 $this->assertEquals(2, $membershipPayments['count']);
3506 $this->assertEquals('Expired', CRM_Core_PseudoConstant
::getLabel('CRM_Member_BAO_Membership', 'status_id', $membershipStatusId));
3507 $this->callAPISuccess('Contribution', 'completetransaction', array('id' => $repeatedContribution['id']));
3508 $membership = $this->callAPISuccessGetSingle('membership', array(
3509 'id' => $membership['id'],
3510 'return' => 'status_id, end_date',
3512 $this->assertEquals('New', CRM_Core_PseudoConstant
::getLabel('CRM_Member_BAO_Membership', 'status_id', $membership['status_id']));
3513 $this->assertEquals(date('Y-m-d', strtotime('yesterday + 1 month')), $membership['end_date']);
3515 $this->quickCleanUpFinancialEntities();
3516 $this->contactDelete($originalContribution['values'][1]['contact_id']);
3520 * Test sending a mail via the API.
3522 public function testSendMailWithAPISetFromDetails() {
3523 $mut = new CiviMailUtils($this, TRUE);
3524 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
3525 $this->callAPISuccess('contribution', 'sendconfirmation', array(
3526 'id' => $contribution['id'],
3527 'receipt_from_email' => 'api@civicrm.org',
3528 'receipt_from_name' => 'CiviCRM LLC',
3530 $mut->checkMailLog(array(
3531 'From: CiviCRM LLC <api@civicrm.org>',
3532 'Contribution Information',
3533 'Please print this confirmation for your records',
3542 * Test sending a mail via the API.
3544 public function testSendMailWithNoFromSetFallToDomain() {
3545 $this->createLoggedInUser();
3546 $mut = new CiviMailUtils($this, TRUE);
3547 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
3548 $this->callAPISuccess('contribution', 'sendconfirmation', array(
3549 'id' => $contribution['id'],
3551 $domain = $this->callAPISuccess('domain', 'getsingle', array('id' => 1));
3552 $mut->checkMailLog(array(
3553 'From: ' . $domain['from_name'] . ' <' . $domain['from_email'] . '>',
3554 'Contribution Information',
3555 'Please print this confirmation for your records',
3564 * Test sending a mail via the API.
3566 public function testSendMailWithRepeatTransactionAPIFalltoDomain() {
3567 $this->createLoggedInUser();
3568 $mut = new CiviMailUtils($this, TRUE);
3569 $contribution = $this->setUpRepeatTransaction(array(), 'single');
3570 $this->callAPISuccess('contribution', 'repeattransaction', array(
3571 'contribution_status_id' => 'Completed',
3572 'trxn_id' => uniqid(),
3573 'original_contribution_id' => $contribution,
3575 $domain = $this->callAPISuccess('domain', 'getsingle', array('id' => 1));
3576 $mut->checkMailLog(array(
3577 'From: ' . $domain['from_name'] . ' <' . $domain['from_email'] . '>',
3578 'Contribution Information',
3579 'Please print this confirmation for your records',
3588 * Test sending a mail via the API.
3590 public function testSendMailWithRepeatTransactionAPIFalltoContributionPage() {
3591 $mut = new CiviMailUtils($this, TRUE);
3592 $contributionPage = $this->contributionPageCreate(array('receipt_from_name' => 'CiviCRM LLC', 'receipt_from_email' => 'contributionpage@civicrm.org', 'is_email_receipt' => 1));
3593 $paymentProcessorID = $this->paymentProcessorCreate();
3594 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array(
3595 'contact_id' => $this->_individualId
,
3596 'installments' => '12',
3597 'frequency_interval' => '1',
3599 'contribution_status_id' => 1,
3600 'start_date' => '2012-01-01 00:00:00',
3601 'currency' => 'USD',
3602 'frequency_unit' => 'month',
3603 'payment_processor_id' => $paymentProcessorID,
3605 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3608 'contribution_recur_id' => $contributionRecur['id'],
3609 'contribution_page_id' => $contributionPage['id']))
3611 $this->callAPISuccess('contribution', 'repeattransaction', array(
3612 'contribution_status_id' => 'Completed',
3613 'trxn_id' => uniqid(),
3614 'original_contribution_id' => $originalContribution,
3617 $mut->checkMailLog(array(
3618 'From: CiviCRM LLC <contributionpage@civicrm.org>',
3619 'Contribution Information',
3620 'Please print this confirmation for your records',
3629 * Test sending a mail via the API.
3631 public function testSendMailWithRepeatTransactionAPIFalltoSystemFromNoDefaultFrom() {
3632 $mut = new CiviMailUtils($this, TRUE);
3633 $originalContribution = $contribution = $this->setUpRepeatTransaction(array(), 'single');
3634 $fromEmail = $this->CallAPISuccess('optionValue', 'get', array('is_default' => 1, 'option_group_id' => 'from_email_address', 'sequential' => 1));
3635 foreach ($fromEmail['values'] as $from) {
3636 $this->callAPISuccess('optionValue', 'create', array('is_default' => 0, 'id' => $from['id']));
3638 $domain = $this->callAPISuccess('domain', 'getsingle', array('id' => CRM_Core_Config
::domainID()));
3639 $this->callAPISuccess('contribution', 'repeattransaction', array(
3640 'contribution_status_id' => 'Completed',
3641 'trxn_id' => uniqid(),
3642 'original_contribution_id' => $originalContribution,
3645 $mut->checkMailLog(array(
3646 'From: ' . $domain['name'] . ' <' . $domain['domain_email'] . '>',
3647 'Contribution Information',
3648 'Please print this confirmation for your records',
3657 * Create a Contribution Page with is_email_receipt = TRUE.
3659 * @param array $params
3660 * Params to overwrite with.
3664 protected function createReceiptableContributionPage($params = array()) {
3665 $contributionPage = $this->callAPISuccess('ContributionPage', 'create', array_merge(array(
3666 'receipt_from_name' => 'Mickey Mouse',
3667 'receipt_from_email' => 'mickey@mouse.com',
3668 'title' => "Test Contribution Page",
3669 'financial_type_id' => 1,
3670 'currency' => 'CAD',
3671 'is_monetary' => TRUE,
3672 'is_email_receipt' => TRUE,
3674 return $contributionPage;
3678 * function to test card_type and pan truncation.
3680 public function testCardTypeAndPanTruncation() {
3681 $creditCardTypeIDs = array_flip(CRM_Financial_DAO_FinancialTrxn
::buildOptions('card_type_id'));
3682 $contactId = $this->individualCreate();
3684 'contact_id' => $contactId,
3685 'receive_date' => '2016-01-20',
3686 'total_amount' => 100,
3687 'financial_type_id' => 1,
3688 'payment_instrument' => 'Credit Card',
3689 'card_type_id' => $creditCardTypeIDs['Visa'],
3690 'pan_truncation' => 4567,
3692 $contribution = $this->callAPISuccess('contribution', 'create', $params);
3693 $lastFinancialTrxnId = CRM_Core_BAO_FinancialTrxn
::getFinancialTrxnId($contribution['id'], 'DESC');
3694 $financialTrxn = $this->callAPISuccessGetSingle(
3697 'id' => $lastFinancialTrxnId['financialTrxnId'],
3698 'return' => array('card_type_id', 'pan_truncation'),
3701 $this->assertEquals(CRM_Utils_Array
::value('card_type_id', $financialTrxn), $creditCardTypeIDs['Visa']);
3702 $this->assertEquals(CRM_Utils_Array
::value('pan_truncation', $financialTrxn), 4567);
3704 'id' => $contribution['id'],
3705 'pan_truncation' => 2345,
3706 'card_type_id' => $creditCardTypeIDs['Amex'],
3708 $contribution = $this->callAPISuccess('contribution', 'create', $params);
3709 $financialTrxn = $this->callAPISuccessGetSingle(
3712 'id' => $lastFinancialTrxnId['financialTrxnId'],
3713 'return' => array('card_type_id', 'pan_truncation'),
3716 $this->assertEquals(CRM_Utils_Array
::value('card_type_id', $financialTrxn), $creditCardTypeIDs['Amex']);
3717 $this->assertEquals(CRM_Utils_Array
::value('pan_truncation', $financialTrxn), 2345);