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.paid or payment_success.
Confirm your app handles invoice.payment_failed and subscription.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.attached
invoice.paid
invoice.payment_failed
subscription.created
subscription.paused
payment_success