Skip to main content

Environments

Sandbox

Topper's sandbox is an environment that simulates the live Topper production environment. The sandbox environment provides a space where you can test your integration with Topper without touching any live accounts, and without using any real funds.

  • Topper App URL: https://app.sandbox.topperpay.com/
  • Topper REST URL: https://api.sandbox.topperpay.com/
info

If you face issues initializing Topper and see a 'something went wrong' error page, check the devtools console for details on the bootstrap token validation.

Email authentication and phone verification codes

You can bypass email authentication and phone verification codes by typing 000000.

Credit cards

The following card details can be used to force specific outcomes:

Card numberOutcome
4921817844445119success
4312810406702461card_unauthorized
4414745735532923card_declined_by_bank
4916426384864999request_data_invalid
4086439018748730card_expired
4532942248840268card_unsupported
4929216735379028insufficient_funds
4748972091871094amount_invalid
4916526184701927velocity
tip

When using the above card numbers, Topper will accept any value for the expiry date and CVV.

Production

After successfully onboarding and testing your integration in our sandbox environment, you can start Topper sessions for your end users using the production environment.

  • Topper App URL: https://app.topperpay.com/
  • Topper REST URL: https://api.topperpay.com/
info

For security reasons, your widget id and key id for sandbox won't work in production. You need to generate a new signing key for production usage.