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/v61.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 "organizationName": "mini cat town", 34 "firstName": "Daniel", 35 "lastName": "Chavez", 36 "phone": "510-432-1234", 37 "email": "danielchavez@salesforce.com", 38 "address": [ 39 { 40 "addressType": "mailing", 41 "street": "123 Main Street", 42 "city": "Oakland", 43 "state": "CA", 44 "postalCode": "94610", 45 "country": "US" 46 } 47 ], 48 "accountCustomFields": [ 49 { 50 "fieldName": "string", 51 "fieldValue": "string" 52 } 53 ] 54 }, 55 "paymentInstrument": { 56 "type": "credit card", 57 "accountHolderName": "Daniel Chavez", 58 "expiryMonth": "10", 59 "expiryYear": "2026", 60 "last4": "4321", 61 "cardBrand": "Diners club", 62 "bankName": "chase", 63 "digitalWalletProvider": "Diner's Club", 64 "bankAccountHolderType": "primary", 65 "bankAccountType": "checking", 66 "bankAccountNumber": "123456", 67 "bankCode": "HBUK", 68 "gatewayName": "Gateway", 69 "processorName": "centpro", 70 "processorPaymentReference": "string", 71 "gatewayReference": "string" 72 }, 73 "designations": [ 74 { 75 "designationId": "0gd0030f0303024", 76 "percent": 10, 77 "amount": 150.25 78 } 79 ], 80 "giftTransactionCustomFields": [ 81 { 82 "fieldName": "string", 83 "fieldValue": "string" 84 } 85 ] 86 } 87 ] 88} - 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