Skip to main content
Skip table of contents

Getting Started with Sandbox Testing

This Implementations resource explains the difference between sandbox and production environments and outlines steps to create and access sandbox accounts.

What is Sandbox?

Sandbox is a testing environment that directly mirrors both the Payrix Portal and API. Clients can utilise Sandbox to ensure their integration and workflow configurations are working as expected, test the various features and functions of the Portal and API, and generally familiarise themselves with the Payrix Platform.

See your Partner manager and contact us at for Sandbox credentials and account setup.

Sandbox vs. Production Environments: Know the Difference

While the Sandbox Portal and API directly mirror the features and functionality of the live production environment, actions and transactions performed in Sandbox do not have any actual impact on your Merchants or live production account. Thus, no funds ever exchange hands and no real-world implications ever occur as a result of your actions in Sandbox.

For example, you can test the entire transaction submission and processing timeline mirroring exactly as it would occur in production, without any money actually exchanging hands. This gives clients the flexibility and the peace of mind to test any element of the Payrix Platform before launching a new solution or modifying their production account.

Want to test payment submissions in Sandbox? When using the test API, the transaction amount gives you the ability to test both successful and failed payments. When the transaction amount has zero cents or a number of cents other than the ones listed below, the test transaction will always be successful. If you provide one of the following numbers for the number of cents you will receive a transaction failed response with the corresponding reason:

  • 31 = Invalid Account

  • 54 = Expired card - Card Only

  • 51 = Declined

  • 61 = Insufficient Funds

  • 96 = Technical failure - Card Only

Key Features of Sandbox

  • Get to know the “ins and outs” of the Payrix Portal and API without the risk of real-world negative implications as you learn.

  • Test new integrations and automated workflows to ensure they meet your expectations before launching them in live production.

  • Use the Sandbox API to familiarise yourself with request and response and send practice requests to API resources you will commonly use in production.

  • Determine which onboarding options are ideal for your portfolio.

  • Submit test transactions via any of our payment solutions to understand the process, statuses, and timeline, as well as to determine which option/s most meet your Merchants' needs.

  • Create sample transaction parameters to test the various decisions and triggers.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.