Chilkat Online Tools

Foxpro / Salesforce Platform APIs / Create Commitments

Back to Collection Items

LOCAL loHttp
LOCAL lnSuccess
LOCAL loJson
LOCAL loResp
LOCAL loSbResponseBody
LOCAL loJResp
LOCAL lnRespStatusCode
LOCAL lnSuccess
LOCAL lcHref
LOCAL lcId
LOCAL lcGiftcommitmentscheduleHref
LOCAL lcGiftcommitmentscheduleId
LOCAL lcGifttransactionHref
LOCAL lcGifttransactionId
LOCAL lcPaymentinstrumentHref
LOCAL lcPaymentinstrumentId
LOCAL lcAccountHref
LOCAL lcAccountId
LOCAL j
LOCAL lnCount_j
LOCAL lcHref
LOCAL lcId
LOCAL lnSuccesses
LOCAL lnFailures
LOCAL lnNotProcessed
LOCAL i
LOCAL lnCount_i

* This example assumes the Chilkat API to have been previously unlocked.
* See Global Unlock Sample for sample code.

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Http')
loHttp = CreateObject('Chilkat.Http')

* 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"
*     }
*   },
*   "commitments": [
*     {
*       "amount": 150.25,
*       "currencyIsoCode": "USD",
*       "transactionPeriod": "monthly",
*       "transactionInterval": 3,
*       "transactionDay": "5",
*       "startDate": "2024-07-06",
*       "endDate": "2024-08-06",
*       "campaign": {
*         "id": "<SFDC_CAMPAIGN_ID>"
*       },
*       "outreachSourceCode": {
*         "id": "<SFDC_OUTREACH_SOURCE_CODE_ID>",
*         "sourceCode": "AnimalEmailCampaign2023"
*       },
*       "donor": {
*         "donorType": "individual",
*         "id": "<SFDC_ACCOUNT_ID>",
*         "firstName": "Test",
*         "lastName": "Donor",
*         "phone": "510-434-8920",
*         "email": "test.donor@salesforce.com",
*         "address": [
*           {
*             "addressType": "mailing",
*             "street": "123 Main Street",
*             "city": "Oakland",
*             "state": "CA",
*             "postalCode": "94610",
*             "country": "US"
*           }
*         ],
*         "accountCustomFields": [
*           {
*             "fieldName": "<VALID_CUSTOM_FIELD_API_NAME>",
*             "fieldValue": "string"
*           }
*         ]
*       },
*       "paymentInstrument": {
*         "type": "credit card",
*         "accountHolderName": "test donor",
*         "expiryMonth": "10",
*         "expiryYear": "2026",
*         "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
*         }
*       ],
*       "firstTransaction": {
*         "amount": 150.25,
*         "receivedDate": "2024-07-06",
*         "donorCoverAmount": 0.25,
*         "transactionStatus": "Unpaid",
*         "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"
*       },
*       "giftCommitmentCustomFields": [
*         {
*           "fieldName": "<VALID_CUSTOM_FIELD_API_NAME>",
*           "fieldValue": "string"
*         }
*       ],
*       "giftCommitmentScheduleCustomFields": [
*         {
*           "fieldName": "<VALID_CUSTOM_FIELD_API_NAME>",
*           "fieldValue": "string"
*         }
*       ]
*     }
*   ]
* }

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJson = CreateObject('Chilkat.JsonObject')
loJson.UpdateString("processingOptions.donorOptions.defaultUpdateLogic","update_all")
loJson.UpdateNumber("commitments[0].amount","150.25")
loJson.UpdateString("commitments[0].currencyIsoCode","USD")
loJson.UpdateString("commitments[0].transactionPeriod","monthly")
loJson.UpdateInt("commitments[0].transactionInterval",3)
loJson.UpdateString("commitments[0].transactionDay","5")
loJson.UpdateString("commitments[0].startDate","2024-07-06")
loJson.UpdateString("commitments[0].endDate","2024-08-06")
loJson.UpdateString("commitments[0].campaign.id","<SFDC_CAMPAIGN_ID>")
loJson.UpdateString("commitments[0].outreachSourceCode.id","<SFDC_OUTREACH_SOURCE_CODE_ID>")
loJson.UpdateString("commitments[0].outreachSourceCode.sourceCode","AnimalEmailCampaign2023")
loJson.UpdateString("commitments[0].donor.donorType","individual")
loJson.UpdateString("commitments[0].donor.id","<SFDC_ACCOUNT_ID>")
loJson.UpdateString("commitments[0].donor.firstName","Test")
loJson.UpdateString("commitments[0].donor.lastName","Donor")
loJson.UpdateString("commitments[0].donor.phone","510-434-8920")
loJson.UpdateString("commitments[0].donor.email","test.donor@salesforce.com")
loJson.UpdateString("commitments[0].donor.address[0].addressType","mailing")
loJson.UpdateString("commitments[0].donor.address[0].street","123 Main Street")
loJson.UpdateString("commitments[0].donor.address[0].city","Oakland")
loJson.UpdateString("commitments[0].donor.address[0].state","CA")
loJson.UpdateString("commitments[0].donor.address[0].postalCode","94610")
loJson.UpdateString("commitments[0].donor.address[0].country","US")
loJson.UpdateString("commitments[0].donor.accountCustomFields[0].fieldName","<VALID_CUSTOM_FIELD_API_NAME>")
loJson.UpdateString("commitments[0].donor.accountCustomFields[0].fieldValue","string")
loJson.UpdateString("commitments[0].paymentInstrument.type","credit card")
loJson.UpdateString("commitments[0].paymentInstrument.accountHolderName","test donor")
loJson.UpdateString("commitments[0].paymentInstrument.expiryMonth","10")
loJson.UpdateString("commitments[0].paymentInstrument.expiryYear","2026")
loJson.UpdateString("commitments[0].paymentInstrument.last4","4585")
loJson.UpdateString("commitments[0].paymentInstrument.cardBrand","visa")
loJson.UpdateString("commitments[0].paymentInstrument.bankName","chase")
loJson.UpdateString("commitments[0].paymentInstrument.digitalWalletProvider","apple pay")
loJson.UpdateString("commitments[0].paymentInstrument.bankAccountHolderType","primary")
loJson.UpdateString("commitments[0].paymentInstrument.bankAccountType","checking")
loJson.UpdateString("commitments[0].paymentInstrument.bankAccountNumber","123456")
loJson.UpdateString("commitments[0].paymentInstrument.bankCode","HBUK")
loJson.UpdateString("commitments[0].paymentInstrument.gatewayName","stripe")
loJson.UpdateString("commitments[0].paymentInstrument.processorName","test processor")
loJson.UpdateString("commitments[0].paymentInstrument.processorPaymentReference","string")
loJson.UpdateString("commitments[0].paymentInstrument.gatewayReference","string")
loJson.UpdateString("commitments[0].designations[0].designationId","<SFDC_GIFT_DESIGNATION_ID>")
loJson.UpdateInt("commitments[0].designations[0].percent",10)
loJson.UpdateNumber("commitments[0].firstTransaction.amount","150.25")
loJson.UpdateString("commitments[0].firstTransaction.receivedDate","2024-07-06")
loJson.UpdateNumber("commitments[0].firstTransaction.donorCoverAmount","0.25")
loJson.UpdateString("commitments[0].firstTransaction.transactionStatus","Unpaid")
loJson.UpdateNumber("commitments[0].firstTransaction.gatewayTransactionFee","0.75")
loJson.UpdateNumber("commitments[0].firstTransaction.processorTransactionFee","0.45")
loJson.UpdateString("commitments[0].firstTransaction.processorReference","cls-1247586928747")
loJson.UpdateString("commitments[0].firstTransaction.gatewayReference","102656693ac3ca6e0cdafbfe89ab99")
loJson.UpdateString("commitments[0].firstTransaction.lastGatewayResponseCode","invalid_cvc")
loJson.UpdateString("commitments[0].firstTransaction.lastGatewayErrorMessage","The card’s security code is invalid. Check the card’s security code or use a different card.")
loJson.UpdateString("commitments[0].firstTransaction.lastGatewayProcessedDateTime","2023-07-06T21:57:51Z")
loJson.UpdateString("commitments[0].giftCommitmentCustomFields[0].fieldName","<VALID_CUSTOM_FIELD_API_NAME>")
loJson.UpdateString("commitments[0].giftCommitmentCustomFields[0].fieldValue","string")
loJson.UpdateString("commitments[0].giftCommitmentScheduleCustomFields[0].fieldName","<VALID_CUSTOM_FIELD_API_NAME>")
loJson.UpdateString("commitments[0].giftCommitmentScheduleCustomFields[0].fieldValue","string")

* Adds the "Authorization: Bearer <access_token>" header.
loHttp.AuthToken = "<access_token>"

loResp = loHttp.PostJson3("https://domain.com/services/data/v{{version}}/connect/fundraising/commitments","application/json",loJson)
IF (loHttp.LastMethodSuccess = 0) THEN
    ? loHttp.LastErrorText
    RELEASE loHttp
    RELEASE loJson
    CANCEL
ENDIF

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.StringBuilder')
loSbResponseBody = CreateObject('Chilkat.StringBuilder')
loResp.GetBodySb(loSbResponseBody)

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.JsonObject')
loJResp = CreateObject('Chilkat.JsonObject')
loJResp.LoadSb(loSbResponseBody)
loJResp.EmitCompact = 0

? "Response Body:"
? loJResp.Emit()

lnRespStatusCode = loResp.StatusCode
? "Response Status Code = " + STR(lnRespStatusCode)
IF (lnRespStatusCode >= 400) THEN
    ? "Response Header:"
    ? loResp.Header
    ? "Failed."
    RELEASE loResp
    RELEASE loHttp
    RELEASE loJson
    RELEASE loSbResponseBody
    RELEASE loJResp
    CANCEL
ENDIF

RELEASE loResp

* Sample JSON response:
* (Sample code for parsing the JSON response is shown below)

* {
*   "successes": 1,
*   "failures": 0,
*   "notProcessed": 0,
*   "details": [
*     {
*       "success": true,
*       "links": {
*         "giftcommitment": {
*           "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_ID>",
*           "id": "<SFDC_GIFT_COMMITMENT_ID>"
*         },
*         "giftcommitmentschedule": {
*           "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_SCHEDULE_ID>",
*           "id": "<SFDC_GIFT_COMMITMENT_SCHEDULE_ID>"
*         },
*         "giftdefaultdesignation": [
*           {
*             "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_DEFAULT_DESIGNATION_ID>",
*             "id": "<SFDC_GIFT_DEFAULT_DESIGNATION_ID>"
*           }
*         ],
*         "gifttransaction": {
*           "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_ID>",
*           "id": "<SFDC_GIFT_TRANSACTION_ID>"
*         },
*         "paymentinstrument": {
*           "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_PAYMENT_INSTRUMENT_ID>",
*           "id": "<SFDC_PAYMENT_INSTRUMENT_ID>"
*         },
*         "account": {
*           "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_ACCOUNT_ID>",
*           "id": "<SFDC_ACCOUNT_ID>"
*         }
*       }
*     },
*     {
*       "success": true,
*       "links": {
*         "giftcommitment": {
*           "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_ID>",
*           "id": "<SFDC_GIFT_COMMITMENT_ID>"
*         },
*         "giftcommitmentschedule": {
*           "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_SCHEDULE_ID>",
*           "id": "<SFDC_GIFT_COMMITMENT_SCHEDULE_ID>"
*         },
*         "giftdefaultdesignation": [
*           {
*             "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_DEFAULT_DESIGNATION_ID>",
*             "id": "<SFDC_GIFT_DEFAULT_DESIGNATION_ID>"
*           }
*         ],
*         "gifttransaction": {
*           "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_ID>",
*           "id": "<SFDC_GIFT_TRANSACTION_ID>"
*         },
*         "paymentinstrument": {
*           "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_PAYMENT_INSTRUMENT_ID>",
*           "id": "<SFDC_PAYMENT_INSTRUMENT_ID>"
*         },
*         "account": {
*           "href": "/services/data/vXX.X/sobjects/sObject/<SFDC_ACCOUNT_ID>",
*           "id": "<SFDC_ACCOUNT_ID>"
*         }
*       }
*     }
*   ]
* }

* Sample code for parsing the JSON response...
* Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code

lnSuccesses = loJResp.IntOf("successes")
lnFailures = loJResp.IntOf("failures")
lnNotProcessed = loJResp.IntOf("notProcessed")
i = 0
lnCount_i = loJResp.SizeOfArray("details")
DO WHILE i < lnCount_i
    loJResp.I = i
    lnSuccess = loJResp.BoolOf("details[i].success")
    lcHref = loJResp.StringOf("details[i].links.giftcommitment.href")
    lcId = loJResp.StringOf("details[i].links.giftcommitment.id")
    lcGiftcommitmentscheduleHref = loJResp.StringOf("details[i].links.giftcommitmentschedule.href")
    lcGiftcommitmentscheduleId = loJResp.StringOf("details[i].links.giftcommitmentschedule.id")
    lcGifttransactionHref = loJResp.StringOf("details[i].links.gifttransaction.href")
    lcGifttransactionId = loJResp.StringOf("details[i].links.gifttransaction.id")
    lcPaymentinstrumentHref = loJResp.StringOf("details[i].links.paymentinstrument.href")
    lcPaymentinstrumentId = loJResp.StringOf("details[i].links.paymentinstrument.id")
    lcAccountHref = loJResp.StringOf("details[i].links.account.href")
    lcAccountId = loJResp.StringOf("details[i].links.account.id")
    j = 0
    lnCount_j = loJResp.SizeOfArray("details[i].links.giftdefaultdesignation")
    DO WHILE j < lnCount_j
        loJResp.J = j
        lcHref = loJResp.StringOf("details[i].links.giftdefaultdesignation[j].href")
        lcId = loJResp.StringOf("details[i].links.giftdefaultdesignation[j].id")
        j = j + 1
    ENDDO
    i = i + 1
ENDDO

RELEASE loHttp
RELEASE loJson
RELEASE loSbResponseBody
RELEASE loJResp

Curl Command

curl -X POST
	-H "Authorization: Bearer <access_token>"
	-d '{
  "processingOptions": {
    "donorOptions": {
      "defaultUpdateLogic": "update_all"
    }
  },
  "commitments": [
    {
      "amount": 150.25,
      "currencyIsoCode": "USD",
      "transactionPeriod": "monthly",
      "transactionInterval": 3,
      "transactionDay": "5",
      "startDate": "2024-07-06",
      "endDate": "2024-08-06",
      "campaign": {
        "id": "<SFDC_CAMPAIGN_ID>"
      },
      "outreachSourceCode": {
        "id": "<SFDC_OUTREACH_SOURCE_CODE_ID>",
        "sourceCode": "AnimalEmailCampaign2023"
      },
      "donor": {
        "donorType": "individual",
        "id": "<SFDC_ACCOUNT_ID>",
        "firstName": "Test",
        "lastName": "Donor",
        "phone": "510-434-8920",
        "email": "test.donor@salesforce.com",
        "address": [
          {
            "addressType": "mailing",
            "street": "123 Main Street",
            "city": "Oakland",
            "state": "CA",
            "postalCode": "94610",
            "country": "US"
          }
        ],
        "accountCustomFields": [
          {
            "fieldName": "<VALID_CUSTOM_FIELD_API_NAME>",
            "fieldValue": "string"
          }
        ]
      },
      "paymentInstrument": {
        "type": "credit card",
        "accountHolderName": "test donor",
        "expiryMonth": "10",
        "expiryYear": "2026",
        "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
        }
      ],
      "firstTransaction": {
        "amount": 150.25,
        "receivedDate": "2024-07-06",
        "donorCoverAmount": 0.25,
        "transactionStatus": "Unpaid",
        "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"
      },
      "giftCommitmentCustomFields": [
        {
          "fieldName": "<VALID_CUSTOM_FIELD_API_NAME>",
          "fieldValue": "string"
        }
      ],
      "giftCommitmentScheduleCustomFields": [
        {
          "fieldName": "<VALID_CUSTOM_FIELD_API_NAME>",
          "fieldValue": "string"
        }
      ]
    }
  ]
}'
https://domain.com/services/data/v{{version}}/connect/fundraising/commitments

Postman Collection Item JSON

{
  "name": "Create Commitments",
  "request": {
    "method": "POST",
    "header": [
    ],
    "body": {
      "mode": "raw",
      "raw": "{\n  \"processingOptions\": {\n    \"donorOptions\": {\n      \"defaultUpdateLogic\": \"update_all\"\n    }\n  },\n  \"commitments\": [\n    {\n      \"amount\": 150.25,\n      \"currencyIsoCode\": \"USD\",\n      \"transactionPeriod\": \"monthly\",\n      \"transactionInterval\": 3,\n      \"transactionDay\": \"5\",\n      \"startDate\": \"2024-07-06\",\n      \"endDate\": \"2024-08-06\",\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_ACCOUNT_ID>\",\n        \"firstName\": \"Test\",\n        \"lastName\": \"Donor\",\n        \"phone\": \"510-434-8920\",\n        \"email\": \"test.donor@salesforce.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\": \"2026\",\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      \"firstTransaction\": {\n        \"amount\": 150.25,\n        \"receivedDate\": \"2024-07-06\",\n        \"donorCoverAmount\": 0.25,\n        \"transactionStatus\": \"Unpaid\",\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      },\n      \"giftCommitmentCustomFields\": [\n        {\n          \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n          \"fieldValue\": \"string\"\n        }\n      ],\n      \"giftCommitmentScheduleCustomFields\": [\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/commitments",
      "host": [
        "{{_endpoint}}"
      ],
      "path": [
        "services",
        "data",
        "v{{version}}",
        "connect",
        "fundraising",
        "commitments"
      ]
    },
    "description": "Create gift transactions with related new or matched donors, optional transaction designations, and payment instrument metadata. Supports custom fields for the donor account and gift transaction.\n\n## Required Attributes:\n\n- commitments.amount\n    \n- commitments.transactionPeriod\n    \n- commitments.startDate\n    \n- donor.donorType (\"individual\" or \"organization\")\n    \n- donor.lastName\n    \n- donor.organization\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 wit 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- Date - YYYY-MM-DD\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- 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- Do not include an empty collection or an empty fieldName in the request body"
  },
  "response": [
    {
      "name": "Status201-CreateCommitmentSuccess",
      "originalRequest": {
        "method": "POST",
        "header": [
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"processingOptions\": {\n    \"donorOptions\": {\n      \"defaultUpdateLogic\": \"update_all\"\n    }\n  },\n  \"commitments\": [\n    {\n      \"amount\": 150.25,\n      \"currencyIsoCode\": \"USD\",\n      \"transactionPeriod\": \"monthly\",\n      \"transactionInterval\": 3,\n      \"transactionDay\": \"5\",\n      \"startDate\": \"2024-07-06\",\n      \"endDate\": \"2024-08-06\",\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_ACCOUNT_ID>\",\n        \"firstName\": \"Test\",\n        \"lastName\": \"Donor\",\n        \"phone\": \"510-434-8920\",\n        \"email\": \"test.donor@salesforce.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\": \"2026\",\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      \"firstTransaction\": {\n        \"amount\": 150.25,\n        \"receivedDate\": \"2024-07-06\",\n        \"donorCoverAmount\": 0.25,\n        \"transactionStatus\": \"Unpaid\",\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      },\n      \"giftCommitmentCustomFields\": [\n        {\n          \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n          \"fieldValue\": \"string\"\n        }\n      ],\n      \"giftCommitmentScheduleCustomFields\": [\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/commitments",
          "host": [
            "{{_endpoint}}"
          ],
          "path": [
            "services",
            "data",
            "v{{version}}",
            "connect",
            "fundraising",
            "commitments"
          ]
        }
      },
      "status": "Created",
      "code": 201,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json",
          "description": ""
        }
      ],
      "cookie": [
      ],
      "body": "{\n    \"successes\": 1,\n    \"failures\": 0,\n    \"notProcessed\": 0,\n    \"details\": [\n        {\n            \"success\": true,\n            \"links\": {\n                \"giftcommitment\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_ID>\",\n                    \"id\": \"<SFDC_GIFT_COMMITMENT_ID>\"\n                },\n                \"giftcommitmentschedule\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_SCHEDULE_ID>\",\n                    \"id\": \"<SFDC_GIFT_COMMITMENT_SCHEDULE_ID>\"\n                },\n                \"giftdefaultdesignation\": [\n                    {\n                        \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_DEFAULT_DESIGNATION_ID>\",\n                        \"id\": \"<SFDC_GIFT_DEFAULT_DESIGNATION_ID>\"\n                    }\n                ],\n                \"gifttransaction\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_ID>\",\n                    \"id\": \"<SFDC_GIFT_TRANSACTION_ID>\"\n                },\n                \"paymentinstrument\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_PAYMENT_INSTRUMENT_ID>\",\n                    \"id\": \"<SFDC_PAYMENT_INSTRUMENT_ID>\"\n                },\n                \"account\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_ACCOUNT_ID>\",\n                    \"id\": \"<SFDC_ACCOUNT_ID>\"\n                }\n            }\n        },\n        {\n            \"success\": true,\n            \"links\": {\n                \"giftcommitment\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_ID>\",\n                    \"id\": \"<SFDC_GIFT_COMMITMENT_ID>\"\n                },\n                \"giftcommitmentschedule\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_SCHEDULE_ID>\",\n                    \"id\": \"<SFDC_GIFT_COMMITMENT_SCHEDULE_ID>\"\n                },\n                \"giftdefaultdesignation\": [\n                    {\n                        \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_DEFAULT_DESIGNATION_ID>\",\n                        \"id\": \"<SFDC_GIFT_DEFAULT_DESIGNATION_ID>\"\n                    }\n                ],\n                \"gifttransaction\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_ID>\",\n                    \"id\": \"<SFDC_GIFT_TRANSACTION_ID>\"\n                },\n                \"paymentinstrument\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_PAYMENT_INSTRUMENT_ID>\",\n                    \"id\": \"<SFDC_PAYMENT_INSTRUMENT_ID>\"\n                },\n                \"account\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_ACCOUNT_ID>\",\n                    \"id\": \"<SFDC_ACCOUNT_ID>\"\n                }\n            }\n        }\n    ]\n}"
    },
    {
      "name": "Status201-CreateCommitmentRequestValidationFailure",
      "originalRequest": {
        "method": "POST",
        "header": [
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"processingOptions\": {\n    \"donorOptions\": {\n      \"defaultUpdateLogic\": \"update_all\"\n    }\n  },\n  \"commitments\": [\n    {\n      \"amount\": 150.25,\n      \"currencyIsoCode\": \"USD\",\n      \"transactionPeriod\": \"monthly\",\n      \"transactionInterval\": 3,\n      \"transactionDay\": \"5\",\n      \"startDate\": \"2024-07-06\",\n      \"endDate\": \"2024-08-06\",\n      \"outreachSourceCode\": {\n        \"id\": \"INVALID SOURCE CODE ID\"\n      },\n      \"donor\": {\n        \"donorType\": \"individual\",\n        \"id\": \"<SFDC_ACCOUNT_ID>\",\n        \"organizationName\": \"test organization\",\n        \"firstName\": \"Test\",\n        \"lastName\": \"Donor\",\n        \"phone\": \"510-434-8920\",\n        \"email\": \"test.donor@salesforce.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\": \"2026\",\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      \"firstTransaction\": {\n        \"amount\": 150.25,\n        \"receivedDate\": \"2024-07-06\",\n        \"donorCoverAmount\": 0.25,\n        \"transactionStatus\": \"Unpaid\",\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      },\n      \"giftCommitmentCustomFields\": [\n        {\n          \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n          \"fieldValue\": \"string\"\n        }\n      ],\n      \"giftCommitmentScheduleCustomFields\": [\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/commitments",
          "host": [
            "{{_endpoint}}"
          ],
          "path": [
            "services",
            "data",
            "v{{version}}",
            "connect",
            "fundraising",
            "commitments"
          ]
        }
      },
      "status": "Created",
      "code": 201,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json",
          "description": ""
        }
      ],
      "cookie": [
      ],
      "body": "{\n    \"successes\": 0,\n    \"failures\": 1,\n    \"notProcessed\": 0,\n    \"details\": [\n        {\n            \"success\": false,\n            \"errors\": {\n                \"field\": \"outreachSourceCode.id\",\n                \"message\": \"<invalid id message>\"\n            }\n        }\n    ]\n}"
    },
    {
      "name": "Status201-CreateCommitmentDatabaseFailure",
      "originalRequest": {
        "method": "POST",
        "header": [
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"processingOptions\": {\n    \"donorOptions\": {\n      \"defaultUpdateLogic\": \"update_all\"\n    }\n  },\n  \"commitments\": [\n    {\n      \"amount\": 5.00,\n      \"currencyIsoCode\": \"USD\",\n      \"transactionPeriod\": \"monthly\",\n      \"transactionInterval\": 3,\n      \"transactionDay\": \"5\",\n      \"startDate\": \"2024-07-06\",\n      \"endDate\": \"2024-08-06\",\n      \"outreachSourceCode\": {\n        \"id\": \"<SFDC_OUTREACH_SOURCE_CODE_ID>\"\n      },\n      \"donor\": {\n        \"donorType\": \"individual\",\n        \"id\": \"<SFDC_ACCOUNT_ID>\",\n        \"firstName\": \"Test\",\n        \"lastName\": \"Donor\",\n        \"phone\": \"510-434-8920\",\n        \"email\": \"test.donor@salesforce.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\": \"2026\",\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      \"firstTransaction\": {\n        \"amount\": 150.25,\n        \"receivedDate\": \"2024-07-06\",\n        \"donorCoverAmount\": 0.25,\n        \"transactionStatus\": \"Unpaid\",\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      },\n      \"giftCommitmentCustomFields\": [\n        {\n          \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n          \"fieldValue\": \"string\"\n        }\n      ],\n      \"giftCommitmentScheduleCustomFields\": [\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/commitments",
          "host": [
            "{{_endpoint}}"
          ],
          "path": [
            "services",
            "data",
            "v{{version}}",
            "connect",
            "fundraising",
            "commitments"
          ]
        }
      },
      "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 Commitment Schedule object requiring the amount to be greater than 10.00. One database error occurs for the 5.00 commitment, causing the other two to be rolled back with success of false and no record links.\n{\n    \"successes\": 0,\n    \"failures\": 2,\n    \"notProcessed\": 1,\n    \"details\": [\n        {\n            \"success\": false,\n            \"errors\": {\n                \"message\": \"Amount must be greater than 10.00\"\n            }\n        }\n    ]\n}"
    },
    {
      "name": "Status201-CreateCommitmentSuccessWithExternalIds",
      "originalRequest": {
        "method": "POST",
        "header": [
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"processingOptions\": {\n    \"donorOptions\": {\n      \"defaultUpdateLogic\": \"update_all\"\n    }\n  },\n  \"commitments\": [\n    {\n      \"amount\": 2500,\n      \"currencyIsoCode\": \"USD\",\n      \"transactionPeriod\": \"monthly\",\n      \"transactionInterval\": 3,\n      \"transactionDay\": \"5\",\n      \"startDate\": \"2024-07-06\",\n      \"endDate\": \"2024-08-06\",\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        \"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\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n            \"fieldValue\": \"string\"\n          }\n        ]\n      },\n      \"paymentInstrument\": {\n        \"type\": \"credit card\",\n        \"accountHolderName\": \"david chavez\",\n        \"expiryMonth\": \"10\",\n        \"expiryYear\": \"2026\",\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        }\n      ],\n      \"firstTransaction\": {\n        \"amount\": 150.25,\n        \"receivedDate\": \"2024-07-06\",\n        \"donorCoverAmount\": 0.25,\n        \"transactionStatus\": \"Unpaid\",\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      },\n      \"giftCommitmentCustomFields\": [\n        {\n          \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n          \"fieldValue\": \"string\"\n        }\n      ],\n      \"giftCommitmentScheduleCustomFields\": [\n        {\n          \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n          \"fieldValue\": \"string\"\n        }\n      ]\n    },\n    {\n      \"amount\": 150.25,\n      \"currencyIsoCode\": \"USD\",\n      \"transactionPeriod\": \"monthly\",\n      \"transactionInterval\": 3,\n      \"transactionDay\": \"5\",\n      \"startDate\": \"2024-07-06\",\n      \"endDate\": \"2024-08-06\",\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        \"externalId\": {\n            \"fieldName\": \"<EXTERNAL_ID_FIELD_NAME>\",\n            \"fieldValue\": \"<EXTERNAL_ID_FIELD_VALUE>\"\n        },\n        \"firstName\": \"David\",\n        \"lastName\": \"Chavez\",\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\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n            \"fieldValue\": \"string\"\n          }\n        ]\n      },\n      \"paymentInstrument\": {\n        \"type\": \"credit card\",\n        \"accountHolderName\": \"david chavez\",\n        \"expiryMonth\": \"10\",\n        \"expiryYear\": \"2026\",\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        }\n      ],\n      \"firstTransaction\": {\n        \"amount\": 150.25,\n        \"receivedDate\": \"2024-07-06\",\n        \"donorCoverAmount\": 0.25,\n        \"transactionStatus\": \"Unpaid\",\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      },\n      \"giftCommitmentCustomFields\": [\n        {\n          \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n          \"fieldValue\": \"string\"\n        }\n      ],\n      \"giftCommitmentScheduleCustomFields\": [\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/commitments",
          "host": [
            "{{_endpoint}}"
          ],
          "path": [
            "services",
            "data",
            "v{{version}}",
            "connect",
            "fundraising",
            "commitments"
          ]
        }
      },
      "_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                \"giftcommitment\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_ID>\",\n                    \"id\": \"<SFDC_GIFT_COMMITMENT_ID>\"\n                },\n                \"giftcommitmentschedule\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_SCHEDULE_ID>\",\n                    \"id\": \"<SFDC_GIFT_COMMITMENT_SCHEDULE_ID>\"\n                },\n                \"giftdefaultdesignation\": [\n                    {\n                        \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_DEFAULT_DESIGNATION_ID>\",\n                        \"id\": \"<SFDC_GIFT_DEFAULT_DESIGNATION_ID>\"\n                    }\n                ],\n                \"gifttransaction\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_ID>\",\n                    \"id\": \"<SFDC_GIFT_TRANSACTION_ID>\"\n                },\n                \"paymentinstrument\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_PAYMENT_INSTRUMENT_ID>\",\n                    \"id\": \"<SFDC_PAYMENT_INSTRUMENT_ID>\"\n                },\n                \"account\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_ACCOUNT_ID>\",\n                    \"id\": \"<SFDC_ACCOUNT_ID>\"\n                }\n            }\n        },\n        {\n            \"success\": true,\n            \"links\": {\n                \"giftcommitment\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_ID>\",\n                    \"id\": \"<SFDC_GIFT_COMMITMENT_ID>\"\n                },\n                \"giftcommitmentschedule\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_COMMITMENT_SCHEDULE_ID>\",\n                    \"id\": \"<SFDC_GIFT_COMMITMENT_SCHEDULE_ID>\"\n                },\n                \"giftdefaultdesignation\": [\n                    {\n                        \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_DEFAULT_DESIGNATION_ID>\",\n                        \"id\": \"<SFDC_GIFT_DEFAULT_DESIGNATION_ID>\"\n                    }\n                ],\n                \"gifttransaction\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_GIFT_TRANSACTION_ID>\",\n                    \"id\": \"<SFDC_GIFT_TRANSACTION_ID>\"\n                },\n                \"paymentinstrument\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_PAYMENT_INSTRUMENT_ID>\",\n                    \"id\": \"<SFDC_PAYMENT_INSTRUMENT_ID>\"\n                },\n                \"account\": {\n                    \"href\": \"/services/data/vXX.X/sobjects/sObject/<SFDC_ACCOUNT_ID>\",\n                    \"id\": \"<SFDC_ACCOUNT_ID>\"\n                }\n            }\n        }\n    ]\n}"
    },
    {
      "name": "Status400-BadRequestError",
      "originalRequest": {
        "method": "POST",
        "header": [
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"processingOptions\": {\n    \"donorOptions\": {\n      \"defaultUpdateLogic\": \"update_all\"\n    }\n  },\n  \"commitments\": [\n    {\n      \"amount\": 150.25,\n      \"currencyIsoCode\": \"USD\",\n      \"transactionPeriod\": \"monthly\",\n      \"transactionInterval\": 3,\n      \"transactionDay\": \"5\",\n      \"startDate\": \"2024-07-06\",\n      \"endDate\": \"2024-08-06\",\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_ACCOUNT_ID>\",\n        \"firstName\": \"Test\",\n        \"lastName\": \"Donor\",\n        \"phone\": \"510-434-8920\",\n        \"email\": \"test.donor@salesforce.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\": \"2026\",\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      \"firstTransaction\": {\n        \"amount\": 150.25,\n        \"receivedDate\": \"2024-07-06\",\n        \"donorCoverAmount\": 0.25,\n        \"transactionStatus\": \"Unpaid\",\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      },\n      \"giftCommitmentCustomFields\": [\n        {\n          \"fieldName\": \"<VALID_CUSTOM_FIELD_API_NAME>\",\n          \"fieldValue\": \"string\"\n        }\n      ],\n      \"giftCommitmentScheduleCustomFields\": [\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/commitments",
          "host": [
            "{{_endpoint}}"
          ],
          "path": [
            "services",
            "data",
            "v{{version}}",
            "connect",
            "fundraising",
            "commitments"
          ]
        }
      },
      "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    }"
    }
  ]
}