Sandbox

When building your application, you’ll likely want to fully test functionality in the sandbox environment before going live.

All APIs in these docs are available in Sandbox.

Additionally, Chariot provides a set of Simulation APIs, which are only available in Sandbox. These APIs allow you to quickly test financial related events that might take long periods of time to occur in the real world (Production).

If you have a sandbox Event Subscription configured, calling these APIs will also result in the appropriate webhooks being sent to your endpoint.

Testing disbursement payment rails

Which payment rail a disbursement settles on depends on whether the recipient organization has a Chariot account. An organization without a Chariot account is paid by mailed check; an organization with one is paid electronically.

In Sandbox, an organization you disburse to has no Chariot account by default, so its disbursements settle as a check. To test the electronic rails, onboard the organization first with the Simulate Onboard Organization simulation. Onboarding provisions a Chariot account for the organization and lets you choose which electronic rail its disbursements settle on:

1
curl -X POST https://api.givechariot.com/v1/simulations/organizations/onboard/org_1LaXpKGUcADgqoEMl0Cx0Ygg \
2
     -H "Authorization: Bearer <token>" \
3
     -H "Content-Type: application/json" \
4
     -d '{
5
  "settlement": "SANDBOX_SETTLEMENT_ACCOUNT_TRANSFER"
6
}'

To test the check rail, simply disburse to an organization you have not onboarded.