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 public function testCompleteTransactionSetStatusToInProgress() {
2576 $paymentProcessorID = $this->paymentProcessorCreate();
2577 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array(
2578 'contact_id' => $this->_individualId
,
2579 'installments' => '12',
2580 'frequency_interval' => '1',
2582 'contribution_status_id' => 'Pending',
2583 'start_date' => '2012-01-01 00:00:00',
2584 'currency' => 'USD',
2585 'frequency_unit' => 'month',
2586 'payment_processor_id' => $paymentProcessorID,
2588 $contribution = $this->callAPISuccess('contribution', 'create', array_merge(
2591 'contribution_recur_id' => $contributionRecur['id'],
2592 'contribution_status_id' => 'Pending',
2595 $this->callAPISuccess('Contribution', 'completetransaction', array('id' => $contribution));
2596 $contributionRecur = $this->callAPISuccessGetSingle('ContributionRecur', array(
2597 'id' => $contributionRecur['id'],
2598 'return' => array('next_sched_contribution_date', 'contribution_status_id'),
2600 $this->assertEquals(5, $contributionRecur['contribution_status_id']);
2601 $this->assertEquals(date('Y-m-d 00:00:00', strtotime('+1 month')), $contributionRecur['next_sched_contribution_date']);
2605 * Test completing a pledge with the completeTransaction api..
2607 * Note that we are creating a logged in user because email goes out from
2610 public function testCompleteTransactionUpdatePledgePayment() {
2611 $this->swapMessageTemplateForTestTemplate();
2612 $mut = new CiviMailUtils($this, TRUE);
2613 $mut->clearMessages();
2614 $this->createLoggedInUser();
2615 $contributionID = $this->createPendingPledgeContribution();
2616 $this->callAPISuccess('contribution', 'completetransaction', array(
2617 'id' => $contributionID,
2618 'trxn_date' => '1 Feb 2013',
2620 $pledge = $this->callAPISuccessGetSingle('Pledge', array(
2621 'id' => $this->_ids
['pledge'],
2623 $this->assertEquals('Completed', $pledge['pledge_status']);
2625 $status = $this->callAPISuccessGetValue('PledgePayment', array(
2626 'pledge_id' => $this->_ids
['pledge'],
2627 'return' => 'status_id',
2629 $this->assertEquals(1, $status);
2630 $mut->checkMailLog(array(
2632 'receive_date:::20130201000000',
2633 "receipt_date:::\n",
2636 $this->revertTemplateToReservedTemplate();
2640 * Test completing a transaction with an event via the API.
2642 * Note that we are creating a logged in user because email goes out from
2645 public function testCompleteTransactionWithParticipantRecord() {
2646 $mut = new CiviMailUtils($this, TRUE);
2647 $mut->clearMessages();
2648 $this->createLoggedInUser();
2649 $contributionID = $this->createPendingParticipantContribution();
2650 $this->callAPISuccess('contribution', 'completetransaction', array(
2651 'id' => $contributionID,
2654 $participantStatus = $this->callAPISuccessGetValue('participant', array(
2655 'id' => $this->_ids
['participant'],
2656 'return' => 'participant_status_id',
2658 $this->assertEquals(1, $participantStatus);
2659 $mut->checkMailLog(array(
2660 'Annual CiviCRM meet',
2662 'This letter is a confirmation that your registration has been received and your status has been updated to Registered.',
2668 * Test membership is renewed when transaction completed.
2670 public function testCompleteTransactionMembershipPriceSet() {
2671 $this->createPriceSetWithPage('membership');
2672 $stateOfGrace = $this->callAPISuccess('MembershipStatus', 'getvalue', array(
2676 $this->setUpPendingContribution($this->_ids
['price_field_value'][0]);
2677 $membership = $this->callAPISuccess('membership', 'getsingle', array('id' => $this->_ids
['membership']));
2678 $logs = $this->callAPISuccess('MembershipLog', 'get', array(
2679 'membership_id' => $this->_ids
['membership'],
2681 $this->assertEquals(1, $logs['count']);
2682 $this->assertEquals($stateOfGrace, $membership['status_id']);
2683 $contribution = $this->callAPISuccess('contribution', 'completetransaction', array('id' => $this->_ids
['contribution']));
2684 $membership = $this->callAPISuccess('membership', 'getsingle', array('id' => $this->_ids
['membership']));
2685 $this->assertEquals(date('Y-m-d', strtotime('yesterday + 1 year')), $membership['end_date']);
2686 $this->callAPISuccessGetSingle('LineItem', array(
2687 'entity_id' => $this->_ids
['membership'],
2688 'entity_table' => 'civicrm_membership',
2690 $logs = $this->callAPISuccess('MembershipLog', 'get', array(
2691 'membership_id' => $this->_ids
['membership'],
2693 //CRM-19600: Ensure that 'Membership Renewal' activity is created after successful membership regsitration
2694 $activity = $this->callAPISuccess('Activity', 'get', array(
2695 'activity_type_id' => 'Membership Renewal',
2696 'source_record_id' => $contribution['id'],
2698 $this->assertEquals(1, $activity['count']);
2699 $this->assertEquals(2, $logs['count']);
2700 $this->assertNotEquals($stateOfGrace, $logs['values'][2]['status_id']);
2701 $this->cleanUpAfterPriceSets();
2705 * Test if renewal activity is create after changing Pending contribution to Completed via offline
2707 public function testPendingToCompleteContribution() {
2708 $contributionPage = $this->createPriceSetWithPage('membership');
2709 $stateOfGrace = $this->callAPISuccess('MembershipStatus', 'getvalue', array(
2713 $this->setUpPendingContribution($this->_ids
['price_field_value'][0]);
2714 $this->callAPISuccess('membership', 'getsingle', array('id' => $this->_ids
['membership']));
2716 // change pending contribution to completed
2717 $form = new CRM_Contribute_Form_Contribution();
2719 $form->_params
= array(
2720 'id' => $this->_ids
['contribution'],
2721 'total_amount' => 20,
2724 'financial_type_id' => 1,
2725 'receive_date' => '04/21/2015',
2726 'receive_date_time' => '11:27PM',
2727 'contact_id' => $this->_individualId
,
2728 'contribution_status_id' => 1,
2729 'billing_middle_name' => '',
2730 'billing_last_name' => 'Adams',
2731 'billing_street_address-5' => '790L Lincoln St S',
2732 'billing_city-5' => 'Maryknoll',
2733 'billing_state_province_id-5' => 1031,
2734 'billing_postal_code-5' => 10545,
2735 'billing_country_id-5' => 1228,
2736 'frequency_interval' => 1,
2737 'frequency_unit' => 'month',
2738 'installments' => '',
2739 'hidden_AdditionalDetail' => 1,
2740 'hidden_Premium' => 1,
2741 'from_email_address' => '"civi45" <civi45@civicrm.com>',
2742 'receipt_date' => '',
2743 'receipt_date_time' => '',
2744 'payment_processor_id' => $this->paymentProcessorID
,
2745 'currency' => 'USD',
2746 'contribution_page_id' => $this->_ids
['contribution_page'],
2747 'contribution_mode' => 'membership',
2748 'source' => 'Membership Signup and Renewal',
2751 $form->testSubmit($form->_params
, CRM_Core_Action
::UPDATE
);
2753 catch (Civi\Payment\Exception\PaymentProcessorException
$e) {
2756 $activity = $this->callAPISuccess('Activity', 'get', array(
2757 'activity_type_id' => 'Membership Renewal',
2758 'source_record_id' => $this->_ids
['contribution'],
2760 $this->assertEquals(1, $activity['count']);
2764 * Test membership is renewed when transaction completed.
2766 public function testCompleteTransactionMembershipPriceSetTwoTerms() {
2767 $this->createPriceSetWithPage('membership');
2768 $this->setUpPendingContribution($this->_ids
['price_field_value'][1]);
2769 $this->callAPISuccess('contribution', 'completetransaction', array('id' => $this->_ids
['contribution']));
2770 $membership = $this->callAPISuccess('membership', 'getsingle', array('id' => $this->_ids
['membership']));
2771 $this->assertEquals(date('Y-m-d', strtotime('yesterday + 2 years')), $membership['end_date']);
2772 $this->cleanUpAfterPriceSets();
2775 public function cleanUpAfterPriceSets() {
2776 $this->quickCleanUpFinancialEntities();
2777 $this->contactDelete($this->_ids
['contact']);
2781 * Set up a pending transaction with a specific price field id.
2783 * @param int $priceFieldValueID
2785 public function setUpPendingContribution($priceFieldValueID) {
2786 $contactID = $this->individualCreate();
2787 $membership = $this->callAPISuccess('membership', 'create', array(
2788 'contact_id' => $contactID,
2789 'membership_type_id' => $this->_ids
['membership_type'],
2790 'start_date' => 'yesterday - 1 year',
2791 'end_date' => 'yesterday',
2792 'join_date' => 'yesterday - 1 year',
2794 $contribution = $this->callAPISuccess('contribution', 'create', array(
2796 'contact_id' => $contactID,
2797 'receive_date' => date('Ymd'),
2798 'total_amount' => 20.00,
2799 'financial_type_id' => 1,
2800 'payment_instrument_id' => 'Credit Card',
2801 'non_deductible_amount' => 10.00,
2802 'trxn_id' => 'jdhfi88',
2803 'invoice_id' => 'djfhiewuyr',
2805 'contribution_status_id' => 2,
2806 'contribution_page_id' => $this->_ids
['contribution_page'],
2807 'api.membership_payment.create' => array('membership_id' => $membership['id']),
2810 $this->callAPISuccess('line_item', 'create', array(
2811 'entity_id' => $contribution['id'],
2812 'entity_table' => 'civicrm_contribution',
2813 'contribution_id' => $contribution['id'],
2814 'price_field_id' => $this->_ids
['price_field'][0],
2818 'financial_type_id' => 1,
2819 'price_field_value_id' => $priceFieldValueID,
2821 $this->_ids
['contact'] = $contactID;
2822 $this->_ids
['contribution'] = $contribution['id'];
2823 $this->_ids
['membership'] = $membership['id'];
2827 * Test sending a mail via the API.
2829 public function testSendMail() {
2830 $mut = new CiviMailUtils($this, TRUE);
2831 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
2832 $this->callAPISuccess('contribution', 'sendconfirmation', array(
2833 'id' => $contribution['id'],
2834 'receipt_from_email' => 'api@civicrm.org',
2837 $mut->checkMailLog(array(
2839 'Contribution Information',
2840 'Please print this confirmation for your records',
2846 $this->checkCreditCardDetails($mut, $contribution['id']);
2851 * Check credit card details in sent mail via API
2853 * @param $mut obj CiviMailUtils instance
2854 * @param int $contributionID Contribution ID
2857 public function checkCreditCardDetails($mut, $contributionID) {
2858 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
2859 $this->callAPISuccess('contribution', 'sendconfirmation', array(
2860 'id' => $contributionID,
2861 'receipt_from_email' => 'api@civicrm.org',
2862 'payment_processor_id' => $this->paymentProcessorID
,
2865 $mut->checkMailLog(array(
2866 'Credit Card Information', // credit card header
2867 'Billing Name and Address', // billing header
2868 'anthony_anderson@civicrm.org', // billing name
2876 * Test sending a mail via the API.
2878 public function testSendMailEvent() {
2879 $mut = new CiviMailUtils($this, TRUE);
2880 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
2881 $event = $this->eventCreate(array(
2882 'is_email_confirm' => 1,
2883 'confirm_from_email' => 'test@civicrm.org',
2885 $this->_eventID
= $event['id'];
2886 $participantParams = array(
2887 'contact_id' => $this->_individualId
,
2888 'event_id' => $this->_eventID
,
2891 // to ensure it matches later on
2892 'register_date' => '2007-07-21 00:00:00',
2893 'source' => 'Online Event Registration: API Testing',
2896 $participant = $this->callAPISuccess('participant', 'create', $participantParams);
2897 $this->callAPISuccess('participant_payment', 'create', array(
2898 'participant_id' => $participant['id'],
2899 'contribution_id' => $contribution['id'],
2901 $this->callAPISuccess('contribution', 'sendconfirmation', array(
2902 'id' => $contribution['id'],
2903 'receipt_from_email' => 'api@civicrm.org',
2907 $mut->checkMailLog(array(
2908 'Annual CiviCRM meet',
2910 'To: "Mr. Anthony Anderson II" <anthony_anderson@civicrm.org>',
2917 * This function does a GET & compares the result against the $params.
2919 * Use as a double check on Creates.
2921 * @param array $params
2923 * @param bool $delete
2925 public function contributionGetnCheck($params, $id, $delete = TRUE) {
2927 $contribution = $this->callAPISuccess('Contribution', 'Get', array(
2933 $this->callAPISuccess('contribution', 'delete', array('id' => $id));
2935 $this->assertAPISuccess($contribution, 0);
2936 $values = $contribution['values'][$contribution['id']];
2937 $params['receive_date'] = date('Y-m-d H:i:s', strtotime($params['receive_date']));
2938 // this is not returned in id format
2939 unset($params['payment_instrument_id']);
2940 $params['contribution_source'] = $params['source'];
2941 unset($params['source']);
2942 foreach ($params as $key => $value) {
2943 $this->assertEquals($value, $values[$key], $key . " value: $value doesn't match " . print_r($values, TRUE));
2948 * Create a pending contribution & linked pending pledge record.
2950 public function createPendingPledgeContribution() {
2952 $pledgeID = $this->pledgeCreate(array('contact_id' => $this->_individualId
, 'installments' => 1, 'amount' => 500));
2953 $this->_ids
['pledge'] = $pledgeID;
2954 $contribution = $this->callAPISuccess('contribution', 'create', array_merge($this->_params
, array(
2955 'contribution_status_id' => 'Pending',
2956 'total_amount' => 500,
2959 $paymentID = $this->callAPISuccessGetValue('PledgePayment', array(
2960 'options' => array('limit' => 1),
2963 $this->callAPISuccess('PledgePayment', 'create', array(
2965 'contribution_id' =>
2966 $contribution['id'],
2967 'status_id' => 'Pending',
2968 'scheduled_amount' => 500,
2971 return $contribution['id'];
2975 * Create a pending contribution & linked pending participant record (along with an event).
2977 public function createPendingParticipantContribution() {
2978 $event = $this->eventCreate(array('is_email_confirm' => 1, 'confirm_from_email' => 'test@civicrm.org'));
2979 $participantID = $this->participantCreate(array('event_id' => $event['id'], 'status_id' => 6));
2980 $this->_ids
['participant'] = $participantID;
2981 $params = array_merge($this->_params
, array('contribution_status_id' => 2, 'financial_type_id' => 'Event Fee'));
2982 $contribution = $this->callAPISuccess('contribution', 'create', $params);
2983 $this->callAPISuccess('participant_payment', 'create', array(
2984 'contribution_id' => $contribution['id'],
2985 'participant_id' => $participantID,
2987 $this->callAPISuccess('line_item', 'get', array(
2988 'entity_id' => $contribution['id'],
2989 'entity_table' => 'civicrm_contribution',
2990 'api.line_item.create' => array(
2991 'entity_id' => $participantID,
2992 'entity_table' => 'civicrm_participant',
2995 return $contribution['id'];
2999 * Get financial transaction amount.
3001 * @param int $contId
3003 * @return null|string
3005 public function _getFinancialTrxnAmount($contId) {
3007 SUM( ft.total_amount ) AS total
3008 FROM civicrm_financial_trxn AS ft
3009 LEFT JOIN civicrm_entity_financial_trxn AS ceft ON ft.id = ceft.financial_trxn_id
3010 WHERE ceft.entity_table = 'civicrm_contribution'
3011 AND ceft.entity_id = {$contId}";
3013 $result = CRM_Core_DAO
::singleValueQuery($query);
3018 * @param int $contId
3020 * @return null|string
3022 public function _getFinancialItemAmount($contId) {
3023 $lineItem = key(CRM_Price_BAO_LineItem
::getLineItems($contId, 'contribution'));
3026 FROM civicrm_financial_item
3027 WHERE entity_table = 'civicrm_line_item'
3028 AND entity_id = {$lineItem}";
3029 $result = CRM_Core_DAO
::singleValueQuery($query);
3034 * @param int $contId
3037 public function _checkFinancialItem($contId, $context) {
3038 if ($context != 'paylater') {
3040 'entity_id' => $contId,
3041 'entity_table' => 'civicrm_contribution',
3043 $trxn = current(CRM_Financial_BAO_FinancialItem
::retrieveEntityFinancialTrxn($params, TRUE));
3044 $entityParams = array(
3045 'financial_trxn_id' => $trxn['financial_trxn_id'],
3046 'entity_table' => 'civicrm_financial_item',
3048 $entityTrxn = current(CRM_Financial_BAO_FinancialItem
::retrieveEntityFinancialTrxn($entityParams));
3050 'id' => $entityTrxn['entity_id'],
3053 if ($context == 'paylater') {
3054 $lineItems = CRM_Price_BAO_LineItem
::getLineItems($contId, 'contribution');
3055 foreach ($lineItems as $key => $item) {
3057 'entity_id' => $key,
3058 'entity_table' => 'civicrm_line_item',
3060 $compareParams = array('status_id' => 1);
3061 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialItem', $params, $compareParams);
3064 elseif ($context == 'refund') {
3065 $compareParams = array(
3067 'financial_account_id' => 1,
3071 elseif ($context == 'cancelPending') {
3072 $compareParams = array(
3074 'financial_account_id' => 1,
3078 elseif ($context == 'changeFinancial') {
3079 $lineKey = key(CRM_Price_BAO_LineItem
::getLineItems($contId, 'contribution'));
3081 'entity_id' => $lineKey,
3084 $compareParams = array(
3085 'financial_account_id' => 1,
3087 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialItem', $params, $compareParams);
3089 'financial_account_id' => 3,
3090 'entity_id' => $lineKey,
3092 $compareParams = array(
3096 if ($context != 'paylater') {
3097 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialItem', $params, $compareParams);
3102 * Check financial transaction.
3104 * @todo break this down into sensible functions - most calls to it only use a few lines out of the big if.
3106 * @param array $contribution
3107 * @param string $context
3108 * @param int $instrumentId
3109 * @param array $extraParams
3111 public function _checkFinancialTrxn($contribution, $context, $instrumentId = NULL, $extraParams = array()) {
3112 $trxnParams = array(
3113 'entity_id' => $contribution['id'],
3114 'entity_table' => 'civicrm_contribution',
3116 $trxn = current(CRM_Financial_BAO_FinancialItem
::retrieveEntityFinancialTrxn($trxnParams, TRUE));
3118 'id' => $trxn['financial_trxn_id'],
3120 if ($context == 'payLater') {
3121 $compareParams = array(
3123 'from_financial_account_id' => CRM_Contribute_PseudoConstant
::getRelationalFinancialAccount($contribution['financial_type_id'], 'Accounts Receivable Account is'),
3126 elseif ($context == 'refund') {
3127 $compareParams = array(
3128 'to_financial_account_id' => 6,
3129 'total_amount' => -100,
3131 'trxn_date' => '2015-01-01 09:00:00',
3132 'trxn_id' => 'the refund',
3135 elseif ($context == 'cancelPending') {
3136 $compareParams = array(
3137 'to_financial_account_id' => 7,
3138 'total_amount' => -100,
3142 elseif ($context == 'changeFinancial' ||
$context == 'paymentInstrument') {
3143 $entityParams = array(
3144 'entity_id' => $contribution['id'],
3145 'entity_table' => 'civicrm_contribution',
3148 $trxn = current(CRM_Financial_BAO_FinancialItem
::retrieveEntityFinancialTrxn($entityParams));
3149 $trxnParams1 = array(
3150 'id' => $trxn['financial_trxn_id'],
3152 if (empty($extraParams)) {
3153 $compareParams = array(
3154 'total_amount' => -100,
3159 $compareParams = array(
3160 'total_amount' => 100,
3164 if ($context == 'paymentInstrument') {
3165 $compareParams +
= array(
3166 'to_financial_account_id' => CRM_Financial_BAO_FinancialTypeAccount
::getInstrumentFinancialAccount(4),
3167 'payment_instrument_id' => 4,
3171 $compareParams['to_financial_account_id'] = 12;
3173 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialTrxn', $trxnParams1, array_merge($compareParams, $extraParams));
3174 $compareParams['total_amount'] = 100;
3175 if ($context == 'paymentInstrument') {
3176 $compareParams['to_financial_account_id'] = CRM_Financial_BAO_FinancialTypeAccount
::getInstrumentFinancialAccount($instrumentId);
3177 $compareParams['payment_instrument_id'] = $instrumentId;
3180 $compareParams['to_financial_account_id'] = 12;
3184 $this->assertDBCompareValues('CRM_Financial_DAO_FinancialTrxn', $params, array_merge($compareParams, $extraParams));
3190 public function _addPaymentInstrument() {
3191 $gId = CRM_Core_DAO
::getFieldValue('CRM_Core_DAO_OptionGroup', 'payment_instrument', 'id', 'name');
3192 $optionParams = array(
3193 'option_group_id' => $gId,
3194 'label' => 'Test Card',
3195 'name' => 'Test Card',
3200 $optionValue = $this->callAPISuccess('option_value', 'create', $optionParams);
3201 $relationTypeId = key(CRM_Core_PseudoConstant
::accountOptionValues('account_relationship', NULL, " AND v.name LIKE 'Asset Account is' "));
3202 $financialParams = array(
3203 'entity_table' => 'civicrm_option_value',
3204 'entity_id' => $optionValue['id'],
3205 'account_relationship' => $relationTypeId,
3206 'financial_account_id' => 7,
3208 CRM_Financial_BAO_FinancialTypeAccount
::add($financialParams, CRM_Core_DAO
::$_nullArray);
3209 $this->assertNotEmpty($optionValue['values'][$optionValue['id']]['value']);
3210 return $optionValue['values'][$optionValue['id']]['value'];
3214 * Set up the basic recurring contribution for tests.
3216 * @param array $generalParams
3217 * Parameters that can be merged into the recurring AND the contribution.
3219 * @param array $recurParams
3220 * Parameters to merge into the recur only.
3224 protected function setUpRecurringContribution($generalParams = array(), $recurParams = array()) {
3225 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array_merge(array(
3226 'contact_id' => $this->_individualId
,
3227 'installments' => '12',
3228 'frequency_interval' => '1',
3230 'contribution_status_id' => 1,
3231 'start_date' => '2012-01-01 00:00:00',
3232 'currency' => 'USD',
3233 'frequency_unit' => 'month',
3234 'payment_processor_id' => $this->paymentProcessorID
,
3235 ), $generalParams, $recurParams));
3236 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3239 'contribution_recur_id' => $contributionRecur['id'],
3242 return $originalContribution;
3246 * Set up a basic auto-renew membership for tests.
3248 * @param array $generalParams
3249 * Parameters that can be merged into the recurring AND the contribution.
3251 * @param array $recurParams
3252 * Parameters to merge into the recur only.
3256 protected function setUpAutoRenewMembership($generalParams = array(), $recurParams = array()) {
3257 $newContact = $this->callAPISuccess('Contact', 'create', array(
3258 'contact_type' => 'Individual',
3259 'sort_name' => 'McTesterson, Testy',
3260 'display_name' => 'Testy McTesterson',
3261 'preferred_language' => 'en_US',
3262 'preferred_mail_format' => 'Both',
3263 'first_name' => 'Testy',
3264 'last_name' => 'McTesterson',
3265 'contact_is_deleted' => '0',
3267 'email' => 'tmctesterson@example.com',
3270 $membershipType = $this->callAPISuccess('MembershipType', 'create', array(
3271 'domain_id' => "Default Domain Name",
3272 'member_of_contact_id' => 1,
3273 'financial_type_id' => "Member Dues",
3274 'duration_unit' => "month",
3275 'duration_interval' => 1,
3276 'period_type' => 'rolling',
3277 'name' => "Standard Member",
3278 'minimum_fee' => 100,
3280 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array_merge(array(
3281 'contact_id' => $newContact['id'],
3282 'installments' => '12',
3283 'frequency_interval' => '1',
3285 'contribution_status_id' => 1,
3286 'start_date' => '2012-01-01 00:00:00',
3287 'currency' => 'USD',
3288 'frequency_unit' => 'month',
3289 'payment_processor_id' => $this->paymentProcessorID
,
3290 ), $generalParams, $recurParams));
3292 $membership = $this->callAPISuccess('membership', 'create', array(
3293 'contact_id' => $newContact['id'],
3294 'contribution_recur_id' => $contributionRecur['id'],
3295 'financial_type_id' => "Member Dues",
3296 'membership_type_id' => $membershipType['id'],
3298 'skipLineItem' => TRUE,
3301 CRM_Price_BAO_LineItem
::getLineItemArray($this->_params
, NULL, 'membership', $membershipType['id']);
3302 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3305 'contact_id' => $newContact['id'],
3306 'contribution_recur_id' => $contributionRecur['id'],
3307 'financial_type_id' => "Member Dues",
3308 'contribution_status_id' => 1,
3309 'invoice_id' => uniqid(),
3312 $lineItem = $this->callAPISuccess('LineItem', 'getsingle', array());
3313 $this->assertEquals('civicrm_membership', $lineItem['entity_table']);
3314 $membership = $this->callAPISuccess('Membership', 'getsingle', array('id' => $lineItem['entity_id']));
3315 $this->callAPISuccess('LineItem', 'getsingle', array());
3316 $this->callAPISuccessGetCount('MembershipPayment', array('membership_id' => $membership['id']), 1);
3318 return array($originalContribution, $membership);
3321 * Set up a repeat transaction.
3323 * @param array $recurParams
3327 protected function setUpRepeatTransaction($recurParams = array(), $flag) {
3328 $paymentProcessorID = $this->paymentProcessorCreate();
3329 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array_merge(array(
3330 'contact_id' => $this->_individualId
,
3331 'installments' => '12',
3332 'frequency_interval' => '1',
3334 'contribution_status_id' => 1,
3335 'start_date' => '2012-01-01 00:00:00',
3336 'currency' => 'USD',
3337 'frequency_unit' => 'month',
3338 'payment_processor_id' => $paymentProcessorID,
3341 $originalContribution = '';
3342 if ($flag == 'multiple') {
3343 // CRM-19309 create a contribution + also add in line_items (plural):
3344 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3347 'contribution_recur_id' => $contributionRecur['id'],
3348 'skipLineItem' => 1,
3349 'api.line_item.create' => array(
3351 'price_field_id' => 1,
3353 'line_total' => '20',
3354 'unit_price' => '10',
3355 'financial_type_id' => 1,
3358 'price_field_id' => 1,
3360 'line_total' => '80',
3361 'unit_price' => '80',
3362 'financial_type_id' => 2,
3369 elseif ($flag == 'single') {
3370 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3372 array('contribution_recur_id' => $contributionRecur['id']))
3375 $originalContribution['payment_processor_id'] = $paymentProcessorID;
3376 return $originalContribution;
3380 * Common set up routine.
3384 protected function setUpForCompleteTransaction() {
3385 $this->mut
= new CiviMailUtils($this, TRUE);
3386 $this->createLoggedInUser();
3387 $params = array_merge($this->_params
, array('contribution_status_id' => 2, 'receipt_date' => 'now'));
3388 $contribution = $this->callAPISuccess('contribution', 'create', $params);
3389 return $contribution;
3393 * Test repeat contribution uses the Payment Processor' payment_instrument setting.
3395 public function testRepeatTransactionWithNonCreditCardDefault() {
3396 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array(
3397 'contact_id' => $this->_individualId
,
3398 'installments' => '12',
3399 'frequency_interval' => '1',
3401 'contribution_status_id' => 1,
3402 'start_date' => '2012-01-01 00:00:00',
3403 'currency' => 'USD',
3404 'frequency_unit' => 'month',
3405 'payment_processor_id' => $this->paymentProcessorID
,
3407 $contribution1 = $this->callAPISuccess('contribution', 'create', array_merge(
3409 array('contribution_recur_id' => $contributionRecur['id'], 'payment_instrument_id' => 2))
3411 $paymentInstruments = CRM_Contribute_PseudoConstant
::paymentInstrument('name');
3412 $contribution2 = $this->callAPISuccess('contribution', 'repeattransaction', array(
3413 'contribution_status_id' => 'Completed',
3414 'trxn_id' => uniqid(),
3415 'original_contribution_id' => $contribution1,
3417 $this->assertEquals(array_search('Debit Card', $paymentInstruments), $contribution2['values'][$contribution2['id']]['payment_instrument_id']);
3418 $this->quickCleanUpFinancialEntities();
3422 * CRM-20008 Tests repeattransaction creates pending membership.
3424 public function testRepeatTransactionPendingMembership() {
3425 list($originalContribution, $membership) = $this->setUpAutoRenewMembership();
3426 $this->callAPISuccess('membership', 'create', array(
3427 'id' => $membership['id'],
3428 'end_date' => 'yesterday',
3429 'status_id' => 'Expired',
3431 $repeatedContribution = $this->callAPISuccess('contribution', 'repeattransaction', array(
3432 'contribution_recur_id' => $originalContribution['values'][1]['contribution_recur_id'],
3433 'contribution_status_id' => 'Pending',
3434 'trxn_id' => uniqid(),
3436 $membershipStatusId = $this->callAPISuccess('membership', 'getvalue', array(
3437 'id' => $membership['id'],
3438 'return' => 'status_id',
3441 // Let's see if the membership payments got created while we're at it.
3442 $membershipPayments = $this->callAPISuccess('MembershipPayment', 'get', array(
3443 'memberhip_id' => $membership['id'],
3445 $this->assertEquals(2, $membershipPayments['count']);
3447 $this->assertEquals('Expired', CRM_Core_PseudoConstant
::getLabel('CRM_Member_BAO_Membership', 'status_id', $membershipStatusId));
3448 $this->callAPISuccess('Contribution', 'completetransaction', array('id' => $repeatedContribution['id']));
3449 $membership = $this->callAPISuccessGetSingle('membership', array(
3450 'id' => $membership['id'],
3451 'return' => 'status_id, end_date',
3453 $this->assertEquals('New', CRM_Core_PseudoConstant
::getLabel('CRM_Member_BAO_Membership', 'status_id', $membership['status_id']));
3454 $this->assertEquals(date('Y-m-d', strtotime('yesterday + 1 month')), $membership['end_date']);
3456 $this->quickCleanUpFinancialEntities();
3457 $this->contactDelete($originalContribution['values'][1]['contact_id']);
3461 * Test sending a mail via the API.
3463 public function testSendMailWithAPISetFromDetails() {
3464 $mut = new CiviMailUtils($this, TRUE);
3465 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
3466 $this->callAPISuccess('contribution', 'sendconfirmation', array(
3467 'id' => $contribution['id'],
3468 'receipt_from_email' => 'api@civicrm.org',
3469 'receipt_from_name' => 'CiviCRM LLC',
3471 $mut->checkMailLog(array(
3472 'From: CiviCRM LLC <api@civicrm.org>',
3473 'Contribution Information',
3474 'Please print this confirmation for your records',
3483 * Test sending a mail via the API.
3485 public function testSendMailWithNoFromSetFallToDomain() {
3486 $this->createLoggedInUser();
3487 $mut = new CiviMailUtils($this, TRUE);
3488 $contribution = $this->callAPISuccess('contribution', 'create', $this->_params
);
3489 $this->callAPISuccess('contribution', 'sendconfirmation', array(
3490 'id' => $contribution['id'],
3492 $domain = $this->callAPISuccess('domain', 'getsingle', array('id' => 1));
3493 $mut->checkMailLog(array(
3494 'From: ' . $domain['from_name'] . ' <' . $domain['from_email'] . '>',
3495 'Contribution Information',
3496 'Please print this confirmation for your records',
3505 * Test sending a mail via the API.
3507 public function testSendMailWithRepeatTransactionAPIFalltoDomain() {
3508 $this->createLoggedInUser();
3509 $mut = new CiviMailUtils($this, TRUE);
3510 $contribution = $this->setUpRepeatTransaction(array(), 'single');
3511 $this->callAPISuccess('contribution', 'repeattransaction', array(
3512 'contribution_status_id' => 'Completed',
3513 'trxn_id' => uniqid(),
3514 'original_contribution_id' => $contribution,
3516 $domain = $this->callAPISuccess('domain', 'getsingle', array('id' => 1));
3517 $mut->checkMailLog(array(
3518 'From: ' . $domain['from_name'] . ' <' . $domain['from_email'] . '>',
3519 'Contribution Information',
3520 'Please print this confirmation for your records',
3529 * Test sending a mail via the API.
3531 public function testSendMailWithRepeatTransactionAPIFalltoContributionPage() {
3532 $mut = new CiviMailUtils($this, TRUE);
3533 $contributionPage = $this->contributionPageCreate(array('receipt_from_name' => 'CiviCRM LLC', 'receipt_from_email' => 'contributionpage@civicrm.org', 'is_email_receipt' => 1));
3534 $paymentProcessorID = $this->paymentProcessorCreate();
3535 $contributionRecur = $this->callAPISuccess('contribution_recur', 'create', array(
3536 'contact_id' => $this->_individualId
,
3537 'installments' => '12',
3538 'frequency_interval' => '1',
3540 'contribution_status_id' => 1,
3541 'start_date' => '2012-01-01 00:00:00',
3542 'currency' => 'USD',
3543 'frequency_unit' => 'month',
3544 'payment_processor_id' => $paymentProcessorID,
3546 $originalContribution = $this->callAPISuccess('contribution', 'create', array_merge(
3549 'contribution_recur_id' => $contributionRecur['id'],
3550 'contribution_page_id' => $contributionPage['id']))
3552 $this->callAPISuccess('contribution', 'repeattransaction', array(
3553 'contribution_status_id' => 'Completed',
3554 'trxn_id' => uniqid(),
3555 'original_contribution_id' => $originalContribution,
3558 $mut->checkMailLog(array(
3559 'From: CiviCRM LLC <contributionpage@civicrm.org>',
3560 'Contribution Information',
3561 'Please print this confirmation for your records',
3570 * Test sending a mail via the API.
3572 public function testSendMailWithRepeatTransactionAPIFalltoSystemFromNoDefaultFrom() {
3573 $mut = new CiviMailUtils($this, TRUE);
3574 $originalContribution = $contribution = $this->setUpRepeatTransaction(array(), 'single');
3575 $fromEmail = $this->CallAPISuccess('optionValue', 'get', array('is_default' => 1, 'option_group_id' => 'from_email_address', 'sequential' => 1));
3576 foreach ($fromEmail['values'] as $from) {
3577 $this->callAPISuccess('optionValue', 'create', array('is_default' => 0, 'id' => $from['id']));
3579 $domain = $this->callAPISuccess('domain', 'getsingle', array('id' => CRM_Core_Config
::domainID()));
3580 $this->callAPISuccess('contribution', 'repeattransaction', array(
3581 'contribution_status_id' => 'Completed',
3582 'trxn_id' => uniqid(),
3583 'original_contribution_id' => $originalContribution,
3586 $mut->checkMailLog(array(
3587 'From: ' . $domain['name'] . ' <' . $domain['domain_email'] . '>',
3588 'Contribution Information',
3589 'Please print this confirmation for your records',
3598 * Create a Contribution Page with is_email_receipt = TRUE.
3600 * @param array $params
3601 * Params to overwrite with.
3605 protected function createReceiptableContributionPage($params = array()) {
3606 $contributionPage = $this->callAPISuccess('ContributionPage', 'create', array_merge(array(
3607 'receipt_from_name' => 'Mickey Mouse',
3608 'receipt_from_email' => 'mickey@mouse.com',
3609 'title' => "Test Contribution Page",
3610 'financial_type_id' => 1,
3611 'currency' => 'CAD',
3612 'is_monetary' => TRUE,
3613 'is_email_receipt' => TRUE,
3615 return $contributionPage;
3619 * function to test card_type and pan truncation.
3621 public function testCardTypeAndPanTruncation() {
3622 $creditCardTypeIDs = array_flip(CRM_Financial_DAO_FinancialTrxn
::buildOptions('card_type_id'));
3623 $contactId = $this->individualCreate();
3625 'contact_id' => $contactId,
3626 'receive_date' => '2016-01-20',
3627 'total_amount' => 100,
3628 'financial_type_id' => 1,
3629 'payment_instrument' => 'Credit Card',
3630 'card_type_id' => $creditCardTypeIDs['Visa'],
3631 'pan_truncation' => 4567,
3633 $contribution = $this->callAPISuccess('contribution', 'create', $params);
3634 $lastFinancialTrxnId = CRM_Core_BAO_FinancialTrxn
::getFinancialTrxnId($contribution['id'], 'DESC');
3635 $financialTrxn = $this->callAPISuccessGetSingle(
3638 'id' => $lastFinancialTrxnId['financialTrxnId'],
3639 'return' => array('card_type_id', 'pan_truncation'),
3642 $this->assertEquals(CRM_Utils_Array
::value('card_type_id', $financialTrxn), $creditCardTypeIDs['Visa']);
3643 $this->assertEquals(CRM_Utils_Array
::value('pan_truncation', $financialTrxn), 4567);
3645 'id' => $contribution['id'],
3646 'pan_truncation' => 2345,
3647 'card_type_id' => $creditCardTypeIDs['Amex'],
3649 $contribution = $this->callAPISuccess('contribution', 'create', $params);
3650 $financialTrxn = $this->callAPISuccessGetSingle(
3653 'id' => $lastFinancialTrxnId['financialTrxnId'],
3654 'return' => array('card_type_id', 'pan_truncation'),
3657 $this->assertEquals(CRM_Utils_Array
::value('card_type_id', $financialTrxn), $creditCardTypeIDs['Amex']);
3658 $this->assertEquals(CRM_Utils_Array
::value('pan_truncation', $financialTrxn), 2345);