Developer Documentation

Provider Simulation

Provider Simulation

Sandbox provider simulation lets QA and mobile developers test payment and withdrawal outcomes before real provider integration.

Endpoints

• POST /v1/sandbox/provider/payments/success
• POST /v1/sandbox/provider/payments/fail
• POST /v1/sandbox/provider/withdrawals/success
• POST /v1/sandbox/provider/withdrawals/fail
• POST /v1/sandbox/provider/webhooks/send
• POST /v1/sandbox/provider/webhooks/duplicate
• POST /v1/sandbox/provider/webhooks/invalid-signature

All endpoints require an admin token and are blocked in production mode.

Scenario Management

• GET /v1/admin/sandbox/provider-scenarios
• POST /v1/admin/sandbox/provider-scenarios
• PUT /v1/admin/sandbox/provider-scenarios/{id}
• POST /v1/admin/sandbox/provider-scenarios/{id}/activate
• POST /v1/admin/sandbox/provider-scenarios/{id}/deactivate

Supported behaviors: success, fail, timeout, pending, duplicate_webhook, invalid_signature.

Payload

{
  "provider_reference": "SHB-SBX-PROV-20260513-ABC123"
}

If no provider reference is supplied, the API generates an SHB-SBX-* reference.