Use our sandbox

Start the sandbox mode

If you want to implement our services without any test cards or other accounts you can use our sandbox mode. In this sandbox mode you can fully simulate all e-commerce features we offer.

The sandbox mode can be accessed in several ways:

• Use paymentMethod 613; Start a payment with the Order:Create API and use
  paymentMethod.id: 613
• Set your saleslocation in test mode; Login into https://my.pay.nl and navigate to Settings > Sales location. Locate the sales location that you want to use and toggle the Mode to 'Test'
• Use the integration parameter; Start a payment with the Order:Create API and use
  integration.test = true

📘

Test or live?

A payment is send in live mode if the sales location is 'LIVE' AND the request message does not contain integration.test = true and the payment method ID is NOT 613

Use the sandbox mode

When a payment in the sandbox mode has been started with the Order:Create API, you will receive in the response a links object.

If you follow the redirect link you will be redirected to the payment method selection screen or directly to the sandbox (depends how you start the sandbox mode).

With the sandbox you can set the payment in the next status, following these steps:

• Enter the secret which belongs your sales location (see Getting the credentials)
• Select the status in which you want the payment to be. If you want the set the payment to PAID select the Captured/Paid option
  • You can enter a customer reference (optional) and a customer name (optional). If you want us to generate these values, press the icon in in the inputbox.
  • Provide the amount for which the payment needs to be set to PAID

• Press the 'Update status' button and we will redirect you to the return URL

🚧

Exchanges and return URL

If you have configured an exchange URL in the sales location or you have provided an exchange URL in the request message we will sent the appropriate exchanges so that you can test the entire integration.

Also you will be redirected to the return URL after you have successfully set the payment to PAID.

Test your integration with the Sandbox

We have defined a couple of test cases. To start testing your integration with these test cases make sure you have configured your sales location to Test mode or that you are able to provide the integration.test value to true in your integration.

If you provide the right amount, the sandbox will check if the provided values, matches the expected values.

In the screenshot below, you can see the results of the test. The block 'Order information' indicates which testcase is triggered and summarises which values are as expected (passed), which values are mismatched and which values are missing.