Operate
Testing & go-live checklist
How to test your integration safely, and what to check before real customers pay.
#How to test
GTRADE payments run on real blockchains, so test with real but small amounts:
- Exercise the API without paying. Create payments, retrieve and list them, and try your error handling. Unpaid payments simply stay
openuntil the link expires and they becomecancelled. They cost nothing. - Test webhooks without paying. Sign a sample event locally (how), then register your public endpoint and use
POST /v1/webhooks/{id}/test. - Make one small real payment end to end. Create a USD 1–5 payment, pay it from your own wallet with a low-fee option (for example USDC on Base), and check that: - the checkout detects the deposit and shows the confirmations; - your endpoint receives
payment.updated(pending) and thenpayment.paid; - your order is marked paid exactly once; - the payment appears in the dashboard under Payments → All Payments; - the funds arrive in your settlement wallet. - Try the edge cases you care about: an underpayment (
partially_paid), an expired link (cancelled), a duplicate webhook, your endpoint being down for a few minutes (retries).
Note: A test payment is a real crypto payment. Network fees and your GTRADE plan fee apply, and GTRADE can't reverse it. Refund yourself manually if needed (see refunds).