Sandbox Simulation
For webhook setup, payload shapes, and signature verification, see the Webhooks section.
Simulate a Sandbox Payment
Section titled “Simulate a Sandbox Payment”Overview
Section titled “Overview”Test-mode only: forces a sandbox payment to paid, failed, or expired
without a real QRIS/bank provider, so you can exercise your webhook end to
end.
POST
/sandbox/payments/{providerPaymentID}/simulateNot authenticated with an API key — providerPaymentID comes from a
sandbox payment’s checkout_url.
Path Parameters
Section titled “Path Parameters”| Parameter | Type | Description |
|---|---|---|
providerPaymentID |
string | From the sandbox payment’s checkout_url |
Request
Section titled “Request”{ "outcome": "paid" }outcome is one of paid, failed, expired.
Response
Section titled “Response”{ "duplicate": false, "payment": { /* Payment object, updated to the simulated status */ }}If your project has a webhook configured for the sandbox environment,
simulating an outcome triggers a real payment.paid / payment.failed
delivery — see payment.paid /
payment.failed for the payload
shape, and
Handling Webhook Deliveries for
how to use this in testing.