Skip to main content
Cadana’s sandbox environment lets you test your integration without processing real financial transactions. The sandbox APIs mirror production, so transitioning to live is as simple as updating the host and API key. Sandbox host: https://dev-api.cadanapay.com
Use an API key generated for the sandbox environment. Production API keys will not work with the sandbox host.

​
Funding Your Wallet

Use the sandbox deposit endpoint to add test funds to your wallet:
bash
curl -X POST 'https://api.cadanapay.com/v1/sandbox/business-deposits' \ -H 'Authorization: Bearer YOUR_API_KEY'

​
Simulated Payment Failures

To test your error handling, use specific accountName values when creating a beneficiary to trigger simulated payment failures:
Account NameSimulated Failure
FAILURE_SIM_001Invalid account
FAILURE_SIM_002Bank unavailable
FAILURE_SIM_003Rejected by compliance
FAILURE_SIM_004Returned by bank
Set the accountName in the beneficiary’s bank payment details:
bash
curl -X POST 'https://api.cadanapay.com/v1/beneficiaries' \ -H 'Authorization: Bearer YOUR_API_KEY'
When the payout is processed, it will fail with the corresponding error message — in this case, “Rejected by compliance”.

​
Virtual Account Auto-Approval

When creating a virtual account in sandbox, use 99999900 as the customIdentification.number to automatically approve the account. The type (SSN or BVN) does not matter.
bash
curl -X POST 'https://api.cadanapay.com/v1/users/userId/virtual-accounts' \ -H 'Authorization: Bearer YOUR_API_KEY'

​
KYB Testing

Use these test values when submitting KYB information in sandbox to simulate different outcomes.

​
Tax Identification Number

Tax IDResult
000-CAD-AUTO-APPROVEKYB automatically approved
000-CAD-AUTO-FLAGStatus set to needs-additional-info — flags tax ID as incorrect and requests all business documents

​
Principal SSN

SSNResult
000-11-2222Status set to needs-additional-info — requires identity (front and back) and address files for the principal
000-11-3333Status set to needs-additional-info — principal receives email to complete KYC via provider
bash
curl -X POST 'https://api.cadanapay.com/v1/businesses/{businessId}/kyb' \ -H 'Authorization: Bearer YOUR_API_KEY'
All sandbox test values are ignored silently in production.