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->_individualId
= $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);
2719 //Assert only three activities are created.
2720 $activities = CRM_Activity_BAO_Activity
::getContactActivity($this->_individualId
);
2721 $this->assertEquals(3, count($activities));
2722 $activityNames = array_count_values(CRM_Utils_Array
::collect('activity_name', $activities));
2723 // record two activities before and after completing payment for Event registration
2724 $this->assertEquals(2, $activityNames['Event Registration']);
2725 // update the original 'Contribution' activity created after completing payment
2726 $this->assertEquals(1, $activityNames['Contribution']);
2728 $mut->checkMailLog(array(
2729 'Annual CiviCRM meet',
2731 'This letter is a confirmation that your registration has been received and your status has been updated to Registered.',
2737 * Test membership is renewed when transaction completed.
2739 public function testCompleteTransactionMembershipPriceSet() {
2740 $this->createPriceSetWithPage('membership');
2741 $stateOfGrace = $this->callAPISuccess('MembershipStatus', 'getvalue', array(
2745 $this->setUpPendingContribution($this->_ids
['price_field_value'][0]);
2746 $membership = $this->callAPISuccess('membership', 'getsingle', array('id' => $this->_ids
['membership']));
2747 $logs = $this->callAPISuccess('MembershipLog', 'get', array(
2748 'membership_id' => $this->_ids
['membership'],
2750 $this->assertEquals(1, $logs['count']);
2751 $this->assertEquals($stateOfGrace, $membership['status_id']);
2752 $this->callAPISuccess('contribution', 'completetransaction', array('id' => $this->_ids
['contribution']));
2753 $membership = $this->callAPISuccess('membership', 'getsingle', array('id' => $this->_ids
['membership']));
2754 $this->assertEquals(date('Y-m-d', strtotime('yesterday + 1 year')), $membership['end_date']);
2755 $this->callAPISuccessGetSingle('LineItem', array(
2756 'entity_id' => $this->_ids
['membership'],
2757 'entity_table' => 'civicrm_membership',
2759 $logs = $this->callAPISuccess('MembershipLog', 'get', array(
2760 'membership_id' => $this->_ids
['membership'],
2762 $this->assertEquals(2, $logs['count']);
2763 $this->assertNotEquals($stateOfGrace, $logs['values'][2]['status_id']);
2764 //Assert only three activities are created.
2765 $activities = CRM_Activity_BAO_Activity
::getContactActivity($this->_ids
['contact']);
2766 $this->assertEquals(3, count($activities));
2767 $activityNames = array_flip(CRM_Utils_Array
::collect('activity_name', $activities));
2768 $this->assertArrayHasKey('Contribution', $activityNames);
2769 $this->assertArrayHasKey('Membership Signup', $activityNames);
2770 $this->assertArrayHasKey('Change Membership Status', $activityNames);
2771 $this->cleanUpAfterPriceSets();
2775 * Test if renewal activity is create after changing Pending contribution to Completed via offline
2777 public function testPendingToCompleteContribution() {
2778 $contributionPage = $this->createPriceSetWithPage('membership');
2779 $stateOfGrace = $this->callAPISuccess('MembershipStatus', 'getvalue', array(
2783 $this->setUpPendingContribution($this->_ids
['price_field_value'][0]);
2784 $this->callAPISuccess('membership', 'getsingle', array('id' => $this->_ids
['membership']));
2785 // Case 1: Assert that Membership Signup Activity is created on Pending to Completed Contribution via backoffice
2786 $activity = $this->callAPISuccess('Activity', 'get', array(
2787 'activity_type_id' => 'Membership Signup',
2788 'source_record_id' => $this->_ids
['membership'],
2789 'status_id' => 'Scheduled',
2791 $this->assertEquals(1, $activity['count']);
2793 // change pending contribution to completed
2794 $form = new CRM_Contribute_Form_Contribution();
2796 $form->_params
= array(
2797 'id' => $this->_ids
['contribution'],
2798 'total_amount' => 20,
2801 'financial_type_id' => 1,
2802 'receive_date' => '04/21/2015',
2803 'receive_date_time' => '11:27PM',
2804 'contact_id' => $this->_individualId
,
2805 'contribution_status_id' => 1,
2806 'billing_middle_name' => '',
2807 'billing_last_name' => 'Adams',
2808 'billing_street_address-5' => '790L Lincoln St S',
2809 'billing_city-5' => 'Maryknoll',
2810 'billing_state_province_id-5' => 1031,
2811 'billing_postal_code-5' => 10545,
2812 'billing_country_id-5' => 1228,
2813 'frequency_interval' => 1,
2814 'frequency_unit' => 'month',
2815 'installments' => '',
2816 'hidden_AdditionalDetail' => 1,
2817 'hidden_Premium' => 1,
2818 'from_email_address' => '"civi45" <civi45@civicrm.com>',
2819 'receipt_date' => '',
2820 'receipt_date_time' => '',
2821 'payment_processor_id' => $this->paymentProcessorID
,
2822 'currency' => 'USD',
2823 'contribution_page_id' => $this->_ids
['contribution_page'],
2824 'contribution_mode' => 'membership',
2825 'source' => 'Membership Signup and Renewal',
2828 $form->testSubmit($form->_params
, CRM_Core_Action
::UPDATE
);
2830 catch (Civi\Payment\Exception\PaymentProcessorException
$e) {
2833 // Case 2: After successful payment for Pending backoffice there are three activities created
2834 // 2.a Update status of existing Scheduled Membership Signup (created in step 1) to Completed
2835 $activity = $this->callAPISuccess('Activity', 'get', array(
2836 'activity_type_id' => 'Membership Signup',
2837 'source_record_id' => $this->_ids
['membership'],
2838 'status_id' => 'Completed',
2840 $this->assertEquals(1, $activity['count']);
2841 // 2.b Contribution activity created to record successful payment
2842 $activity = $this->callAPISuccess('Activity', 'get', array(
2843 'activity_type_id' => 'Contribution',
2844 'source_record_id' => $this->_ids
['contribution'],
2845 'status_id' => 'Completed',
2847 $this->assertEquals(1, $activity['count']);
2849 // 2.c 'Change membership type' activity created to record Membership status change from Grace to Current
2850 $activity = $this->callAPISuccess('Activity', 'get', array(
2851 'activity_type_id' => 'Change Membership Status',
2852 'source_record_id' => $this->_ids
['membership'],
2853 'status_id' => 'Completed',
2855 $this->assertEquals(1, $activity['count']);
2856 $this->assertEquals('Status changed from Grace to Current', $activity['values'][$activity['id']]['subject']);
2858 //Create another pending contribution for renewal
2859 $contribution = $this->callAPISuccess('contribution', 'create', array(
2861 'contact_id' => $this->_ids
['contact'],
2862 'receive_date' => date('Ymd'),
2863 'total_amount' => 20.00,
2864 'financial_type_id' => 1,
2865 'payment_instrument_id' => 'Credit Card',
2866 'non_deductible_amount' => 10.00,
2867 'trxn_id' => 'rdhfi88',
2868 'invoice_id' => 'dofhiewuyr',
2870 'contribution_status_id' => 2,
2871 'contribution_page_id' => $this->_ids
['contribution_page'],
2872 'api.membership_payment.create' => array('membership_id' => $this->_ids
['membership']),
2875 $this->callAPISuccess('line_item', 'create', array(
2876 'entity_id' => $contribution['id'],
2877 'entity_table' => 'civicrm_contribution',
2878 'contribution_id' => $contribution['id'],
2879 'price_field_id' => $this->_ids
['price_field'][0],
2883 'financial_type_id' => 1,
2884 'price_field_value_id' => $this->_ids
['price_field_value'][0],
2887 //Update it to Failed.
2888 $form->_params
['id'] = $contribution['id'];
2889 $form->_params
['contribution_status_id'] = 4;
2891 $form->testSubmit($form->_params
, CRM_Core_Action
::UPDATE
);
2893 catch (Civi\Payment\Exception\PaymentProcessorException
$e) {
2896 //Existing membership should not get updated to expired.
2897 $membership = $this->callAPISuccess('membership', 'getsingle', array('id' => $this->_ids
['membership']));
2898 $this->assertNotEquals($membership['status_id'], 4);
2902 * Test membership is renewed when transaction completed.
2904 public function testCompleteTransactionMembershipPriceSetTwoTerms() {
2905 $this->createPriceSetWithPage('membership');
2906 $this->setUpPendingContribution($this->_ids
['price_field_value'][1]);
2907 $this->callAPISuccess('contribution', 'completetransaction', array('id' => $this->_ids
['contribution']));
2908 $membership = $this->callAPISuccess('membership', 'getsingle', array('id' => $this->_ids
['membership']));
2909 $this->assertEquals(date('Y-m-d', strtotime('yesterday + 2 years')), $membership['end_date']);
2910 $this->cleanUpAfterPriceSets();
2913 public function cleanUpAfterPriceSets() {
2914 $this->quickCleanUpFinancialEntities();
2915 $this->contactDelete($this->_ids
['contact']);
2919 * Set up a pending transaction with a specific price field id.
2921 * @param int $priceFieldValueID
2923 public function setUpPendingContribution($priceFieldValueID, $contriParams = array()) {
2924 $contactID = $this->individualCreate();
2925 $membership = $this->callAPISuccess('membership', 'create', array(
2926 'contact_id' => $contactID,
2927 'membership_type_id' => $this->_ids
['membership_type'],
2928 'start_date' => 'yesterday - 1 year',
2929 'end_date' => 'yesterday',
2930 'join_date' => 'yesterday - 1 year',
2932 $contribution = $this->callAPISuccess('contribution', 'create', array_merge(array(
2934 'contact_id' => $contactID,
2935 'receive_date' => date('Ymd'),
2936 'total_amount' => 20.00,
2937 'financial_type_id' => 1,
2938 'payment_instrument_id' => 'Credit Card',
2939 'non_deductible_amount' => 10.00,
2940 'trxn_id' => 'jdhfi' . rand(1, 100),
2941 'invoice_id' => 'djfhiew' . rand(5, 100),
2943 'contribution_status_id' => 2,
2944 'contribution_page_id' => $this->_ids
['contribution_page'],
2945 'api.membership_payment.create' => array('membership_id' => $membership['id']),
2948 $this->callAPISuccess('line_item', 'create', array(
2949 'entity_id' => $contribution['id'],
2950 'entity_table' => 'civicrm_contribution',
2951 'contribution_id' => $contribution['id'],
2952 'price_field_id' => $this->_ids
['price_field'][0],
2956 'financial_type_id' => 1,
2957 'price_field_value_id' => $priceFieldValueID,
2959 $this->_ids
['contact'] = $contactID;
2960 $this->_ids
['contribution'] = $contribution['id'];
2961 $this->_ids
['membership'] = $membership['id'];
2965 * Test sending a mail via the API.
2967 public function testSendMail() {
2968 $mut = new CiviMailUtils($this, TRUE);
2969 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
2970 $this->callAPISuccess('contribution', 'sendconfirmation', array(
2971 'id' => $contribution['id'],
2972 'receipt_from_email' => 'api@civicrm.org',
2975 $mut->checkMailLog(array(
2977 'Contribution Information',
2978 'Please print this confirmation for your records',
2984 $this->checkCreditCardDetails($mut, $contribution['id']);
2989 * Check credit card details in sent mail via API
2991 * @param $mut obj CiviMailUtils instance
2992 * @param int $contributionID Contribution ID
2995 public function checkCreditCardDetails($mut, $contributionID) {
2996 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
2997 $this->callAPISuccess('contribution', 'sendconfirmation', array(
2998 'id' => $contributionID,
2999 'receipt_from_email' => 'api@civicrm.org',
3000 'payment_processor_id' => $this->paymentProcessorID
,
3003 $mut->checkMailLog(array(
3004 'Credit Card Information', // credit card header
3005 'Billing Name and Address', // billing header
3006 'anthony_anderson@civicrm.org', // billing name
3014 * Test sending a mail via the API.
3016 public function testSendMailEvent() {
3017 $mut = new CiviMailUtils($this, TRUE);
3018 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
3019 $event = $this->eventCreate(array(
3020 'is_email_confirm' => 1,
3021 'confirm_from_email' => 'test@civicrm.org',
3023 $this->_eventID
= $event['id'];
3024 $participantParams = array(
3025 'contact_id' => $this->_individualId
,
3026 'event_id' => $this->_eventID
,
3029 // to ensure it matches later on
3030 'register_date' => '2007-07-21 00:00:00',
3031 'source' => 'Online Event Registration: API Testing',
3034 $participant = $this->callAPISuccess('participant', 'create', $participantParams);
3035 $this->callAPISuccess('participant_payment', 'create', array(
3036 'participant_id' => $participant['id'],
3037 'contribution_id' => $contribution['id'],
3039 $this->callAPISuccess('contribution', 'sendconfirmation', array(
3040 'id' => $contribution['id'],
3041 'receipt_from_email' => 'api@civicrm.org',
3045 $mut->checkMailLog(array(
3046 'Annual CiviCRM meet',
3048 'To: "Mr. Anthony Anderson II" <anthony_anderson@civicrm.org>',
3055 * This function does a GET & compares the result against the $params.
3057 * Use as a double check on Creates.
3059 * @param array $params
3061 * @param bool $delete
3063 public function contributionGetnCheck($params, $id, $delete = TRUE) {
3065 $contribution = $this->callAPISuccess('Contribution', 'Get', array(
3071 $this->callAPISuccess('contribution', 'delete', array('id' => $id));
3073 $this->assertAPISuccess($contribution, 0);
3074 $values = $contribution['values'][$contribution['id']];
3075 $params['receive_date'] = date('Y-m-d H:i:s', strtotime($params['receive_date']));
3076 // this is not returned in id format
3077 unset($params['payment_instrument_id']);
3078 $params['contribution_source'] = $params['source'];
3079 unset($params['source']);
3080 foreach ($params as $key => $value) {
3081 $this->assertEquals($value, $values[$key], $key . " value: $value doesn't match " . print_r($values, TRUE));
3086 * Create a pending contribution & linked pending pledge record.
3088 public function createPendingPledgeContribution() {
3090 $pledgeID = $this->pledgeCreate(array('contact_id' => $this->_individualId
, 'installments' => 1, 'amount' => 500));
3091 $this->_ids
['pledge'] = $pledgeID;
3092 $contribution = $this->callAPISuccess('contribution', 'create', array_merge($this->_params
, array(
3093 'contribution_status_id' => 'Pending',
3094 'total_amount' => 500,
3097 $paymentID = $this->callAPISuccessGetValue('PledgePayment', array(
3098 'options' => array('limit' => 1),
3101 $this->callAPISuccess('PledgePayment', 'create', array(
3103 'contribution_id' =>
3104 $contribution['id'],
3105 'status_id' => 'Pending',
3106 'scheduled_amount' => 500,
3109 return $contribution['id'];
3113 * Create a pending contribution & linked pending participant record (along with an event).
3115 public function createPendingParticipantContribution() {
3116 $event = $this->eventCreate(array('is_email_confirm' => 1, 'confirm_from_email' => 'test@civicrm.org'));
3117 $participantID = $this->participantCreate(array('event_id' => $event['id'], 'status_id' => 6, 'contact_id' => $this->_individualId
));
3118 $this->_ids
['participant'] = $participantID;
3119 $params = array_merge($this->_params
, array('contact_id' => $this->_individualId
, 'contribution_status_id' => 2, 'financial_type_id' => 'Event Fee'));
3120 $contribution = $this->callAPISuccess('contribution', 'create', $params);
3121 $this->callAPISuccess('participant_payment', 'create', array(
3122 'contribution_id' => $contribution['id'],
3123 'participant_id' => $participantID,
3125 $this->callAPISuccess('line_item', 'get', array(
3126 'entity_id' => $contribution['id'],
3127 'entity_table' => 'civicrm_contribution',
3128 'api.line_item.create' => array(
3129 'entity_id' => $participantID,
3130 'entity_table' => 'civicrm_participant',
3133 return $contribution['id'];
3137 * Get financial transaction amount.
3139 * @param int $contId
3141 * @return null|string
3143 public function _getFinancialTrxnAmount($contId) {
3145 SUM( ft.total_amount ) AS total
3146 FROM civicrm_financial_trxn AS ft
3147 LEFT JOIN civicrm_entity_financial_trxn AS ceft ON ft.id = ceft.financial_trxn_id
3148 WHERE ceft.entity_table = 'civicrm_contribution'
3149 AND ceft.entity_id = {$contId}";
3151 $result = CRM_Core_DAO
::singleValueQuery($query);
3156 * @param int $contId
3158 * @return null|string
3160 public function _getFinancialItemAmount($contId) {
3161 $lineItem = key(CRM_Price_BAO_LineItem
::getLineItems($contId, 'contribution'));
3164 FROM civicrm_financial_item
3165 WHERE entity_table = 'civicrm_line_item'
3166 AND entity_id = {$lineItem}";
3167 $result = CRM_Core_DAO
::singleValueQuery($query);
3172 * @param int $contId
3175 public function _checkFinancialItem($contId, $context) {
3176 if ($context != 'paylater') {
3178 'entity_id' => $contId,
3179 'entity_table' => 'civicrm_contribution',
3181 $trxn = current(CRM_Financial_BAO_FinancialItem
::retrieveEntityFinancialTrxn($params, TRUE));
3182 $entityParams = array(
3183 'financial_trxn_id' => $trxn['financial_trxn_id'],
3184 'entity_table' => 'civicrm_financial_item',
3186 $entityTrxn = current(CRM_Financial_BAO_FinancialItem
::retrieveEntityFinancialTrxn($entityParams));
3188 'id' => $entityTrxn['entity_id'],
3191 if ($context == 'paylater') {
3192 $lineItems = CRM_Price_BAO_LineItem
::getLineItems($contId, 'contribution');
3193 foreach ($lineItems as $key => $item) {
3195 'entity_id' => $key,
3196 'entity_table' => 'civicrm_line_item',
3198 $compareParams = array('status_id' => 1);
3199 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialItem', $params, $compareParams);
3202 elseif ($context == 'refund') {
3203 $compareParams = array(
3205 'financial_account_id' => 1,
3209 elseif ($context == 'cancelPending') {
3210 $compareParams = array(
3212 'financial_account_id' => 1,
3216 elseif ($context == 'changeFinancial') {
3217 $lineKey = key(CRM_Price_BAO_LineItem
::getLineItems($contId, 'contribution'));
3219 'entity_id' => $lineKey,
3222 $compareParams = array(
3223 'financial_account_id' => 1,
3225 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialItem', $params, $compareParams);
3227 'financial_account_id' => 3,
3228 'entity_id' => $lineKey,
3230 $compareParams = array(
3234 if ($context != 'paylater') {
3235 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialItem', $params, $compareParams);
3240 * Check financial transaction.
3242 * @todo break this down into sensible functions - most calls to it only use a few lines out of the big if.
3244 * @param array $contribution
3245 * @param string $context
3246 * @param int $instrumentId
3247 * @param array $extraParams
3249 public function _checkFinancialTrxn($contribution, $context, $instrumentId = NULL, $extraParams = array()) {
3250 $trxnParams = array(
3251 'entity_id' => $contribution['id'],
3252 'entity_table' => 'civicrm_contribution',
3254 $trxn = current(CRM_Financial_BAO_FinancialItem
::retrieveEntityFinancialTrxn($trxnParams, TRUE));
3256 'id' => $trxn['financial_trxn_id'],
3258 if ($context == 'payLater') {
3259 $compareParams = array(
3261 'from_financial_account_id' => CRM_Contribute_PseudoConstant
::getRelationalFinancialAccount($contribution['financial_type_id'], 'Accounts Receivable Account is'),
3264 elseif ($context == 'refund') {
3265 $compareParams = array(
3266 'to_financial_account_id' => 6,
3267 'total_amount' => -100,
3269 'trxn_date' => '2015-01-01 09:00:00',
3270 'trxn_id' => 'the refund',
3273 elseif ($context == 'cancelPending') {
3274 $compareParams = array(
3275 'to_financial_account_id' => 7,
3276 'total_amount' => -100,
3280 elseif ($context == 'changeFinancial' ||
$context == 'paymentInstrument') {
3281 $entityParams = array(
3282 'entity_id' => $contribution['id'],
3283 'entity_table' => 'civicrm_contribution',
3286 $trxn = current(CRM_Financial_BAO_FinancialItem
::retrieveEntityFinancialTrxn($entityParams));
3287 $trxnParams1 = array(
3288 'id' => $trxn['financial_trxn_id'],
3290 if (empty($extraParams)) {
3291 $compareParams = array(
3292 'total_amount' => -100,
3297 $compareParams = array(
3298 'total_amount' => 100,
3302 if ($context == 'paymentInstrument') {
3303 $compareParams +
= array(
3304 'to_financial_account_id' => CRM_Financial_BAO_FinancialTypeAccount
::getInstrumentFinancialAccount(4),
3305 'payment_instrument_id' => 4,
3309 $compareParams['to_financial_account_id'] = 12;
3311 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialTrxn', $trxnParams1, array_merge($compareParams, $extraParams));
3312 $compareParams['total_amount'] = 100;
3313 if ($context == 'paymentInstrument') {
3314 $compareParams['to_financial_account_id'] = CRM_Financial_BAO_FinancialTypeAccount
::getInstrumentFinancialAccount($instrumentId);
3315 $compareParams['payment_instrument_id'] = $instrumentId;
3318 $compareParams['to_financial_account_id'] = 12;
3322 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialTrxn', $params, array_merge($compareParams, $extraParams));
3328 public function _addPaymentInstrument() {
3329 $gId = CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_OptionGroup', 'payment_instrument', 'id', 'name');
3330 $optionParams = array(
3331 'option_group_id' => $gId,
3332 'label' => 'Test Card',
3333 'name' => 'Test Card',
3338 $optionValue = $this->callAPISuccess('option_value', 'create', $optionParams);
3339 $relationTypeId = key(CRM_Core_PseudoConstant
::accountOptionValues('account_relationship', NULL, " AND v.name LIKE 'Asset Account is' "));
3340 $financialParams = array(
3341 'entity_table' => 'civicrm_option_value',
3342 'entity_id' => $optionValue['id'],
3343 'account_relationship' => $relationTypeId,
3344 'financial_account_id' => 7,
3346 CRM_Financial_BAO_FinancialTypeAccount
::add($financialParams, CRM_Core_DAO
::$_nullArray);
3347 $this->assertNotEmpty($optionValue['values'][$optionValue['id']]['value']);
3348 return $optionValue['values'][$optionValue['id']]['value'];
3352 * Set up the basic recurring contribution for tests.
3354 * @param array $generalParams
3355 * Parameters that can be merged into the recurring AND the contribution.
3357 * @param array $recurParams
3358 * Parameters to merge into the recur only.
3362 protected function setUpRecurringContribution($generalParams = array(), $recurParams = array()) {
3363 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array_merge(array(
3364 'contact_id' => $this->_individualId
,
3365 'installments' => '12',
3366 'frequency_interval' => '1',
3368 'contribution_status_id' => 1,
3369 'start_date' => '2012-01-01 00:00:00',
3370 'currency' => 'USD',
3371 'frequency_unit' => 'month',
3372 'payment_processor_id' => $this->paymentProcessorID
,
3373 ), $generalParams, $recurParams));
3374 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3377 'contribution_recur_id' => $contributionRecur['id'],
3380 return $originalContribution;
3384 * Set up a basic auto-renew membership for tests.
3386 * @param array $generalParams
3387 * Parameters that can be merged into the recurring AND the contribution.
3389 * @param array $recurParams
3390 * Parameters to merge into the recur only.
3394 protected function setUpAutoRenewMembership($generalParams = array(), $recurParams = array()) {
3395 $newContact = $this->callAPISuccess('Contact', 'create', array(
3396 'contact_type' => 'Individual',
3397 'sort_name' => 'McTesterson, Testy',
3398 'display_name' => 'Testy McTesterson',
3399 'preferred_language' => 'en_US',
3400 'preferred_mail_format' => 'Both',
3401 'first_name' => 'Testy',
3402 'last_name' => 'McTesterson',
3403 'contact_is_deleted' => '0',
3405 'email' => 'tmctesterson@example.com',
3408 $membershipType = $this->callAPISuccess('MembershipType', 'create', array(
3409 'domain_id' => "Default Domain Name",
3410 'member_of_contact_id' => 1,
3411 'financial_type_id' => "Member Dues",
3412 'duration_unit' => "month",
3413 'duration_interval' => 1,
3414 'period_type' => 'rolling',
3415 'name' => "Standard Member",
3416 'minimum_fee' => 100,
3418 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array_merge(array(
3419 'contact_id' => $newContact['id'],
3420 'installments' => '12',
3421 'frequency_interval' => '1',
3423 'contribution_status_id' => 1,
3424 'start_date' => '2012-01-01 00:00:00',
3425 'currency' => 'USD',
3426 'frequency_unit' => 'month',
3427 'payment_processor_id' => $this->paymentProcessorID
,
3428 ), $generalParams, $recurParams));
3430 $membership = $this->callAPISuccess('membership', 'create', array(
3431 'contact_id' => $newContact['id'],
3432 'contribution_recur_id' => $contributionRecur['id'],
3433 'financial_type_id' => "Member Dues",
3434 'membership_type_id' => $membershipType['id'],
3436 'skipLineItem' => TRUE,
3439 CRM_Price_BAO_LineItem
::getLineItemArray($this->_params
, NULL, 'membership', $membershipType['id']);
3440 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3443 'contact_id' => $newContact['id'],
3444 'contribution_recur_id' => $contributionRecur['id'],
3445 'financial_type_id' => "Member Dues",
3446 'contribution_status_id' => 1,
3447 'invoice_id' => uniqid(),
3450 $lineItem = $this->callAPISuccess('LineItem', 'getsingle', array());
3451 $this->assertEquals('civicrm_membership', $lineItem['entity_table']);
3452 $membership = $this->callAPISuccess('Membership', 'getsingle', array('id' => $lineItem['entity_id']));
3453 $this->callAPISuccess('LineItem', 'getsingle', array());
3454 $this->callAPISuccessGetCount('MembershipPayment', array('membership_id' => $membership['id']), 1);
3456 return array($originalContribution, $membership);
3459 * Set up a repeat transaction.
3461 * @param array $recurParams
3465 protected function setUpRepeatTransaction($recurParams = array(), $flag) {
3466 $paymentProcessorID = $this->paymentProcessorCreate();
3467 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array_merge(array(
3468 'contact_id' => $this->_individualId
,
3469 'installments' => '12',
3470 'frequency_interval' => '1',
3472 'contribution_status_id' => 1,
3473 'start_date' => '2012-01-01 00:00:00',
3474 'currency' => 'USD',
3475 'frequency_unit' => 'month',
3476 'payment_processor_id' => $paymentProcessorID,
3479 $originalContribution = '';
3480 if ($flag == 'multiple') {
3481 // CRM-19309 create a contribution + also add in line_items (plural):
3482 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3485 'contribution_recur_id' => $contributionRecur['id'],
3486 'skipLineItem' => 1,
3487 'api.line_item.create' => array(
3489 'price_field_id' => 1,
3491 'line_total' => '20',
3492 'unit_price' => '10',
3493 'financial_type_id' => 1,
3496 'price_field_id' => 1,
3498 'line_total' => '80',
3499 'unit_price' => '80',
3500 'financial_type_id' => 2,
3507 elseif ($flag == 'single') {
3508 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3510 array('contribution_recur_id' => $contributionRecur['id']))
3513 $originalContribution['payment_processor_id'] = $paymentProcessorID;
3514 return $originalContribution;
3518 * Common set up routine.
3522 protected function setUpForCompleteTransaction() {
3523 $this->mut
= new CiviMailUtils($this, TRUE);
3524 $this->createLoggedInUser();
3525 $params = array_merge($this->_params
, array('contribution_status_id' => 2, 'receipt_date' => 'now'));
3526 $contribution = $this->callAPISuccess('contribution', 'create', $params);
3527 return $contribution;
3531 * Test repeat contribution uses the Payment Processor' payment_instrument setting.
3533 public function testRepeatTransactionWithNonCreditCardDefault() {
3534 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array(
3535 'contact_id' => $this->_individualId
,
3536 'installments' => '12',
3537 'frequency_interval' => '1',
3539 'contribution_status_id' => 1,
3540 'start_date' => '2012-01-01 00:00:00',
3541 'currency' => 'USD',
3542 'frequency_unit' => 'month',
3543 'payment_processor_id' => $this->paymentProcessorID
,
3545 $contribution1 = $this->callAPISuccess('contribution', 'create', array_merge(
3547 array('contribution_recur_id' => $contributionRecur['id'], 'payment_instrument_id' => 2))
3549 $paymentInstruments = CRM_Contribute_PseudoConstant
::paymentInstrument('name');
3550 $contribution2 = $this->callAPISuccess('contribution', 'repeattransaction', array(
3551 'contribution_status_id' => 'Completed',
3552 'trxn_id' => uniqid(),
3553 'original_contribution_id' => $contribution1,
3555 $this->assertEquals(array_search('Debit Card', $paymentInstruments), $contribution2['values'][$contribution2['id']]['payment_instrument_id']);
3556 $this->quickCleanUpFinancialEntities();
3560 * CRM-20008 Tests repeattransaction creates pending membership.
3562 public function testRepeatTransactionPendingMembership() {
3563 list($originalContribution, $membership) = $this->setUpAutoRenewMembership();
3564 $this->callAPISuccess('membership', 'create', array(
3565 'id' => $membership['id'],
3566 'end_date' => 'yesterday',
3567 'status_id' => 'Expired',
3569 $repeatedContribution = $this->callAPISuccess('contribution', 'repeattransaction', array(
3570 'contribution_recur_id' => $originalContribution['values'][1]['contribution_recur_id'],
3571 'contribution_status_id' => 'Pending',
3572 'trxn_id' => uniqid(),
3574 $membershipStatusId = $this->callAPISuccess('membership', 'getvalue', array(
3575 'id' => $membership['id'],
3576 'return' => 'status_id',
3579 // Let's see if the membership payments got created while we're at it.
3580 $membershipPayments = $this->callAPISuccess('MembershipPayment', 'get', array(
3581 'memberhip_id' => $membership['id'],
3583 $this->assertEquals(2, $membershipPayments['count']);
3585 $this->assertEquals('Expired', CRM_Core_PseudoConstant
::getLabel('CRM_Member_BAO_Membership', 'status_id', $membershipStatusId));
3586 $this->callAPISuccess('Contribution', 'completetransaction', array('id' => $repeatedContribution['id']));
3587 $membership = $this->callAPISuccessGetSingle('membership', array(
3588 'id' => $membership['id'],
3589 'return' => 'status_id, end_date',
3591 $this->assertEquals('New', CRM_Core_PseudoConstant
::getLabel('CRM_Member_BAO_Membership', 'status_id', $membership['status_id']));
3592 $this->assertEquals(date('Y-m-d', strtotime('yesterday + 1 month')), $membership['end_date']);
3594 $this->quickCleanUpFinancialEntities();
3595 $this->contactDelete($originalContribution['values'][1]['contact_id']);
3599 * Test sending a mail via the API.
3601 public function testSendMailWithAPISetFromDetails() {
3602 $mut = new CiviMailUtils($this, TRUE);
3603 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
3604 $this->callAPISuccess('contribution', 'sendconfirmation', array(
3605 'id' => $contribution['id'],
3606 'receipt_from_email' => 'api@civicrm.org',
3607 'receipt_from_name' => 'CiviCRM LLC',
3609 $mut->checkMailLog(array(
3610 'From: CiviCRM LLC <api@civicrm.org>',
3611 'Contribution Information',
3612 'Please print this confirmation for your records',
3621 * Test sending a mail via the API.
3623 public function testSendMailWithNoFromSetFallToDomain() {
3624 $this->createLoggedInUser();
3625 $mut = new CiviMailUtils($this, TRUE);
3626 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
3627 $this->callAPISuccess('contribution', 'sendconfirmation', array(
3628 'id' => $contribution['id'],
3630 $domain = $this->callAPISuccess('domain', 'getsingle', array('id' => 1));
3631 $mut->checkMailLog(array(
3632 'From: ' . $domain['from_name'] . ' <' . $domain['from_email'] . '>',
3633 'Contribution Information',
3634 'Please print this confirmation for your records',
3643 * Test sending a mail via the API.
3645 public function testSendMailWithRepeatTransactionAPIFalltoDomain() {
3646 $this->createLoggedInUser();
3647 $mut = new CiviMailUtils($this, TRUE);
3648 $contribution = $this->setUpRepeatTransaction(array(), 'single');
3649 $this->callAPISuccess('contribution', 'repeattransaction', array(
3650 'contribution_status_id' => 'Completed',
3651 'trxn_id' => uniqid(),
3652 'original_contribution_id' => $contribution,
3654 $domain = $this->callAPISuccess('domain', 'getsingle', array('id' => 1));
3655 $mut->checkMailLog(array(
3656 'From: ' . $domain['from_name'] . ' <' . $domain['from_email'] . '>',
3657 'Contribution Information',
3658 'Please print this confirmation for your records',
3667 * Test sending a mail via the API.
3669 public function testSendMailWithRepeatTransactionAPIFalltoContributionPage() {
3670 $mut = new CiviMailUtils($this, TRUE);
3671 $contributionPage = $this->contributionPageCreate(array('receipt_from_name' => 'CiviCRM LLC', 'receipt_from_email' => 'contributionpage@civicrm.org', 'is_email_receipt' => 1));
3672 $paymentProcessorID = $this->paymentProcessorCreate();
3673 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array(
3674 'contact_id' => $this->_individualId
,
3675 'installments' => '12',
3676 'frequency_interval' => '1',
3678 'contribution_status_id' => 1,
3679 'start_date' => '2012-01-01 00:00:00',
3680 'currency' => 'USD',
3681 'frequency_unit' => 'month',
3682 'payment_processor_id' => $paymentProcessorID,
3684 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3687 'contribution_recur_id' => $contributionRecur['id'],
3688 'contribution_page_id' => $contributionPage['id']))
3690 $this->callAPISuccess('contribution', 'repeattransaction', array(
3691 'contribution_status_id' => 'Completed',
3692 'trxn_id' => uniqid(),
3693 'original_contribution_id' => $originalContribution,
3696 $mut->checkMailLog(array(
3697 'From: CiviCRM LLC <contributionpage@civicrm.org>',
3698 'Contribution Information',
3699 'Please print this confirmation for your records',
3708 * Test sending a mail via the API.
3710 public function testSendMailWithRepeatTransactionAPIFalltoSystemFromNoDefaultFrom() {
3711 $mut = new CiviMailUtils($this, TRUE);
3712 $originalContribution = $contribution = $this->setUpRepeatTransaction(array(), 'single');
3713 $fromEmail = $this->CallAPISuccess('optionValue', 'get', array('is_default' => 1, 'option_group_id' => 'from_email_address', 'sequential' => 1));
3714 foreach ($fromEmail['values'] as $from) {
3715 $this->callAPISuccess('optionValue', 'create', array('is_default' => 0, 'id' => $from['id']));
3717 $domain = $this->callAPISuccess('domain', 'getsingle', array('id' => CRM_Core_Config
::domainID()));
3718 $this->callAPISuccess('contribution', 'repeattransaction', array(
3719 'contribution_status_id' => 'Completed',
3720 'trxn_id' => uniqid(),
3721 'original_contribution_id' => $originalContribution,
3724 $mut->checkMailLog(array(
3725 'From: ' . $domain['name'] . ' <' . $domain['domain_email'] . '>',
3726 'Contribution Information',
3727 'Please print this confirmation for your records',
3736 * Create a Contribution Page with is_email_receipt = TRUE.
3738 * @param array $params
3739 * Params to overwrite with.
3743 protected function createReceiptableContributionPage($params = array()) {
3744 $contributionPage = $this->callAPISuccess('ContributionPage', 'create', array_merge(array(
3745 'receipt_from_name' => 'Mickey Mouse',
3746 'receipt_from_email' => 'mickey@mouse.com',
3747 'title' => "Test Contribution Page",
3748 'financial_type_id' => 1,
3749 'currency' => 'CAD',
3750 'is_monetary' => TRUE,
3751 'is_email_receipt' => TRUE,
3753 return $contributionPage;
3757 * function to test card_type and pan truncation.
3759 public function testCardTypeAndPanTruncation() {
3760 $creditCardTypeIDs = array_flip(CRM_Financial_DAO_FinancialTrxn
::buildOptions('card_type_id'));
3761 $contactId = $this->individualCreate();
3763 'contact_id' => $contactId,
3764 'receive_date' => '2016-01-20',
3765 'total_amount' => 100,
3766 'financial_type_id' => 1,
3767 'payment_instrument' => 'Credit Card',
3768 'card_type_id' => $creditCardTypeIDs['Visa'],
3769 'pan_truncation' => 4567,
3771 $contribution = $this->callAPISuccess('contribution', 'create', $params);
3772 $lastFinancialTrxnId = CRM_Core_BAO_FinancialTrxn
::getFinancialTrxnId($contribution['id'], 'DESC');
3773 $financialTrxn = $this->callAPISuccessGetSingle(
3776 'id' => $lastFinancialTrxnId['financialTrxnId'],
3777 'return' => array('card_type_id', 'pan_truncation'),
3780 $this->assertEquals(CRM_Utils_Array
::value('card_type_id', $financialTrxn), $creditCardTypeIDs['Visa']);
3781 $this->assertEquals(CRM_Utils_Array
::value('pan_truncation', $financialTrxn), 4567);
3783 'id' => $contribution['id'],
3784 'pan_truncation' => 2345,
3785 'card_type_id' => $creditCardTypeIDs['Amex'],
3787 $contribution = $this->callAPISuccess('contribution', 'create', $params);
3788 $financialTrxn = $this->callAPISuccessGetSingle(
3791 'id' => $lastFinancialTrxnId['financialTrxnId'],
3792 'return' => array('card_type_id', 'pan_truncation'),
3795 $this->assertEquals(CRM_Utils_Array
::value('card_type_id', $financialTrxn), $creditCardTypeIDs['Amex']);
3796 $this->assertEquals(CRM_Utils_Array
::value('pan_truncation', $financialTrxn), 2345);