Test mode

Develop and test integrations without real money. Use TEST projects and tp_test_ keys exclusively during development.

Sandbox checklist

Switch dashboard to TEST environment
Create a tp_test_ API key on the TEST project
Use pl_test_ payment link prefixes in responses
Simulate payment instead of scanning real QR codes

Test vs live keys

Test — tp_test_…

Sandbox orders, simulated payments, no real funds. Works only with TEST projects.

Live — tp_live_…

Real payments after merchant verification. Requires LIVE project and approved account.

Simulate payment

Mark a test order as paid without scanning a real QR. Fires order.paid with livemode: false. Returns test_mode_required (403) in LIVE mode.

POST/api/v1/projects/:projectId/orders/:id/simulate-payment

TEST only

Permission: orders:write

Example

curl -s -X POST "https://pay.andgroupco.com/api/v1/projects/PROJECT_ID/orders/ORDER_ID/simulate-payment" \
  -H "Authorization: Bearer tp_test_xxxxxxxxxxxxxxxx"

Response headers

Every API response includes environment context:

X-TowanPay-Environment — TEST or LIVE
X-TowanPay-Livemode — false in test mode

Going live

Complete merchant verification, switch to LIVE project, create tp_live_ key, and update your integration. See authentication.