Newer Version Available

This content describes an older version of this product. View Latest

Gifts Transactions (POST)

Create gift transactions with related new or matched donor, optional transaction designations, and payment-instrument metadata. This API supports custom fields for the donor account and gift transaction.
Resource
1/connect/fundraising/gifts
Resource example
1https://yourInstance.salesforce.com/services/data/v63.0/connect/fundraising/gifts
Available version
60.0
HTTP methods
POST
Request body for POST

You can pass the campaign, donor, and designation IDs in an externalId object containing fieldName and fieldValue.

Note

JSON example
1{
2  "processingOptions": {
3    "donorOptions": {
4      "defaultUpdateLogic": "update_all"
5    }
6  },
7  "gifts": [
8    {
9      "amount": 150.25,
10      "currencyIsoCode": "USD",
11      "receivedDate": "2024-07-06",
12      "donorCoverAmount": 0.25,
13      "transactionStatus": "Unpaid",
14      "commitmentId": "00x324303243fsfd",
15      "paymentIdentifier": "1234",
16      "gatewayTransactionFee": 0.75,
17      "processorTransactionFee": 0.45,
18      "processorReference": "cls-1247586928747",
19      "gatewayReference": "102656693ac3ca6e0cdafbfe89ab99",
20      "lastGatewayResponseCode": "invalid_cvc",
21      "lastGatewayErrorMessage": "The card’s security code is invalid. Check the card’s security code or use a different card.",
22      "lastGatewayProcessedDateTime": "2023-07-06T21:57:51Z",
23      "campaign": {
24        "id": "701y0030d0zk6t06f4"
25      },
26      "outreachSourceCode": {
27        "id": "0gx000d0d0d0FD",
28        "sourceCode": "AnimalEmailCampaign2023"
29      },
30      "donor": {
31        "donorType": "individual",
32        "id": "0015500000WO1ZiAAL",
33        "firstName": "Daniel",
34        "lastName": "Chavez",
35        "phone": "510-432-1234",
36        "email": "danielchavez@salesforce.com",
37        "address": [
38          {
39            "street": "123 Main Street",
40            "city": "Oakland",
41            "state": "CA",
42            "postalCode": "94610",
43            "country": "US"
44          }
45        ],
46        "accountCustomFields": [
47          {
48            "fieldName": "string",
49            "fieldValue": "string"
50          }
51        ]
52      },
53      "paymentInstrument": {
54        "type": "credit card",
55        "accountHolderName": "Daniel Chavez",
56        "expiryMonth": "10",
57        "expiryYear": "2026",
58        "last4": "4321",
59        "cardBrand": "Diners club",
60        "bankName": "chase",
61        "digitalWalletProvider": "Diner's Club",
62        "bankAccountHolderType": "primary",
63        "bankAccountType": "checking",
64        "bankAccountNumber": "123456",
65        "bankCode": "HBUK",
66        "gatewayName": "Gateway",
67        "processorName": "centpro",
68        "processorPaymentReference": "string",
69        "gatewayReference": "string"
70      },
71      "designations": [
72        {
73          "designationId": "0gd0030f0303024",
74          "percent": 10,
75          "amount": 150.25
76        }
77      ],
78      "giftTransactionCustomFields": [
79        {
80          "fieldName": "string",
81          "fieldValue": "string"
82        }
83      ]
84    }
85  ]
86}
Properties
Name Type Description Required or Optional Available Version
gifts Create Gift Request Input[] Details of the request to create the gift. Required 60.0
processing​Options Processing Options Details Input Options for the donor matching process. Optional 60.0
Response body for POST
Create Gift