Authorization
When using the Charge API, include the Authorization header in your requests and set its value to the GUID provided below. This GUID identifies the transaction source within Donary, such as an external charity campaign or a Donary device, and corresponds to sources listed in the Donary DRM. Below is a test GUID for development purposes. For a production GUID, please contact integrations@donary.com.
Example of a cURL command with an authorization header for the sandbox environment:
curl --location --request PUT 'https://sandbox-api.donary.com/v1/External/Charge' \
--header 'Authorization: 96F666B4-587B-4CE3-B4D0-CF04C333794B' \
--header 'Content-Type: application/json' \
--data-raw '{"donor":{"accountNum":"10","firstName":"Yaakov","lastName":"Freedman","phoneNumber":"7185556666"},"campaignNum":5,"campaignName":"Beis Medresh","reason":{"reasonNum":1000,"reasonName":"Keren Habinyan"},"amount":10,"ccNum":"4242424242424242","expiry":"12/28","cvv":"456","note":"Charge Test","paymentDate":"2024-10-29T10:30:43.007Z","paymentMethodId":"Credit_Card","uniqueTransactionId":"586f0af4-9409-e684-3ef9-b81bda1fd6c971-152[8g","currency":"USD","reasons":null,"bankAccount":null,"orgGUID":"115e9d3d-baf2-4089-b896-9b2621ffcf1b"}'
Sandbox
GUID:
Use the following GUID for development purposes only.
96F666B4-587B-4CE3-B4D0-CF04C333794B
Production
After development and testing are complete, contact integrations@donary.com to obtain a GUID for production use.
The orgGUID is an required field on all API requests. If you do not know your orgGuid, please reach out to Donary.