Skip to main content

Sandbox Testing

In a nutshell

Use a demo or sandbox workspace to test your billing flow before accepting production payments.

Test flow

  1. Create or obtain a tenant API key.
  2. Create a plan.
  3. Create a customer.
  4. Initialize checkout for the plan and customer.
  5. Complete checkout using test payment details provided for your environment.
  6. Receive merchant webhook events.
  7. Confirm your app grants access after invoice.paid or payment_success.
  8. Confirm your app handles invoice.payment_failed and subscription.paused.
StepWhat to check
Plan creationPlan has the expected amount, interval, and currency.
Customer creationCustomer email and external reference match your system.
CheckoutCheckout link is returned and redirects correctly.
Payment successYour webhook endpoint receives a success event.
SubscriptionCustomer is marked subscribed in your app.
FailureFailed payment does not grant access.

Webhook events to test

  • payment_method.attached
  • invoice.paid
  • invoice.payment_failed
  • subscription.created
  • subscription.paused
  • payment_success