Sandbox Testing
In a nutshell
Use a demo or sandbox workspace to test your billing flow before accepting production payments.Test flow
- Create or obtain a tenant API key.
- Create a plan.
- Create a customer.
- Initialize checkout for the plan and customer.
- Complete checkout using test payment details provided for your environment.
- Receive merchant webhook events.
- Confirm your app grants access after
invoice.paidorpayment_success. - Confirm your app handles
invoice.payment_failedandsubscription.paused.
Recommended assertions
| Step | What to check |
|---|---|
| Plan creation | Plan has the expected amount, interval, and currency. |
| Customer creation | Customer email and external reference match your system. |
| Checkout | Checkout link is returned and redirects correctly. |
| Payment success | Your webhook endpoint receives a success event. |
| Subscription | Customer is marked subscribed in your app. |
| Failure | Failed payment does not grant access. |
Webhook events to test
payment_method.attachedinvoice.paidinvoice.payment_failedsubscription.createdsubscription.pausedpayment_success
