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:

​
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: 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.

​
KYC Testing

Use these test values when submitting KYC in sandbox to simulate different verification outcomes.

​
Identity Document Number

ValueResult
auto-approveIdentity verification automatically approved
auto-rejectIdentity verification automatically rejected

​
Address Line 2

ValueResult
auto-approveAddress verification automatically approved
auto-rejectAddress verification automatically rejected
Identity and address sentinels can be combined in a single request to control each verification independently. Sentinel values are case-insensitive. These sentinels work with both initial submission (POST) and resubmission (PATCH). Initial submission: Resubmission (after rejection):

​
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-REJECTKYB automatically rejected (terminal)
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
All sandbox test values are ignored silently in production.