Getting Started
Quickstart
Make your first end-to-end deposit in the sandbox with a test key
This page is the shortest path from credentials to your first deposit.success webhook, using a test key (unk_test_) in the sandbox — no real money yet.
Every request must be HMAC-SHA256 signed, and every money field is a 2-decimal baht string (e.g.
"100.50") — see the later sections for full details.Steps
Prepare a test key + webhook
Follow Portal Preparation to issue a test key and set a webhook URL (make sure it returns 2xx).
Create a deposit (test)
Call POST /v1/deposits (signed HMAC + Idempotency-Key) with an amount and payer details — the system returns expected_amount + qr_payload/pay_to.
Simulate the transfer
Call POST /v1/test/simulate-transfer with the deposit_id (omit amount so it matches exactly). The matcher credits the deposit.
Receive the deposit.success webhook
Your endpoint receives the webhook — verify the X-Webhook-Signature and return 2xx to complete the flow.
Run the entire end-to-end flow in test mode first — switch to live just by using a
unk_live_ key, not by changing the endpoint.