Newer Version Available
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/v65.0/connect/fundraising/gifts - Available version
- 60.0
- HTTP methods
- POST
- Request body for POST
-
- 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 processingOptions Processing Options Details Input Options for the donor matching process. Optional 60.0
- Response body for POST
- Create Gift