How do I test my integration in sandbox?

Sandbox is an account mode, not a separate key. While it is on, every payment created with the same API key and base URL becomes a test transaction (is_sandbox: true) that never touches money, your balance, or revenue reports.

This page was checked against the API code as of October 16, 2026.

How do I use sandbox?#

Turn on sandbox mode
API Settings, Mode & access. It applies to the whole account until you turn it off.
Create a payment as usual
Requests, signatures, and response shapes match production. The response contains is_sandbox: true.
Open payment_link
It leads to the sandbox payment page. The VA numbers and QR codes there are fake and cannot be paid.
Simulate the outcome
Click simulate success or failure. The buttons only work from that page: the simulation URLs are signed and cannot be called directly.
Receive the webhook
The webhook goes to your callback_url with the same fields, date format, and signature as production.

What differs from production?#

Topic	Sandbox	Production
Paid status (webhook and status check)	`completed`	`paid`
Webhook for failed payments	Sent with status `failed` when you simulate failure.	Not sent. Unpaid payments become `canceled` after they expire; see it through a status check.
Money and balance	None. Nothing reaches your balance or reports.	Credited to your held balance, then released on the method's schedule.
Payment details	Fake VA numbers and QR codes.	From the payment partner.

Treat both paid and completed as paid

Code that only checks status === "paid" never passes in sandbox, and code that only checks completed never passes in production.

What changes when I go live?#

Only the account mode: turn sandbox off under Mode & access. The API key, secret key, base URL, and webhook URL stay the same. Existing sandbox transactions keep is_sandbox: true and are never counted in your balance or reports.

Ready to use your own keys?

Sign in to the merchant dashboard to copy your API key and secret key, set the access mode and webhook URL, and download a Postman collection with your account's keys.