Simulate a virtual account payment

Sandbox-only endpoint that simulates an incoming payment to a virtual account. Submits an account number and amount; the system processes it as if a real bank transfer arrived. Intended for end-to-end webhook and reconciliation testing in non-production environments.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

6. Simulate a Virtual Account Payment

POST /api/virtual-accounts/simulate

⚠️

Sandbox only. This endpoint is not available in production. It simulates an inbound bank transfer to a virtual account so you can exercise your webhook-receiving and reconciliation logic end-to-end without a real bank transfer.

Request Body

FieldTypeRequiredDescription
account_numberstringYesThe 10-digit virtual account number to simulate a transfer into.
amountnumberYesAmount in minor units. Must be at least 1.0.

Example Request

{
  "account_number": "9988776655",
  "amount": 500000
}

Example Response

{
  "success": true,
  "message": "payment simulated successfully"
}

Within seconds you'll receive a virtual_account webhook on your configured webhook URL — see the Webhooks guide for the payload shape and signature verification details.

Body Params

Account number (10 digits) and amount to simulate

string
number
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json