Create Commitment Request Input

Input representation of the request to create a recurring gift commitment. This request body accepts an array of commitment requests. However, for the API version 60.0, only a single commitment is supported per request.

JSON example

1{
2  "commitments": [
3    {
4      "amount": 15,
5      "currencyIsoCode": "USD",
6      "transactionPeriod": "monthly",
7      "transactionInterval": 1,
8      "transactionDay": "1",
9      "startDate": "2023-11-01",
10      "endDate": "",
11      "outreachSourceCode": {
12        "sourceCode": "AnimalEmailCampaign2023"
13      },
14      "donor": {
15        "donorType": "individual",
16        "id": "",
17        "firstName": "Daniel",
18        "lastName": "Chavez",
19        "phone": "510-432-1234",
20        "email": "d.chavez@salesforce.com",
21        "address": [
22          {
23            "addressType": "mailing",
24            "street": "123 Main Street",
25            "city": "Tardis",
26            "state": "NJ",
27            "postalCode": "08638",
28            "country": "US"
29          }
30        ]
31      },
32      "paymentInstrument": {
33        "type": "Credit Card",
34        "accountHolderName": "Daniel Chavez",
35        "expiryMonth": "10",
36        "expiryYear": "2026",
37        "last4": "4321",
38        "cardBrand": "Diner's Club",
39        "bankName": "chase",
40        "digitalWalletProvider": "",
41        "bankAccountHolderType": "primary",
42        "bankAccountType": "checking",
43        "bankAccountNumber": "123456",
44        "bankCode": "HBUK",
45        "gatewayName": "Gateway",
46        "processorName": "Centpro",
47        "processorPaymentReference": "string",
48        "gatewayReference": "string"
49      },
50      "designations": [
51        {
52          "designationId": "",
53          "percent": 0
54        }
55      ],
56      "firstTransaction": {
57        "amount": 15,
58        "receivedDate": "2023-11-02",
59        "donorCoverAmount": 0.25,
60        "transactionStatus": "Paid",
61        "gatewayTransactionFee": 0.75,
62        "processorTransactionFee": 0.045,
63        "processorReference": "cls-1247586928747",
64        "gatewayReference": "102656693ac3ca6e0cdafbfe89ab99",
65        "lastGatewayResponseCode": "",
66        "lastGatewayErrorMessage": "",
67        "lastGatewayProcessedDateTime": "2023-11-02T21:57:51Z"
68      }
69    }
70  ]
71}

Properties

Name	Type	Description	Required or Optional	Available Version
`amount`	Double	Expected amount of the gift transaction in the commitment schedule.	Required	60.0
`campaign`	Campaign Details Input	Campaign that's associated with the commitment.	Optional	60.0
`currencyIsoCode`	String	Currency ISO code for the commitment.	Optional	60.0
`designations`	Designation Details Input[]	Default gift designations that are associated with the commitment.	Optional	60.0
`donor`	Donor Details Input	Person, household, or organization account that's associated with the commitment.	Required	60.0
`endDate`	String	Date when the total amount of the commitment is expected to be paid. The default format is `YYYY-MM-DD`.	Required	60.0
`firstTransaction`	Transaction Details Input	First transaction of the commitment.	Optional	60.0
`giftCommitmentCustomFields`	Custom Field Details Input[]	Custom fields of the gift commitment.	Optional	60.0
`giftCommitmentScheduleCustomFields`	Custom Field Details Input[]	Custom fields of the gift commitment schedule.	Optional	60.0
`outreachSourceCode`	Outreach Source Code Details Input	Outreach source code that's associated with the campaign for the gift commitment schedule.	Optional	60.0
`paymentInstrument`	Payment Instrument Details Input	Payment instrument that's used to complete the transaction.	Required	60.0
`paymentProcessorCommitmentId`	String	Reference number of the commitment that was assigned by the processor.	Optional	60.0
`startDate`	String	Date from when the commitment is in effect. The default format is `YYYY-MM-DD`.	Required	60.0
`transactionDay`	String	Day of the month to create gift transaction in the future for a monthly transaction period. If you select the day as 29 or 30, the gift transaction is created on the last day for months that don't have that many days.	Optional	60.0
`transactionInterval`	Integer	Transaction interval that's applicable to the incoming transaction in the commitment.	Optional	60.0
`transactionPeriod`	String	Transaction period that's applicable to the incoming transaction in the commitment.	Required	60.0

Nonprofit Cloud Developer Guide

Create Commitment Request Input