Sandbox Simulator

Drive a real reconciliation with zero money (test-mode).

Drive the real reconciliation engine with zero money. Simulate a deposit into one of your accounts and watch it reconcile — splits and money rules fire exactly as they would for a live bank transfer.

Test-mode keys only

The simulator rejects live keys with 403. Use a test key against the sandbox base URL. This keeps the "zero real money" guarantee.

Each call is a new deposit

Every simulate is a fresh inflow, so amounts accumulate. Simulate ₦1,000 then ₦500 into a ₦1,000-expected account and it goes FullyPaid → Overpaid. It is not idempotent by design.

Same code path as production

The simulator calls the identical reconciliation routine a live webhook uses, so a green sandbox run is real proof your integration works.

post/api/v1/sandbox/simulate/deposit

Simulate a deposit into one of your virtual accounts (test mode only).

Requires Bearer token

Body parameters

accountRefstringoptional

amountKobointegeroptional

senderNamestringoptional

reversalbooleanoptional

Responses

200OK403Forbidden

POST /api/v1/sandbox/simulate/deposit

curl -X POST "https://api.xental.online/api/v1/sandbox/simulate/deposit" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "accountRef": "inv_001",
    "amountKobo": 500000
  }'

Example request body

{
  "accountRef": "inv_001",
  "amountKobo": 500000
}