Back to Collection Items
integer li_rc
oleobject loo_Http
integer li_Success
oleobject loo_Json
oleobject loo_Resp
oleobject loo_SbResponseBody
oleobject loo_JResp
integer li_RespStatusCode
integer li_Success
string ls_Href
string ls_Id
string ls_GifttransactionHref
string ls_GifttransactionId
string ls_GiftcommitmentHref
string ls_GiftcommitmentId
string ls_PaymentinstrumentHref
string ls_PaymentinstrumentId
integer j
integer li_Count_j
string ls_Href
string ls_Id
integer li_Successes
integer li_Failures
integer li_NotProcessed
integer i
integer li_Count_i
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
loo_Http = create oleobject
// Use "Chilkat_9_5_0.Http" for versions of Chilkat < 10.0.0
li_rc = loo_Http.ConnectToNewObject("Chilkat.Http")
if li_rc < 0 then
destroy loo_Http
MessageBox("Error","Connecting to COM object failed")
return
end if
// Use this online tool to generate code from sample JSON: Generate Code to Create JSON
// The following JSON is sent in the request body.
// {
// "processingOptions": {
// "donorOptions": {
// "defaultUpdateLogic": "update_all"
// }
// },
// "gifts": [
// {
// "amount": 150.25,
// "currencyIsoCode": "USD",
// "receivedDate": "2024-07-06",
// "donorCoverAmount": 0.25,
// "transactionStatus": "Unpaid",
// "commitmentId": "<SFDC_COMMITMENT_ID>",
// "paymentIdentifier": "1234",
// "gatewayTransactionFee": 0.75,
// "processorTransactionFee": 0.45,
// "processorReference": "cls-1247586928747",
// "gatewayReference": "102656693ac3ca6e0cdafbfe89ab99",
// "lastGatewayResponseCode": "invalid_cvc",
// "lastGatewayErrorMessage": "The card’s security code is invalid. Check the card’s security code or use a different card.",
// "lastGatewayProcessedDateTime": "2023-07-06T21:57:51Z",
// "campaign": {
// "id": "<SFDC_CAMPAIGN_ID>"
// },
// "outreachSourceCode": {
// "id": "<SFDC_OUTREACH_SOURCE_CODE_ID>",
// "sourceCode": "AnimalEmailCampaign2023"
// },
// "donor": {
// "donorType": "individual",
// "id": "<SFDC_PERSON_ACCOUNT_ID>",
// "organizationName": "<Organization_Name>",
// "firstName": "Test",
// "lastName": "Donor",
// "phone": "510-434-8920",
// "email": "test.user@example.com",
// "address": [
// {
// "addressType": "mailing",
// "street": "123 Main Street",
// "city": "Oakland",
// "state": "CA",
// "postalCode": "94610",
// "country": "US"
// }
// ],
// "accountCustomFields": [
// {
// "fieldName": "string",
// "fieldValue": "string"
// }
// ]
// },
// "paymentInstrument": {
// "type": "credit card",
// "accountHolderName": "test donor",
// "expiryMonth": "10",
// "expiryYear": "2027",
// "last4": "4585",
// "cardBrand": "visa",
// "bankName": "chase",
// "digitalWalletProvider": "apple pay",
// "bankAccountHolderType": "primary",
// "bankAccountType": "checking",
// "bankAccountNumber": "123456",
// "bankCode": "HBUK",
// "gatewayName": "stripe",
// "processorName": "test processor",
// "processorPaymentReference": "string",
// "gatewayReference": "string"
// },
// "designations": [
// {
// "designationId": "<SFDC_GIFT_DESIGNATION_ID>",
// "percent": 10,
// "amount": 150.25
// }
// ],
// "giftTransactionCustomFields": [
// {
// "fieldName": "string",
// "fieldValue": "string"
// }
// ]
// },
// {
// "amount": 250.00,
// "currencyIsoCode": "USD",
// "receivedDate": "2024-07-06",
// "donorCoverAmount": 0.25,
// "transactionStatus": "Unpaid",
// "commitmentId": "<SFDC_COMMITMENT_ID>",
// "paymentIdentifier": "1234",
// "gatewayTransactionFee": 0.75,
// "processorTransactionFee": 0.45,
// "processorReference": "cls-1247586928747",
// "gatewayReference": "102656693ac3ca6e0cdafbfe89ab99",
// "lastGatewayResponseCode": "invalid_cvc",
// "lastGatewayErrorMessage": "The card’s security code is invalid. Check the card’s security code or use a different card.",
// "lastGatewayProcessedDateTime": "2023-07-06T21:57:51Z",
// "campaign": {
// "id": "<SFDC_CAMPAIGN_ID>"
// },
// "outreachSourceCode": {
// "id": "<SFDC_OUTREACH_SOURCE_CODE_ID>",
// "sourceCode": "AnimalEmailCampaign2023"
// },
// "donor": {
// "donorType": "individual",
// "id": "<SFDC_PERSON_ACCOUNT_ID>",
// "organizationName": "<Organization_Name>",
// "firstName": "Test",
// "lastName": "Donor",
// "phone": "510-434-8920",
// "email": "test.user@example.com",
// "address": [
// {
// "addressType": "mailing",
// "street": "123 Main Street",
// "city": "Oakland",
// "state": "CA",
// "postalCode": "94610",
// "country": "US"
// }
// ],
// "accountCustomFields": [
// {
// "fieldName": "string",
// "fieldValue": "string"
// }
// ]
// },
// "paymentInstrument": {
// "type": "credit card",
// "accountHolderName": "test donor",
// "expiryMonth": "10",
// "expiryYear": "2027",
// "last4": "4585",
// "cardBrand": "visa",
// "bankName": "chase",
// "digitalWalletProvider": "apple pay",
// "bankAccountHolderType": "primary",
// "bankAccountType": "checking",
// "bankAccountNumber": "123456",
// "bankCode": "HBUK",
// "gatewayName": "stripe",
// "processorName": "test processor",
// "processorPaymentReference": "string",
// "gatewayReference": "string"
// },
// "designations": [
// {
// "designationId": "<SFDC_GIFT_DESIGNATION_ID>",
// "percent": 10,
// "amount": 150.25
// }
// ],
// "giftTransactionCustomFields": [
// {
// "fieldName": "string",
// "fieldValue": "string"
// }
// ]
// }
// ]
// }
loo_Json = create oleobject
// Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
li_rc = loo_Json.ConnectToNewObject("Chilkat.JsonObject")
loo_Json.UpdateString("processingOptions.donorOptions.defaultUpdateLogic","update_all")
loo_Json.UpdateNumber("gifts[0].amount","150.25")
loo_Json.UpdateString("gifts[0].currencyIsoCode","USD")
loo_Json.UpdateString("gifts[0].receivedDate","2024-07-06")
loo_Json.UpdateNumber("gifts[0].donorCoverAmount","0.25")
loo_Json.UpdateString("gifts[0].transactionStatus","Unpaid")
loo_Json.UpdateString("gifts[0].commitmentId","<SFDC_COMMITMENT_ID>")
loo_Json.UpdateString("gifts[0].paymentIdentifier","1234")
loo_Json.UpdateNumber("gifts[0].gatewayTransactionFee","0.75")
loo_Json.UpdateNumber("gifts[0].processorTransactionFee","0.45")
loo_Json.UpdateString("gifts[0].processorReference","cls-1247586928747")
loo_Json.UpdateString("gifts[0].gatewayReference","102656693ac3ca6e0cdafbfe89ab99")
loo_Json.UpdateString("gifts[0].lastGatewayResponseCode","invalid_cvc")
loo_Json.UpdateString("gifts[0].lastGatewayErrorMessage","The card’s security code is invalid. Check the card’s security code or use a different card.")
loo_Json.UpdateString("gifts[0].lastGatewayProcessedDateTime","2023-07-06T21:57:51Z")
loo_Json.UpdateString("gifts[0].campaign.id","<SFDC_CAMPAIGN_ID>")
loo_Json.UpdateString("gifts[0].outreachSourceCode.id","<SFDC_OUTREACH_SOURCE_CODE_ID>")
loo_Json.UpdateString("gifts[0].outreachSourceCode.sourceCode","AnimalEmailCampaign2023")
loo_Json.UpdateString("gifts[0].donor.donorType","individual")
loo_Json.UpdateString("gifts[0].donor.id","<SFDC_PERSON_ACCOUNT_ID>")
loo_Json.UpdateString("gifts[0].donor.organizationName","<Organization_Name>")
loo_Json.UpdateString("gifts[0].donor.firstName","Test")
loo_Json.UpdateString("gifts[0].donor.lastName","Donor")
loo_Json.UpdateString("gifts[0].donor.phone","510-434-8920")
loo_Json.UpdateString("gifts[0].donor.email","test.user@example.com")
loo_Json.UpdateString("gifts[0].donor.address[0].addressType","mailing")
loo_Json.UpdateString("gifts[0].donor.address[0].street","123 Main Street")
loo_Json.UpdateString("gifts[0].donor.address[0].city","Oakland")
loo_Json.UpdateString("gifts[0].donor.address[0].state","CA")
loo_Json.UpdateString("gifts[0].donor.address[0].postalCode","94610")
loo_Json.UpdateString("gifts[0].donor.address[0].country","US")
loo_Json.UpdateString("gifts[0].donor.accountCustomFields[0].fieldName","string")
loo_Json.UpdateString("gifts[0].donor.accountCustomFields[0].fieldValue","string")
loo_Json.UpdateString("gifts[0].paymentInstrument.type","credit card")
loo_Json.UpdateString("gifts[0].paymentInstrument.accountHolderName","test donor")
loo_Json.UpdateString("gifts[0].paymentInstrument.expiryMonth","10")
loo_Json.UpdateString("gifts[0].paymentInstrument.expiryYear","2027")
loo_Json.UpdateString("gifts[0].paymentInstrument.last4","4585")
loo_Json.UpdateString("gifts[0].paymentInstrument.cardBrand","visa")
loo_Json.UpdateString("gifts[0].paymentInstrument.bankName","chase")
loo_Json.UpdateString("gifts[0].paymentInstrument.digitalWalletProvider","apple pay")
loo_Json.UpdateString("gifts[0].paymentInstrument.bankAccountHolderType","primary")
loo_Json.UpdateString("gifts[0].paymentInstrument.bankAccountType","checking")
loo_Json.UpdateString("gifts[0].paymentInstrument.bankAccountNumber","123456")
loo_Json.UpdateString("gifts[0].paymentInstrument.bankCode","HBUK")
loo_Json.UpdateString("gifts[0].paymentInstrument.gatewayName","stripe")
loo_Json.UpdateString("gifts[0].paymentInstrument.processorName","test processor")
loo_Json.UpdateString("gifts[0].paymentInstrument.processorPaymentReference","string")
loo_Json.UpdateString("gifts[0].paymentInstrument.gatewayReference","string")
loo_Json.UpdateString("gifts[0].designations[0].designationId","<SFDC_GIFT_DESIGNATION_ID>")
loo_Json.UpdateInt("gifts[0].designations[0].percent",10)
loo_Json.UpdateNumber("gifts[0].designations[0].amount","150.25")
loo_Json.UpdateString("gifts[0].giftTransactionCustomFields[0].fieldName","string")
loo_Json.UpdateString("gifts[0].giftTransactionCustomFields[0].fieldValue","string")
loo_Json.UpdateNumber("gifts[1].amount","250.00")
loo_Json.UpdateString("gifts[1].currencyIsoCode","USD")
loo_Json.UpdateString("gifts[1].receivedDate","2024-07-06")
loo_Json.UpdateNumber("gifts[1].donorCoverAmount","0.25")
loo_Json.UpdateString("gifts[1].transactionStatus","Unpaid")
loo_Json.UpdateString("gifts[1].commitmentId","<SFDC_COMMITMENT_ID>")
loo_Json.UpdateString("gifts[1].paymentIdentifier","1234")
loo_Json.UpdateNumber("gifts[1].gatewayTransactionFee","0.75")
loo_Json.UpdateNumber("gifts[1].processorTransactionFee","0.45")
loo_Json.UpdateString("gifts[1].processorReference","cls-1247586928747")
loo_Json.UpdateString("gifts[1].gatewayReference","102656693ac3ca6e0cdafbfe89ab99")
loo_Json.UpdateString("gifts[1].lastGatewayResponseCode","invalid_cvc")
loo_Json.UpdateString("gifts[1].lastGatewayErrorMessage","The card’s security code is invalid. Check the card’s security code or use a different card.")
loo_Json.UpdateString("gifts[1].lastGatewayProcessedDateTime","2023-07-06T21:57:51Z")
loo_Json.UpdateString("gifts[1].campaign.id","<SFDC_CAMPAIGN_ID>")
loo_Json.UpdateString("gifts[1].outreachSourceCode.id","<SFDC_OUTREACH_SOURCE_CODE_ID>")
loo_Json.UpdateString("gifts[1].outreachSourceCode.sourceCode","AnimalEmailCampaign2023")
loo_Json.UpdateString("gifts[1].donor.donorType","individual")
loo_Json.UpdateString("gifts[1].donor.id","<SFDC_PERSON_ACCOUNT_ID>")
loo_Json.UpdateString("gifts[1].donor.organizationName","<Organization_Name>")
loo_Json.UpdateString("gifts[1].donor.firstName","Test")
loo_Json.UpdateString("gifts[1].donor.lastName","Donor")
loo_Json.UpdateString("gifts[1].donor.phone","510-434-8920")
loo_Json.UpdateString("gifts[1].donor.email","test.user@example.com")
loo_Json.UpdateString("gifts[1].donor.address[0].addressType","mailing")
loo_Json.UpdateString("gifts[1].donor.address[0].street","123 Main Street")
loo_Json.UpdateString("gifts[1].donor.address[0].city","Oakland")
loo_Json.UpdateString("gifts[1].donor.address[0].state","CA")
loo_Json.UpdateString("gifts[1].donor.address[0].postalCode","94610")
loo_Json.UpdateString("gifts[1].donor.address[0].country","US")
loo_Json.UpdateString("gifts[1].donor.accountCustomFields[0].fieldName","string")
loo_Json.UpdateString("gifts[1].donor.accountCustomFields[0].fieldValue","string")
loo_Json.UpdateString("gifts[1].paymentInstrument.type","credit card")
loo_Json.UpdateString("gifts[1].paymentInstrument.accountHolderName","test donor")
loo_Json.UpdateString("gifts[1].paymentInstrument.expiryMonth","10")
loo_Json.UpdateString("gifts[1].paymentInstrument.expiryYear","2027")
loo_Json.UpdateString("gifts[1].paymentInstrument.last4","4585")
loo_Json.UpdateString("gifts[1].paymentInstrument.cardBrand","visa")
loo_Json.UpdateString("gifts[1].paymentInstrument.bankName","chase")
loo_Json.UpdateString("gifts[1].paymentInstrument.digitalWalletProvider","apple pay")
loo_Json.UpdateString("gifts[1].paymentInstrument.bankAccountHolderType","primary")
loo_Json.UpdateString("gifts[1].paymentInstrument.bankAccountType","checking")
loo_Json.UpdateString("gifts[1].paymentInstrument.bankAccountNumber","123456")
loo_Json.UpdateString("gifts[1].paymentInstrument.bankCode","HBUK")
loo_Json.UpdateString("gifts[1].paymentInstrument.gatewayName","stripe")
loo_Json.UpdateString("gifts[1].paymentInstrument.processorName","test processor")
loo_Json.UpdateString("gifts[1].paymentInstrument.processorPaymentReference","string")
loo_Json.UpdateString("gifts[1].paymentInstrument.gatewayReference","string")
loo_Json.UpdateString("gifts[1].designations[0].designationId","<SFDC_GIFT_DESIGNATION_ID>")
loo_Json.UpdateInt("gifts[1].designations[0].percent",10)
loo_Json.UpdateNumber("gifts[1].designations[0].amount","150.25")
loo_Json.UpdateString("gifts[1].giftTransactionCustomFields[0].fieldName","string")
loo_Json.UpdateString("gifts[1].giftTransactionCustomFields[0].fieldValue","string")
// Adds the "Authorization: Bearer <access_token>" header.
loo_Http.AuthToken = "<access_token>"
loo_Resp = loo_Http.PostJson3("https://domain.com/services/data/v{{version}}/connect/fundraising/gifts","application/json",loo_Json)
if loo_Http.LastMethodSuccess = 0 then
Write-Debug loo_Http.LastErrorText
destroy loo_Http
destroy loo_Json
return
end if
loo_SbResponseBody = create oleobject
// Use "Chilkat_9_5_0.StringBuilder" for versions of Chilkat < 10.0.0
li_rc = loo_SbResponseBody.ConnectToNewObject("Chilkat.StringBuilder")
loo_Resp.GetBodySb(loo_SbResponseBody)
loo_JResp = create oleobject
// Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
li_rc = loo_JResp.ConnectToNewObject("Chilkat.JsonObject")
loo_JResp.LoadSb(loo_SbResponseBody)
loo_JResp.EmitCompact = 0
Write-Debug "Response Body:"
Write-Debug loo_JResp.Emit()
li_RespStatusCode = loo_Resp.StatusCode
Write-Debug "Response Status Code = " + string(li_RespStatusCode)
if li_RespStatusCode >= 400 then
Write-Debug "Response Header:"
Write-Debug loo_Resp.Header
Write-Debug "Failed."
destroy loo_Resp
destroy loo_Http
destroy loo_Json
destroy loo_SbResponseBody
destroy loo_JResp
return
end if
destroy loo_Resp
// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)
// {
// "successes": 2,
// "failures": 0,
// "notProcessed": 0,
// "details": [
// {
// "success": true,
// "links": {
// "account": {
// "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_ACCOUNT_ID>",
// "id": "<SFDC_ACCOUNT_ID>"
// },
// "gifttransaction": {
// "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_ID>",
// "id": "<SFDC_GIFT_TRANSACTION_ID>"
// },
// "giftcommitment": {
// "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_ID>",
// "id": "<SFDC_GIFT_COMMITMENT_ID>"
// },
// "paymentinstrument": {
// "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_PAYMENT_INSTRUMENT_ID>",
// "id": "<SFDC_PAYMENT_INSTRUMENT_ID>"
// },
// "gifttransactiondesignation": [
// {
// "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_DESIGNATION_ID>",
// "id": "<SFDC_GIFT_TRANSACTION_DESIGNATION_ID>"
// }
// ]
// }
// },
// {
// "success": true,
// "links": {
// "account": {
// "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_ACCOUNT_ID>",
// "id": "<SFDC_ACCOUNT_ID>"
// },
// "gifttransaction": {
// "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_ID>",
// "id": "<SFDC_GIFT_TRANSACTION_ID>"
// },
// "giftcommitment": {
// "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_ID>",
// "id": "<SFDC_GIFT_COMMITMENT_ID>"
// },
// "paymentinstrument": {
// "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_PAYMENT_INSTRUMENT_ID>",
// "id": "<SFDC_PAYMENT_INSTRUMENT_ID>"
// },
// "gifttransactiondesignation": [
// {
// "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_DESIGNATION_ID>",
// "id": "<SFDC_GIFT_TRANSACTION_DESIGNATION_ID>"
// }
// ]
// }
// }
// ]
// }
// Sample code for parsing the JSON response...
// Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code
li_Successes = loo_JResp.IntOf("successes")
li_Failures = loo_JResp.IntOf("failures")
li_NotProcessed = loo_JResp.IntOf("notProcessed")
i = 0
li_Count_i = loo_JResp.SizeOfArray("details")
do while i < li_Count_i
loo_JResp.I = i
li_Success = loo_JResp.BoolOf("details[i].success")
ls_Href = loo_JResp.StringOf("details[i].links.account.href")
ls_Id = loo_JResp.StringOf("details[i].links.account.id")
ls_GifttransactionHref = loo_JResp.StringOf("details[i].links.gifttransaction.href")
ls_GifttransactionId = loo_JResp.StringOf("details[i].links.gifttransaction.id")
ls_GiftcommitmentHref = loo_JResp.StringOf("details[i].links.giftcommitment.href")
ls_GiftcommitmentId = loo_JResp.StringOf("details[i].links.giftcommitment.id")
ls_PaymentinstrumentHref = loo_JResp.StringOf("details[i].links.paymentinstrument.href")
ls_PaymentinstrumentId = loo_JResp.StringOf("details[i].links.paymentinstrument.id")
j = 0
li_Count_j = loo_JResp.SizeOfArray("details[i].links.gifttransactiondesignation")
do while j < li_Count_j
loo_JResp.J = j
ls_Href = loo_JResp.StringOf("details[i].links.gifttransactiondesignation[j].href")
ls_Id = loo_JResp.StringOf("details[i].links.gifttransactiondesignation[j].id")
j = j + 1
loop
i = i + 1
loop
destroy loo_Http
destroy loo_Json
destroy loo_SbResponseBody
destroy loo_JResp
Curl Command
curl -X POST
-H "Authorization: Bearer <access_token>"
-d '{
"processingOptions": {
"donorOptions": {
"defaultUpdateLogic": "update_all"
}
},
"gifts": [
{
"amount": 150.25,
"currencyIsoCode": "USD",
"receivedDate": "2024-07-06",
"donorCoverAmount": 0.25,
"transactionStatus": "Unpaid",
"commitmentId": "<SFDC_COMMITMENT_ID>",
"paymentIdentifier": "1234",
"gatewayTransactionFee": 0.75,
"processorTransactionFee": 0.45,
"processorReference": "cls-1247586928747",
"gatewayReference": "102656693ac3ca6e0cdafbfe89ab99",
"lastGatewayResponseCode": "invalid_cvc",
"lastGatewayErrorMessage": "The card’s security code is invalid. Check the card’s security code or use a different card.",
"lastGatewayProcessedDateTime": "2023-07-06T21:57:51Z",
"campaign": {
"id": "<SFDC_CAMPAIGN_ID>"
},
"outreachSourceCode": {
"id": "<SFDC_OUTREACH_SOURCE_CODE_ID>",
"sourceCode": "AnimalEmailCampaign2023"
},
"donor": {
"donorType": "individual",
"id": "<SFDC_PERSON_ACCOUNT_ID>",
"organizationName": "<Organization_Name>",
"firstName": "Test",
"lastName": "Donor",
"phone": "510-434-8920",
"email": "test.user@example.com",
"address": [
{
"addressType": "mailing",
"street": "123 Main Street",
"city": "Oakland",
"state": "CA",
"postalCode": "94610",
"country": "US"
}
],
"accountCustomFields": [
{
"fieldName": "string",
"fieldValue": "string"
}
]
},
"paymentInstrument": {
"type": "credit card",
"accountHolderName": "test donor",
"expiryMonth": "10",
"expiryYear": "2027",
"last4": "4585",
"cardBrand": "visa",
"bankName": "chase",
"digitalWalletProvider": "apple pay",
"bankAccountHolderType": "primary",
"bankAccountType": "checking",
"bankAccountNumber": "123456",
"bankCode": "HBUK",
"gatewayName": "stripe",
"processorName": "test processor",
"processorPaymentReference": "string",
"gatewayReference": "string"
},
"designations": [
{
"designationId": "<SFDC_GIFT_DESIGNATION_ID>",
"percent": 10,
"amount": 150.25
}
],
"giftTransactionCustomFields": [
{
"fieldName": "string",
"fieldValue": "string"
}
]
},
{
"amount": 250.00,
"currencyIsoCode": "USD",
"receivedDate": "2024-07-06",
"donorCoverAmount": 0.25,
"transactionStatus": "Unpaid",
"commitmentId": "<SFDC_COMMITMENT_ID>",
"paymentIdentifier": "1234",
"gatewayTransactionFee": 0.75,
"processorTransactionFee": 0.45,
"processorReference": "cls-1247586928747",
"gatewayReference": "102656693ac3ca6e0cdafbfe89ab99",
"lastGatewayResponseCode": "invalid_cvc",
"lastGatewayErrorMessage": "The card’s security code is invalid. Check the card’s security code or use a different card.",
"lastGatewayProcessedDateTime": "2023-07-06T21:57:51Z",
"campaign": {
"id": "<SFDC_CAMPAIGN_ID>"
},
"outreachSourceCode": {
"id": "<SFDC_OUTREACH_SOURCE_CODE_ID>",
"sourceCode": "AnimalEmailCampaign2023"
},
"donor": {
"donorType": "individual",
"id": "<SFDC_PERSON_ACCOUNT_ID>",
"organizationName": "<Organization_Name>",
"firstName": "Test",
"lastName": "Donor",
"phone": "510-434-8920",
"email": "test.user@example.com",
"address": [
{
"addressType": "mailing",
"street": "123 Main Street",
"city": "Oakland",
"state": "CA",
"postalCode": "94610",
"country": "US"
}
],
"accountCustomFields": [
{
"fieldName": "string",
"fieldValue": "string"
}
]
},
"paymentInstrument": {
"type": "credit card",
"accountHolderName": "test donor",
"expiryMonth": "10",
"expiryYear": "2027",
"last4": "4585",
"cardBrand": "visa",
"bankName": "chase",
"digitalWalletProvider": "apple pay",
"bankAccountHolderType": "primary",
"bankAccountType": "checking",
"bankAccountNumber": "123456",
"bankCode": "HBUK",
"gatewayName": "stripe",
"processorName": "test processor",
"processorPaymentReference": "string",
"gatewayReference": "string"
},
"designations": [
{
"designationId": "<SFDC_GIFT_DESIGNATION_ID>",
"percent": 10,
"amount": 150.25
}
],
"giftTransactionCustomFields": [
{
"fieldName": "string",
"fieldValue": "string"
}
]
}
]
}'
https://domain.com/services/data/v{{version}}/connect/fundraising/gifts
Postman Collection Item JSON
{
"name": "Create Gifts",
"protocolProfileBehavior": {
"followAuthorizationHeader": true
},
"request": {
"method": "POST",
"header": [
],
"body": {
"mode": "raw",
"raw": "{\n \"processingOptions\": {\n \"donorOptions\": {\n \"defaultUpdateLogic\": \"update_all\"\n }\n },\n \"gifts\": [\n {\n \"amount\": 150.25,\n \"currencyIsoCode\": \"USD\",\n \"receivedDate\": \"2024-07-06\",\n \"donorCoverAmount\": 0.25,\n \"transactionStatus\": \"Unpaid\",\n \"commitmentId\": \"<SFDC_COMMITMENT_ID>\",\n \"paymentIdentifier\": \"1234\",\n \"gatewayTransactionFee\": 0.75,\n \"processorTransactionFee\": 0.45,\n \"processorReference\": \"cls-1247586928747\",\n \"gatewayReference\": \"102656693ac3ca6e0cdafbfe89ab99\",\n \"lastGatewayResponseCode\": \"invalid_cvc\",\n \"lastGatewayErrorMessage\": \"The card’s security code is invalid. Check the card’s security code or use a different card.\",\n \"lastGatewayProcessedDateTime\": \"2023-07-06T21:57:51Z\",\n \"campaign\": {\n \"id\": \"<SFDC_CAMPAIGN_ID>\"\n },\n \"outreachSourceCode\": {\n \"id\": \"<SFDC_OUTREACH_SOURCE_CODE_ID>\",\n \"sourceCode\": \"AnimalEmailCampaign2023\"\n },\n \"donor\": {\n \"donorType\": \"individual\",\n \"id\": \"<SFDC_PERSON_ACCOUNT_ID>\",\n \"organizationName\": \"<Organization_Name>\",\n \"firstName\": \"Test\",\n \"lastName\": \"Donor\",\n \"phone\": \"510-434-8920\",\n \"email\": \"test.user@example.com\",\n \"address\": [\n {\n \"addressType\": \"mailing\",\n \"street\": \"123 Main Street\",\n \"city\": \"Oakland\",\n \"state\": \"CA\",\n \"postalCode\": \"94610\",\n \"country\": \"US\"\n }\n ],\n \"accountCustomFields\": [\n {\n \"fieldName\": \"string\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n \"paymentInstrument\": {\n \"type\": \"credit card\",\n \"accountHolderName\": \"test donor\",\n \"expiryMonth\": \"10\",\n \"expiryYear\": \"2027\",\n \"last4\": \"4585\",\n \"cardBrand\": \"visa\",\n \"bankName\": \"chase\",\n \"digitalWalletProvider\": \"apple pay\",\n \"bankAccountHolderType\": \"primary\",\n \"bankAccountType\": \"checking\",\n \"bankAccountNumber\": \"123456\",\n \"bankCode\": \"HBUK\",\n \"gatewayName\": \"stripe\",\n \"processorName\": \"test processor\",\n \"processorPaymentReference\": \"string\",\n \"gatewayReference\": \"string\"\n },\n \"designations\": [\n {\n \"designationId\": \"<SFDC_GIFT_DESIGNATION_ID>\",\n \"percent\": 10,\n \"amount\": 150.25\n }\n ],\n \"giftTransactionCustomFields\": [\n {\n \"fieldName\": \"string\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n {\n \"amount\": 250.00,\n \"currencyIsoCode\": \"USD\",\n \"receivedDate\": \"2024-07-06\",\n \"donorCoverAmount\": 0.25,\n \"transactionStatus\": \"Unpaid\",\n \"commitmentId\": \"<SFDC_COMMITMENT_ID>\",\n \"paymentIdentifier\": \"1234\",\n \"gatewayTransactionFee\": 0.75,\n \"processorTransactionFee\": 0.45,\n \"processorReference\": \"cls-1247586928747\",\n \"gatewayReference\": \"102656693ac3ca6e0cdafbfe89ab99\",\n \"lastGatewayResponseCode\": \"invalid_cvc\",\n \"lastGatewayErrorMessage\": \"The card’s security code is invalid. Check the card’s security code or use a different card.\",\n \"lastGatewayProcessedDateTime\": \"2023-07-06T21:57:51Z\",\n \"campaign\": {\n \"id\": \"<SFDC_CAMPAIGN_ID>\"\n },\n \"outreachSourceCode\": {\n \"id\": \"<SFDC_OUTREACH_SOURCE_CODE_ID>\",\n \"sourceCode\": \"AnimalEmailCampaign2023\"\n },\n \"donor\": {\n \"donorType\": \"individual\",\n \"id\": \"<SFDC_PERSON_ACCOUNT_ID>\",\n \"organizationName\": \"<Organization_Name>\",\n \"firstName\": \"Test\",\n \"lastName\": \"Donor\",\n \"phone\": \"510-434-8920\",\n \"email\": \"test.user@example.com\",\n \"address\": [\n {\n \"addressType\": \"mailing\",\n \"street\": \"123 Main Street\",\n \"city\": \"Oakland\",\n \"state\": \"CA\",\n \"postalCode\": \"94610\",\n \"country\": \"US\"\n }\n ],\n \"accountCustomFields\": [\n {\n \"fieldName\": \"string\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n \"paymentInstrument\": {\n \"type\": \"credit card\",\n \"accountHolderName\": \"test donor\",\n \"expiryMonth\": \"10\",\n \"expiryYear\": \"2027\",\n \"last4\": \"4585\",\n \"cardBrand\": \"visa\",\n \"bankName\": \"chase\",\n \"digitalWalletProvider\": \"apple pay\",\n \"bankAccountHolderType\": \"primary\",\n \"bankAccountType\": \"checking\",\n \"bankAccountNumber\": \"123456\",\n \"bankCode\": \"HBUK\",\n \"gatewayName\": \"stripe\",\n \"processorName\": \"test processor\",\n \"processorPaymentReference\": \"string\",\n \"gatewayReference\": \"string\"\n },\n \"designations\": [\n {\n \"designationId\": \"<SFDC_GIFT_DESIGNATION_ID>\",\n \"percent\": 10,\n \"amount\": 150.25\n }\n ],\n \"giftTransactionCustomFields\": [\n {\n \"fieldName\": \"string\",\n \"fieldValue\": \"string\"\n }\n ]\n }\n ]\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{_endpoint}}/services/data/v{{version}}/connect/fundraising/gifts",
"host": [
"{{_endpoint}}"
],
"path": [
"services",
"data",
"v{{version}}",
"connect",
"fundraising",
"gifts"
]
},
"description": "Create gift transactions with related new or matched donor, optional transaction designations, and payment instrument metadata. Supports custom fields for the donor account and gift transaction.\n\n## Required Attributes:\n\n- donor.donorType (\"individual\" or \"organization\")\n \n- donor.lastName || donor.organizationName\n \n- gift.amount\n \n- gift.receivedDate\n \n- git.status\n \n- paymentInstrument.type\n \n\nAll other attributes are optional can be left as an empty string or just removed from the request body entirely. The only exceptions to this are:\n\n- CustomFields collections - These cannot be left in the request body as an empty collection or with an empty string for the FieldName.\n \n\n## Validated Property Formats (an empty string is considered valid)\n\n- DateTime - YYYY-MM-DDTHH:MM:SSZ\n \n- Date - YYYY-MM-DD\n \n- Email - a valid formatted email address\n \n\n### Other Attributes:\n\n- OutreachSource -- This is optional. Be sure to create the OutreachSourceCode record in the system if passing a value\n \n- Will accept either an OutreachSourceCode.id (SalesforceId) or an OutreachSourceCode.Code.\n \n\n### Custom Fields:\n\n- The field_value can be a text string (inc. for a date data-type) or a numeric value (without quotes)\n \n- Do not include an empty collection or an empty fieldName in the request body"
},
"response": [
{
"name": "Status201-CreateGiftSuccess",
"originalRequest": {
"method": "POST",
"header": [
],
"body": {
"mode": "raw",
"raw": "{\n \"processingOptions\": {\n \"donorOptions\": {\n \"defaultUpdateLogic\": \"update_all\"\n }\n },\n \"gifts\": [\n {\n \"amount\": 150.25,\n \"currencyIsoCode\": \"USD\",\n \"receivedDate\": \"2024-07-06\",\n \"donorCoverAmount\": 0.25,\n \"transactionStatus\": \"Unpaid\",\n \"commitmentId\": \"<SFDC_COMMITMENT_ID>\",\n \"paymentIdentifier\": \"1234\",\n \"gatewayTransactionFee\": 0.75,\n \"processorTransactionFee\": 0.45,\n \"processorReference\": \"cls-1247586928747\",\n \"gatewayReference\": \"102656693ac3ca6e0cdafbfe89ab99\",\n \"lastGatewayResponseCode\": \"invalid_cvc\",\n \"lastGatewayErrorMessage\": \"The card’s security code is invalid. Check the card’s security code or use a different card.\",\n \"lastGatewayProcessedDateTime\": \"2023-07-06T21:57:51Z\",\n \"campaign\": {\n \"id\": \"<SFDC_CAMPAIGN_ID>\"\n },\n \"outreachSourceCode\": {\n \"id\": \"<SFDC_OUTREACH_SOURCE_CODE_ID>\",\n \"sourceCode\": \"AnimalEmailCampaign2023\"\n },\n \"donor\": {\n \"donorType\": \"individual\",\n \"id\": \"<SFDC_PERSON_ACCOUNT_ID>\",\n \"organizationName\": \"<Organization_Name>\",\n \"firstName\": \"Test\",\n \"lastName\": \"Donor\",\n \"phone\": \"510-434-8920\",\n \"email\": \"test.user@example.com\",\n \"address\": [\n {\n \"addressType\": \"mailing\",\n \"street\": \"123 Main Street\",\n \"city\": \"Oakland\",\n \"state\": \"CA\",\n \"postalCode\": \"94610\",\n \"country\": \"US\"\n }\n ],\n \"accountCustomFields\": [\n {\n \"fieldName\": \"string\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n \"paymentInstrument\": {\n \"type\": \"credit card\",\n \"accountHolderName\": \"test donor\",\n \"expiryMonth\": \"10\",\n \"expiryYear\": \"2027\",\n \"last4\": \"4585\",\n \"cardBrand\": \"visa\",\n \"bankName\": \"chase\",\n \"digitalWalletProvider\": \"apple pay\",\n \"bankAccountHolderType\": \"primary\",\n \"bankAccountType\": \"checking\",\n \"bankAccountNumber\": \"123456\",\n \"bankCode\": \"HBUK\",\n \"gatewayName\": \"stripe\",\n \"processorName\": \"test processor\",\n \"processorPaymentReference\": \"string\",\n \"gatewayReference\": \"string\"\n },\n \"designations\": [\n {\n \"designationId\": \"<SFDC_GIFT_DESIGNATION_ID>\",\n \"percent\": 10,\n \"amount\": 150.25\n }\n ],\n \"giftTransactionCustomFields\": [\n {\n \"fieldName\": \"string\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n {\n \"amount\": 250.00,\n \"currencyIsoCode\": \"USD\",\n \"receivedDate\": \"2024-07-06\",\n \"donorCoverAmount\": 0.25,\n \"transactionStatus\": \"Unpaid\",\n \"commitmentId\": \"<SFDC_COMMITMENT_ID>\",\n \"paymentIdentifier\": \"1234\",\n \"gatewayTransactionFee\": 0.75,\n \"processorTransactionFee\": 0.45,\n \"processorReference\": \"cls-1247586928747\",\n \"gatewayReference\": \"102656693ac3ca6e0cdafbfe89ab99\",\n \"lastGatewayResponseCode\": \"invalid_cvc\",\n \"lastGatewayErrorMessage\": \"The card’s security code is invalid. Check the card’s security code or use a different card.\",\n \"lastGatewayProcessedDateTime\": \"2023-07-06T21:57:51Z\",\n \"campaign\": {\n \"id\": \"<SFDC_CAMPAIGN_ID>\"\n },\n \"outreachSourceCode\": {\n \"id\": \"<SFDC_OUTREACH_SOURCE_CODE_ID>\",\n \"sourceCode\": \"AnimalEmailCampaign2023\"\n },\n \"donor\": {\n \"donorType\": \"individual\",\n \"id\": \"<SFDC_PERSON_ACCOUNT_ID>\",\n \"organizationName\": \"<Organization_Name>\",\n \"firstName\": \"Test\",\n \"lastName\": \"Donor\",\n \"phone\": \"510-434-8920\",\n \"email\": \"test.user@example.com\",\n \"address\": [\n {\n \"addressType\": \"mailing\",\n \"street\": \"123 Main Street\",\n \"city\": \"Oakland\",\n \"state\": \"CA\",\n \"postalCode\": \"94610\",\n \"country\": \"US\"\n }\n ],\n \"accountCustomFields\": [\n {\n \"fieldName\": \"string\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n \"paymentInstrument\": {\n \"type\": \"credit card\",\n \"accountHolderName\": \"test donor\",\n \"expiryMonth\": \"10\",\n \"expiryYear\": \"2027\",\n \"last4\": \"4585\",\n \"cardBrand\": \"visa\",\n \"bankName\": \"chase\",\n \"digitalWalletProvider\": \"apple pay\",\n \"bankAccountHolderType\": \"primary\",\n \"bankAccountType\": \"checking\",\n \"bankAccountNumber\": \"123456\",\n \"bankCode\": \"HBUK\",\n \"gatewayName\": \"stripe\",\n \"processorName\": \"test processor\",\n \"processorPaymentReference\": \"string\",\n \"gatewayReference\": \"string\"\n },\n \"designations\": [\n {\n \"designationId\": \"<SFDC_GIFT_DESIGNATION_ID>\",\n \"percent\": 10,\n \"amount\": 150.25\n }\n ],\n \"giftTransactionCustomFields\": [\n {\n \"fieldName\": \"string\",\n \"fieldValue\": \"string\"\n }\n ]\n }\n ]\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{_endpoint}}/services/data/v{{version}}/connect/fundraising/gifts",
"host": [
"{{_endpoint}}"
],
"path": [
"services",
"data",
"v{{version}}",
"connect",
"fundraising",
"gifts"
]
}
},
"status": "Created",
"code": 201,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"description": ""
}
],
"cookie": [
],
"body": "{\n \"successes\": 2,\n \"failures\": 0,\n \"notProcessed\": 0,\n \"details\": [\n {\n \"success\": true,\n \"links\": {\n \"account\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_ACCOUNT_ID>\",\n \"id\": \"<SFDC_ACCOUNT_ID>\"\n },\n \"gifttransaction\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_ID>\",\n \"id\": \"<SFDC_GIFT_TRANSACTION_ID>\"\n },\n \"giftcommitment\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_ID>\",\n \"id\": \"<SFDC_GIFT_COMMITMENT_ID>\"\n },\n \"paymentinstrument\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_PAYMENT_INSTRUMENT_ID>\",\n \"id\": \"<SFDC_PAYMENT_INSTRUMENT_ID>\"\n },\n \"gifttransactiondesignation\": [\n {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_DESIGNATION_ID>\",\n \"id\": \"<SFDC_GIFT_TRANSACTION_DESIGNATION_ID>\"\n }\n ]\n }\n },\n {\n \"success\": true,\n \"links\": {\n \"account\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_ACCOUNT_ID>\",\n \"id\": \"<SFDC_ACCOUNT_ID>\"\n },\n \"gifttransaction\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_ID>\",\n \"id\": \"<SFDC_GIFT_TRANSACTION_ID>\"\n },\n \"giftcommitment\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_ID>\",\n \"id\": \"<SFDC_GIFT_COMMITMENT_ID>\"\n },\n \"paymentinstrument\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_PAYMENT_INSTRUMENT_ID>\",\n \"id\": \"<SFDC_PAYMENT_INSTRUMENT_ID>\"\n },\n \"gifttransactiondesignation\": [\n {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_DESIGNATION_ID>\",\n \"id\": \"<SFDC_GIFT_TRANSACTION_DESIGNATION_ID>\"\n }\n ]\n }\n }\n ]\n}"
},
{
"name": "Status201-CreateGiftRequestValidationFailure",
"originalRequest": {
"method": "POST",
"header": [
],
"body": {
"mode": "raw",
"raw": "{\n \"processingOptions\": {\n \"donorOptions\": {\n \"defaultUpdateLogic\": \"update_all\"\n }\n },\n \"gifts\": [\n {\n \"amount\": 150.25,\n \"currencyIsoCode\": \"USD\",\n \"receivedDate\": \"2024-07-06\",\n \"donorCoverAmount\": 0.25,\n \"transactionStatus\": \"Unpaid\",\n \"commitmentId\": \"123456\",\n \"paymentIdentifier\": \"1234\",\n \"gatewayTransactionFee\": 0.75,\n \"processorTransactionFee\": 0.45,\n \"processorReference\": \"cls-1247586928747\",\n \"gatewayReference\": \"102656693ac3ca6e0cdafbfe89ab99\",\n \"lastGatewayResponseCode\": \"invalid_cvc\",\n \"lastGatewayErrorMessage\": \"The card’s security code is invalid. Check the card’s security code or use a different card.\",\n \"lastGatewayProcessedDateTime\": \"2023-07-06T21:57:51Z\",\n \"campaign\": {\n \"id\": \"<SFDC_CAMPAIGN_ID>\"\n },\n \"outreachSourceCode\": {\n \"id\": \"<SFDC_OUTREACH_SOURCE_CODE_ID>\",\n \"sourceCode\": \"AnimalEmailCampaign2023\"\n },\n \"donor\": {\n \"donorType\": \"individual\",\n \"id\": \"<SFDC_PERSON_ACCOUNT_ID>\",\n \"firstName\": \"Test\",\n \"lastName\": \"Donor\",\n \"phone\": \"510-434-8920\",\n \"email\": \"test.user@example.com\",\n \"address\": [\n {\n \"addressType\": \"mailing\",\n \"street\": \"123 Main Street\",\n \"city\": \"Oakland\",\n \"state\": \"CA\",\n \"postalCode\": \"94610\",\n \"country\": \"US\"\n }\n ],\n \"accountCustomFields\": [\n {\n \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n \"paymentInstrument\": {\n \"type\": \"credit card\",\n \"accountHolderName\": \"test donor\",\n \"expiryMonth\": \"10\",\n \"expiryYear\": \"2027\",\n \"last4\": \"4585\",\n \"cardBrand\": \"visa\",\n \"bankName\": \"chase\",\n \"digitalWalletProvider\": \"apple pay\",\n \"bankAccountHolderType\": \"primary\",\n \"bankAccountType\": \"checking\",\n \"bankAccountNumber\": \"123456\",\n \"bankCode\": \"HBUK\",\n \"gatewayName\": \"stripe\",\n \"processorName\": \"test processor\",\n \"processorPaymentReference\": \"string\",\n \"gatewayReference\": \"string\"\n },\n \"designations\": [\n {\n \"designationId\": \"<SFDC_GIFT_DESIGNATION_ID>\",\n \"percent\": 10\n }\n ],\n \"giftTransactionCustomFields\": [\n {\n \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n {\n \"amount\": 300.00,\n \"currencyIsoCode\": \"USD\",\n \"receivedDate\": \"2024-07-06\",\n \"donorCoverAmount\": 0.25,\n \"transactionStatus\": \"Unpaid\",\n \"commitmentId\": \"<SFDC_GIFT_COMMITMENT_ID>\",\n \"paymentIdentifier\": \"1234\",\n \"gatewayTransactionFee\": 0.75,\n \"processorTransactionFee\": 0.45,\n \"processorReference\": \"cls-1247586928747\",\n \"gatewayReference\": \"102656693ac3ca6e0cdafbfe89ab99\",\n \"lastGatewayResponseCode\": \"invalid_cvc\",\n \"lastGatewayErrorMessage\": \"The card’s security code is invalid. Check the card’s security code or use a different card.\",\n \"lastGatewayProcessedDateTime\": \"2023-07-06T21:57:51Z\",\n \"campaign\": {\n \"id\": \"<SFDC_CAMPAIGN_ID>\"\n },\n \"outreachSourceCode\": {\n \"id\": \"<SFDC_OUTREACH_SOURCE_CODE_ID>\",\n \"sourceCode\": \"AnimalEmailCampaign2023\"\n },\n \"donor\": {\n \"donorType\": \"individual\",\n \"id\": \"<SFDC_PERSON_ACCOUNT_ID>\",\n \"firstName\": \"Test\",\n \"lastName\": \"Donor\",\n \"phone\": \"510-434-8920\",\n \"email\": \"test.user@example.com\",\n \"address\": [\n {\n \"addressType\": \"mailing\",\n \"street\": \"123 Main Street\",\n \"city\": \"Oakland\",\n \"state\": \"CA\",\n \"postalCode\": \"94610\",\n \"country\": \"US\"\n }\n ],\n \"accountCustomFields\": [\n {\n \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n \"paymentInstrument\": {\n \"type\": \"credit card\",\n \"accountHolderName\": \"test donor\",\n \"expiryMonth\": \"10\",\n \"expiryYear\": \"2027\",\n \"last4\": \"4585\",\n \"cardBrand\": \"visa\",\n \"bankName\": \"chase\",\n \"digitalWalletProvider\": \"apple pay\",\n \"bankAccountHolderType\": \"primary\",\n \"bankAccountType\": \"checking\",\n \"bankAccountNumber\": \"123456\",\n \"bankCode\": \"HBUK\",\n \"gatewayName\": \"stripe\",\n \"processorName\": \"test processor\",\n \"processorPaymentReference\": \"string\",\n \"gatewayReference\": \"string\"\n },\n \"designations\": [\n {\n \"designationId\": \"<SFDC_GIFT_DESIGNATION_ID>\",\n \"percent\": 10\n }\n ],\n \"giftTransactionCustomFields\": [\n {\n \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n \"fieldValue\": \"string\"\n }\n ]\n }\n ]\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{_endpoint}}/services/data/v{{version}}/connect/fundraising/gifts",
"host": [
"{{_endpoint}}"
],
"path": [
"services",
"data",
"v{{version}}",
"connect",
"fundraising",
"gifts"
]
}
},
"status": "Created",
"code": 201,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"description": ""
}
],
"cookie": [
],
"body": "{\n \"successes\": 1,\n \"failures\": 1,\n \"notProcessed\": 0,\n \"details\": [\n {\n \"success\": false,\n \"errors\": {\n \"field\": \"id\",\n \"message\": \"<invalid id message>\"\n }\n },\n {\n \"success\": true,\n \"links\": {\n \"account\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_ACCOUNT_ID>\",\n \"id\": \"<SFDC_ACCOUNT_ID>\"\n },\n \"gifttransaction\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_ID>\",\n \"id\": \"<SFDC_GIFT_TRANSACTION_ID>\"\n },\n \"giftcommitment\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_ID>\",\n \"id\": \"<SFDC_GIFT_COMMITMENT_ID>\"\n },\n \"paymentinstrument\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_PAYMENT_INSTRUMENT_ID>\",\n \"id\": \"<SFDC_PAYMENT_INSTRUMENT_ID>\"\n },\n \"gifttransactiondesignation\": [\n {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_DESIGNATION_ID>\",\n \"id\": \"<SFDC_GIFT_TRANSACTION_DESIGNATION_ID>\"\n }\n ]\n }\n }\n ]\n}"
},
{
"name": "Status201-CreateGiftDatabaseFailure",
"originalRequest": {
"method": "POST",
"header": [
],
"body": {
"mode": "raw",
"raw": "{\n \"processingOptions\": {\n \"donorOptions\": {\n \"defaultUpdateLogic\": \"update_all\"\n }\n },\n \"gifts\": [\n {\n \"amount\": 5.00,\n \"currencyIsoCode\": \"USD\",\n \"receivedDate\": \"2024-07-06\",\n \"donorCoverAmount\": 0.25,\n \"transactionStatus\": \"Paid\",\n \"paymentIdentifier\": \"1234\",\n \"gatewayTransactionFee\": 0.75,\n \"processorTransactionFee\": 0.45,\n \"processorReference\": \"cls-1247586928747\",\n \"gatewayReference\": \"102656693ac3ca6e0cdafbfe89ab99\",\n \"lastGatewayResponseCode\": \"invalid_cvc\",\n \"lastGatewayErrorMessage\": \"The card’s security code is invalid. Check the card’s security code or use a different card.\",\n \"lastGatewayProcessedDateTime\": \"2023-07-06T21:57:51Z\",\n \"outreachSourceCode\": {\n \"sourceCode\": \"AnimalEmailCampaign2023\"\n },\n \"donor\": {\n \"donorType\": \"individual\",\n \"firstName\": \"Test\",\n \"lastName\": \"Donor\",\n \"phone\": \"510-434-8920\",\n \"email\": \"test.user@example.com\",\n \"address\": [\n {\n \"addressType\": \"mailing\",\n \"street\": \"123 Main Street\",\n \"city\": \"Oakland\",\n \"state\": \"CA\",\n \"postalCode\": \"94610\",\n \"country\": \"US\"\n }\n ],\n \"accountCustomFields\": [\n {\n \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n \"paymentInstrument\": {\n \"type\": \"credit card\",\n \"accountHolderName\": \"test donor\",\n \"expiryMonth\": \"10\",\n \"expiryYear\": \"2027\",\n \"last4\": \"4585\",\n \"cardBrand\": \"visa\",\n \"bankName\": \"chase\",\n \"digitalWalletProvider\": \"apple pay\",\n \"bankAccountHolderType\": \"primary\",\n \"bankAccountType\": \"checking\",\n \"bankAccountNumber\": \"123456\",\n \"bankCode\": \"HBUK\",\n \"gatewayName\": \"stripe\",\n \"processorName\": \"test processor\",\n \"processorPaymentReference\": \"string\",\n \"gatewayReference\": \"string\"\n },\n \"designations\": [\n {\n \"designationId\": \"<SFDC_GIFT_DESIGNATION_ID>\",\n \"percent\": 10\n }\n ],\n \"giftTransactionCustomFields\": [\n {\n \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n {\n \"amount\": 300.00,\n \"currencyIsoCode\": \"USD\",\n \"receivedDate\": \"2024-07-06\",\n \"donorCoverAmount\": 0.25,\n \"transactionStatus\": \"Paid\",\n \"paymentIdentifier\": \"1234\",\n \"gatewayTransactionFee\": 0.75,\n \"processorTransactionFee\": 0.45,\n \"processorReference\": \"cls-1247586928747\",\n \"gatewayReference\": \"102656693ac3ca6e0cdafbfe89ab99\",\n \"lastGatewayResponseCode\": \"invalid_cvc\",\n \"lastGatewayErrorMessage\": \"The card’s security code is invalid. Check the card’s security code or use a different card.\",\n \"lastGatewayProcessedDateTime\": \"2023-07-06T21:57:51Z\",\n \"outreachSourceCode\": {\n \"sourceCode\": \"AnimalEmailCampaign2023\"\n },\n \"donor\": {\n \"donorType\": \"individual\",\n \"firstName\": \"Test\",\n \"lastName\": \"Donor\",\n \"phone\": \"510-434-8920\",\n \"email\": \"test.user@example.com\",\n \"address\": [\n {\n \"addressType\": \"mailing\",\n \"street\": \"123 Main Street\",\n \"city\": \"Oakland\",\n \"state\": \"CA\",\n \"postalCode\": \"94610\",\n \"country\": \"US\"\n }\n ],\n \"accountCustomFields\": [\n {\n \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n \"paymentInstrument\": {\n \"type\": \"credit card\",\n \"accountHolderName\": \"test donor\",\n \"expiryMonth\": \"10\",\n \"expiryYear\": \"2027\",\n \"last4\": \"4585\",\n \"cardBrand\": \"visa\",\n \"bankName\": \"chase\",\n \"digitalWalletProvider\": \"apple pay\",\n \"bankAccountHolderType\": \"primary\",\n \"bankAccountType\": \"checking\",\n \"bankAccountNumber\": \"123456\",\n \"bankCode\": \"HBUK\",\n \"gatewayName\": \"stripe\",\n \"processorName\": \"test processor\",\n \"processorPaymentReference\": \"string\",\n \"gatewayReference\": \"string\"\n },\n \"designations\": [\n {\n \"designationId\": \"<SFDC_GIFT_DESIGNATION_ID>\",\n \"percent\": 10\n }\n ],\n \"giftTransactionCustomFields\": [\n {\n \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n {\n \"amount\": 300.00,\n \"currencyIsoCode\": \"USD\",\n \"receivedDate\": \"2024-07-06\",\n \"donorCoverAmount\": 0.25,\n \"transactionStatus\": \"Paid\",\n \"paymentIdentifier\": \"1234\",\n \"gatewayTransactionFee\": 0.75,\n \"processorTransactionFee\": 0.45,\n \"processorReference\": \"cls-1247586928747\",\n \"gatewayReference\": \"102656693ac3ca6e0cdafbfe89ab99\",\n \"lastGatewayResponseCode\": \"invalid_cvc\",\n \"lastGatewayErrorMessage\": \"The card’s security code is invalid. Check the card’s security code or use a different card.\",\n \"lastGatewayProcessedDateTime\": \"2023-07-06T21:57:51Z\",\n \"outreachSourceCode\": {\n \"sourceCode\": \"AnimalEmailCampaign2023\"\n },\n \"donor\": {\n \"donorType\": \"individual\",\n \"firstName\": \"Test\",\n \"lastName\": \"Donor\",\n \"phone\": \"510-434-8920\",\n \"email\": \"test.user@example.com\",\n \"address\": [\n {\n \"addressType\": \"mailing\",\n \"street\": \"123 Main Street\",\n \"city\": \"Oakland\",\n \"state\": \"CA\",\n \"postalCode\": \"94610\",\n \"country\": \"US\"\n }\n ],\n \"accountCustomFields\": [\n {\n \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n \"paymentInstrument\": {\n \"type\": \"credit card\",\n \"accountHolderName\": \"test donor\",\n \"expiryMonth\": \"10\",\n \"expiryYear\": \"2027\",\n \"last4\": \"4585\",\n \"cardBrand\": \"visa\",\n \"bankName\": \"chase\",\n \"digitalWalletProvider\": \"apple pay\",\n \"bankAccountHolderType\": \"primary\",\n \"bankAccountType\": \"checking\",\n \"bankAccountNumber\": \"123456\",\n \"bankCode\": \"HBUK\",\n \"gatewayName\": \"stripe\",\n \"processorName\": \"test processor\",\n \"processorPaymentReference\": \"string\",\n \"gatewayReference\": \"string\"\n },\n \"designations\": [\n {\n \"designationId\": \"<SFDC_GIFT_DESIGNATION_ID>\",\n \"percent\": 10\n }\n ],\n \"giftTransactionCustomFields\": [\n {\n \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n \"fieldValue\": \"string\"\n }\n ]\n }\n ]\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{_endpoint}}/services/data/v{{version}}/connect/fundraising/gifts",
"host": [
"{{_endpoint}}"
],
"path": [
"services",
"data",
"v{{version}}",
"connect",
"fundraising",
"gifts"
]
}
},
"status": "Created",
"code": 201,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"description": ""
}
],
"cookie": [
],
"body": "// This is a scenario where there is a validation rule on the Gift Transaction object requiring the amount to be greater than 10.00. One database error occurs for the 5.00 transaction, causing the other two to be rolled back with success of false and no record links.\n{\n \"successes\": 0,\n \"failures\": 1,\n \"notProcessed\": 2,\n \"details\": [\n {\n \"success\": false,\n \"errors\": {\n \"message\": \"Amount must be greater than 10.00\"\n }\n },\n {\n \"success\": false\n },\n {\n \"success\": false\n }\n ]\n}"
},
{
"name": "Status201-CreateGiftSuccessWithExternalIds",
"originalRequest": {
"method": "POST",
"header": [
],
"body": {
"mode": "raw",
"raw": "{\n \"processingOptions\": {\n \"donorOptions\": {\n \"defaultUpdateLogic\": \"update_all\"\n }\n },\n \"gifts\": [\n {\n \"amount\": 150.25,\n \"currencyIsoCode\": \"USD\",\n \"receivedDate\": \"2024-07-06\",\n \"donorCoverAmount\": 0.25,\n \"transactionStatus\": \"Unpaid\",\n \"commitment\": {\n \"externalId\": {\n \"fieldName\": \"<EXTERNAL_ID_FIELD_NAME>\",\n \"fieldValue\": \"<EXTERNAL_ID_FIELD_VALUE>\"\n }\n },\n \"paymentIdentifier\": \"1234\",\n \"gatewayTransactionFee\": 0.75,\n \"processorTransactionFee\": 0.45,\n \"processorReference\": \"cls-1247586928747\",\n \"gatewayReference\": \"102656693ac3ca6e0cdafbfe89ab99\",\n \"lastGatewayResponseCode\": \"invalid_cvc\",\n \"lastGatewayErrorMessage\": \"The card’s security code is invalid. Check the card’s security code or use a different card.\",\n \"lastGatewayProcessedDateTime\": \"2023-07-06T21:57:51Z\",\n \"campaign\": {\n \"externalId\": {\n \"fieldName\": \"<EXTERNAL_ID_FIELD_NAME>\",\n \"fieldValue\": \"<EXTERNAL_ID_FIELD_VALUE>\"\n }\n },\n \"outreachSourceCode\": {\n \"id\": \"<SFDC_OUTREACH_SOURCE_CODE_ID>\",\n \"sourceCode\": \"AnimalEmailCampaign2023\"\n },\n \"donor\": {\n \"donorType\": \"individual\",\n \"externalId\": {\n \"fieldName\": \"<EXTERNAL_ID_FIELD_NAME>\",\n \"fieldValue\": \"<EXTERNAL_ID_FIELD_VALUE>\"\n },\n \"organizationName\": \"<Organization_Name>\", // If donor type is \"organizational\"\n \"firstName\": \"David\", // if donor type is \"individual\"\n \"lastName\": \"Chavez\", // if donor type is \"individual\"\n \"phone\": \"510-434-8920\",\n \"email\": \"d.chavez@example.com\",\n \"address\": [\n {\n \"addressType\": \"mailing\",\n \"street\": \"123 Main Street\",\n \"city\": \"Oakland\",\n \"state\": \"CA\",\n \"postalCode\": \"94610\",\n \"country\": \"US\"\n }\n ],\n \"accountCustomFields\": [\n {\n \"fieldName\": \"string\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n \"paymentInstrument\": {\n \"type\": \"credit card\",\n \"accountHolderName\": \"test donor\",\n \"expiryMonth\": \"10\",\n \"expiryYear\": \"2027\",\n \"last4\": \"4585\",\n \"cardBrand\": \"visa\",\n \"bankName\": \"chase\",\n \"digitalWalletProvider\": \"apple pay\",\n \"bankAccountHolderType\": \"primary\",\n \"bankAccountType\": \"checking\",\n \"bankAccountNumber\": \"123456\",\n \"bankCode\": \"HBUK\",\n \"gatewayName\": \"stripe\",\n \"processorName\": \"test processor\",\n \"processorPaymentReference\": \"string\",\n \"gatewayReference\": \"string\"\n },\n \"designations\": [\n {\n \"externalId\": {\n \"fieldName\": \"<EXTERNAL_ID_FIELD_NAME>\",\n \"fieldValue\": \"<EXTERNAL_ID_FIELD_VALUE>\"\n },\n \"percent\": 10,\n \"amount\": 150.25\n }\n ],\n \"giftTransactionCustomFields\": [\n {\n \"fieldName\": \"string\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n {\n \"amount\": 250.00,\n \"currencyIsoCode\": \"USD\",\n \"receivedDate\": \"2024-07-06\",\n \"donorCoverAmount\": 0.25,\n \"transactionStatus\": \"Unpaid\",\n \"commitment\": {\n \"externalId\": {\n \"fieldName\": \"<EXTERNAL_ID_FIELD_NAME>\",\n \"fieldValue\": \"<EXTERNAL_ID_FIELD_VALUE>\"\n }\n },\n \"paymentIdentifier\": \"1234\",\n \"gatewayTransactionFee\": 0.75,\n \"processorTransactionFee\": 0.45,\n \"processorReference\": \"cls-1247586928747\",\n \"gatewayReference\": \"102656693ac3ca6e0cdafbfe89ab99\",\n \"lastGatewayResponseCode\": \"invalid_cvc\",\n \"lastGatewayErrorMessage\": \"The card’s security code is invalid. Check the card’s security code or use a different card.\",\n \"lastGatewayProcessedDateTime\": \"2023-07-06T21:57:51Z\",\n \"campaign\": {\n \"externalId\": {\n \"fieldName\": \"<EXTERNAL_ID_FIELD_NAME>\",\n \"fieldValue\": \"<EXTERNAL_ID_FIELD_VALUE>\"\n }\n },\n \"outreachSourceCode\": {\n \"id\": \"<SFDC_OUTREACH_SOURCE_CODE_ID>\",\n \"sourceCode\": \"AnimalEmailCampaign2023\"\n },\n \"donor\": {\n \"donorType\": \"individual\",\n \"externalId\": {\n \"fieldName\": \"<EXTERNAL_ID_FIELD_NAME>\",\n \"fieldValue\": \"<EXTERNAL_ID_FIELD_VALUE>\"\n },\n \"organizationName\": \"<Organization_Name>\",\n \"firstName\": \"Luke\",\n \"lastName\": \"Smith\",\n \"phone\": \"510-434-8920\",\n \"email\": \"l.smith@example.com\",\n \"address\": [\n {\n \"addressType\": \"mailing\",\n \"street\": \"123 Main Street\",\n \"city\": \"Oakland\",\n \"state\": \"CA\",\n \"postalCode\": \"94610\",\n \"country\": \"US\"\n }\n ],\n \"accountCustomFields\": [\n {\n \"fieldName\": \"string\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n \"paymentInstrument\": {\n \"type\": \"credit card\",\n \"accountHolderName\": \"test donor\",\n \"expiryMonth\": \"10\",\n \"expiryYear\": \"2027\",\n \"last4\": \"4585\",\n \"cardBrand\": \"visa\",\n \"bankName\": \"chase\",\n \"digitalWalletProvider\": \"apple pay\",\n \"bankAccountHolderType\": \"primary\",\n \"bankAccountType\": \"checking\",\n \"bankAccountNumber\": \"123456\",\n \"bankCode\": \"HBUK\",\n \"gatewayName\": \"stripe\",\n \"processorName\": \"test processor\",\n \"processorPaymentReference\": \"string\",\n \"gatewayReference\": \"string\"\n },\n \"designations\": [\n {\n \"externalId\": {\n \"fieldName\": \"<EXTERNAL_ID_FIELD_NAME>\",\n \"fieldValue\": \"<EXTERNAL_ID_FIELD_VALUE>\"\n },\n \"percent\": 10,\n \"amount\": 150.25\n }\n ],\n \"giftTransactionCustomFields\": [\n {\n \"fieldName\": \"string\",\n \"fieldValue\": \"string\"\n }\n ]\n }\n ]\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{_endpoint}}/services/data/v{{version}}/connect/fundraising/gifts",
"host": [
"{{_endpoint}}"
],
"path": [
"services",
"data",
"v{{version}}",
"connect",
"fundraising",
"gifts"
]
}
},
"_postman_previewlanguage": null,
"header": null,
"cookie": [
],
"body": "{\n \"successes\": 2,\n \"failures\": 0,\n \"notProcessed\": 0,\n \"details\": [\n {\n \"success\": true,\n \"links\": {\n \"account\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_ACCOUNT_ID>\",\n \"id\": \"<SFDC_ACCOUNT_ID>\"\n },\n \"gifttransaction\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_ID>\",\n \"id\": \"<SFDC_GIFT_TRANSACTION_ID>\"\n },\n \"giftcommitment\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_ID>\",\n \"id\": \"<SFDC_GIFT_COMMITMENT_ID>\"\n },\n \"paymentinstrument\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_PAYMENT_INSTRUMENT_ID>\",\n \"id\": \"<SFDC_PAYMENT_INSTRUMENT_ID>\"\n },\n \"gifttransactiondesignation\": [\n {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_DESIGNATION_ID>\",\n \"id\": \"<SFDC_GIFT_TRANSACTION_DESIGNATION_ID>\"\n }\n ]\n }\n },\n {\n \"success\": true,\n \"links\": {\n \"account\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_ACCOUNT_ID>\",\n \"id\": \"<SFDC_ACCOUNT_ID>\"\n },\n \"gifttransaction\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_ID>\",\n \"id\": \"<SFDC_GIFT_TRANSACTION_ID>\"\n },\n \"giftcommitment\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_ID>\",\n \"id\": \"<SFDC_GIFT_COMMITMENT_ID>\"\n },\n \"paymentinstrument\": {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_PAYMENT_INSTRUMENT_ID>\",\n \"id\": \"<SFDC_PAYMENT_INSTRUMENT_ID>\"\n },\n \"gifttransactiondesignation\": [\n {\n \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_DESIGNATION_ID>\",\n \"id\": \"<SFDC_GIFT_TRANSACTION_DESIGNATION_ID>\"\n }\n ]\n }\n }\n ]\n}"
},
{
"name": "Status400-BadRequestError",
"originalRequest": {
"method": "POST",
"header": [
],
"body": {
"mode": "raw",
"raw": "// Even if the JSON request is valid, this is an example of a 400 error code that will be returned if duplicate matching rules are not active.\n{\n \"processingOptions\": {\n \"donorOptions\": {\n \"defaultUpdateLogic\": \"update_all\"\n }\n },\n \"gifts\": [\n {\n \"amount\": 150.25,\n \"currencyIsoCode\": \"USD\",\n \"receivedDate\": \"2024-07-06\",\n \"donorCoverAmount\": 0.25,\n \"transactionStatus\": \"Unpaid\",\n \"commitmentId\": \"123456\",\n \"paymentIdentifier\": \"1234\",\n \"gatewayTransactionFee\": 0.75,\n \"processorTransactionFee\": 0.45,\n \"processorReference\": \"cls-1247586928747\",\n \"gatewayReference\": \"102656693ac3ca6e0cdafbfe89ab99\",\n \"lastGatewayResponseCode\": \"invalid_cvc\",\n \"lastGatewayErrorMessage\": \"The card’s security code is invalid. Check the card’s security code or use a different card.\",\n \"lastGatewayProcessedDateTime\": \"2023-07-06T21:57:51Z\",\n \"campaign\": {\n \"id\": \"<SFDC_CAMPAIGN_ID>\"\n },\n \"outreachSourceCode\": {\n \"id\": \"<SFDC_OUTREACH_SOURCE_CODE_ID>\",\n \"sourceCode\": \"AnimalEmailCampaign2023\"\n },\n \"donor\": {\n \"donorType\": \"individual\",\n \"id\": \"<SFDC_PERSON_ACCOUNT_ID>\",\n \"firstName\": \"Test\",\n \"lastName\": \"Donor\",\n \"phone\": \"510-434-8920\",\n \"email\": \"test.user@example.com\",\n \"address\": [\n {\n \"addressType\": \"mailing\",\n \"street\": \"123 Main Street\",\n \"city\": \"Oakland\",\n \"state\": \"CA\",\n \"postalCode\": \"94610\",\n \"country\": \"US\"\n }\n ],\n \"accountCustomFields\": [\n {\n \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n \"paymentInstrument\": {\n \"type\": \"credit card\",\n \"accountHolderName\": \"test donor\",\n \"expiryMonth\": \"10\",\n \"expiryYear\": \"2027\",\n \"last4\": \"4585\",\n \"cardBrand\": \"visa\",\n \"bankName\": \"chase\",\n \"digitalWalletProvider\": \"apple pay\",\n \"bankAccountHolderType\": \"primary\",\n \"bankAccountType\": \"checking\",\n \"bankAccountNumber\": \"123456\",\n \"bankCode\": \"HBUK\",\n \"gatewayName\": \"stripe\",\n \"processorName\": \"test processor\",\n \"processorPaymentReference\": \"string\",\n \"gatewayReference\": \"string\"\n },\n \"designations\": [\n {\n \"designationId\": \"<SFDC_GIFT_DESIGNATION_ID>\",\n \"percent\": 10\n }\n ],\n \"giftTransactionCustomFields\": [\n {\n \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n {\n \"amount\": 300.00,\n \"currencyIsoCode\": \"USD\",\n \"receivedDate\": \"2024-07-06\",\n \"donorCoverAmount\": 0.25,\n \"transactionStatus\": \"Unpaid\",\n \"commitmentId\": \"<SFDC_GIFT_COMMITMENT_ID>\",\n \"paymentIdentifier\": \"1234\",\n \"gatewayTransactionFee\": 0.75,\n \"processorTransactionFee\": 0.45,\n \"processorReference\": \"cls-1247586928747\",\n \"gatewayReference\": \"102656693ac3ca6e0cdafbfe89ab99\",\n \"lastGatewayResponseCode\": \"invalid_cvc\",\n \"lastGatewayErrorMessage\": \"The card’s security code is invalid. Check the card’s security code or use a different card.\",\n \"lastGatewayProcessedDateTime\": \"2023-07-06T21:57:51Z\",\n \"campaign\": {\n \"id\": \"<SFDC_CAMPAIGN_ID>\"\n },\n \"outreachSourceCode\": {\n \"id\": \"<SFDC_OUTREACH_SOURCE_CODE_ID>\",\n \"sourceCode\": \"AnimalEmailCampaign2023\"\n },\n \"donor\": {\n \"donorType\": \"individual\",\n \"id\": \"<SFDC_PERSON_ACCOUNT_ID>\",\n \"firstName\": \"Test\",\n \"lastName\": \"Donor\",\n \"phone\": \"510-434-8920\",\n \"email\": \"test.user@example.com\",\n \"address\": [\n {\n \"addressType\": \"mailing\",\n \"street\": \"123 Main Street\",\n \"city\": \"Oakland\",\n \"state\": \"CA\",\n \"postalCode\": \"94610\",\n \"country\": \"US\"\n }\n ],\n \"accountCustomFields\": [\n {\n \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n \"fieldValue\": \"string\"\n }\n ]\n },\n \"paymentInstrument\": {\n \"type\": \"credit card\",\n \"accountHolderName\": \"test donor\",\n \"expiryMonth\": \"10\",\n \"expiryYear\": \"2027\",\n \"last4\": \"4585\",\n \"cardBrand\": \"visa\",\n \"bankName\": \"chase\",\n \"digitalWalletProvider\": \"apple pay\",\n \"bankAccountHolderType\": \"primary\",\n \"bankAccountType\": \"checking\",\n \"bankAccountNumber\": \"123456\",\n \"bankCode\": \"HBUK\",\n \"gatewayName\": \"stripe\",\n \"processorName\": \"test processor\",\n \"processorPaymentReference\": \"string\",\n \"gatewayReference\": \"string\"\n },\n \"designations\": [\n {\n \"designationId\": \"<SFDC_GIFT_DESIGNATION_ID>\",\n \"percent\": 10\n }\n ],\n \"giftTransactionCustomFields\": [\n {\n \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n \"fieldValue\": \"string\"\n }\n ]\n }\n ]\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{_endpoint}}/services/data/v{{version}}/connect/fundraising/gifts",
"host": [
"{{_endpoint}}"
],
"path": [
"services",
"data",
"v{{version}}",
"connect",
"fundraising",
"gifts"
]
}
},
"status": "Bad Request",
"code": 400,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"description": ""
}
],
"cookie": [
],
"body": " // Even if the JSON request is valid, this is an example of a 400 error code that will be returned if duplicate matching rules are not active. Any non 200 error code would have a similar response structure.\n {\n \"errorCode\": \"UNKNOWN_EXCEPTION\",\n \"message\": \"Provide active duplicate matching rules on Account and Person Account for donor matching. -- industries.fundraisingops.connect.impl.validator.ValidatorUtil.validateMatchingMethod(ValidatorUtil.java:103)\"\n }"
}
]
}
