Testing on Sandbox
In order to test one or more payment flows on your configured Sandbox environment, please follow the following steps.
- Authenticate using your API user: https://docs.volt.io/gateway/authentication
- Request a payment: https://docs.volt.io/docs/first_payment/request_payment
- Redirect the shopper to the Volt checkout page: https://docs.volt.io/docs/first_payment/volt_redirect
- Select one of the test banks on the Volt checkout page listed below and click on Continue.
So that you have a fully-featured integration, we recommend that you test all of the possible statuses below.
Disclaimer
When testing, please note that only the banks OBIE Mock Bank and Volt Mock Bank are controlled by Volt.
All other banks listed below use connections into the sandbox environment of the actual bank. The scenarios and banks listed below are liable to change as these environments are controlled by the banks.
Should you attempt to test with a bank sandbox and experience issues, please repeat the test at a later time, or with a different bank (we recommend using OBIE Mock Bank or Volt Mock Bank).
Testing specific statuses with banks
To test these specific statuses, you can use one of the mock or sandbox banks that support that status.
The “COMPLETED” status is supported by the following banks
- OBIE Mock Bank (EUR & GBP)
- Volt Mock Bank (EUR & GBP)
- Bank of Scotland Sandbox (GBP only)
- Username: llr001
- Password123
- Modelo Bank (GBP only)
- Username: mits
- Password: mits
- Royal Bank of Scotland Sandbox (GBP only)
- Customer Number: 123456789012
- When prompted to enter your PIN and Password, the values to enter will be displayed above each text box
- Please enter these values in each box before selecting ‘Continue’
- Fiducia & GAD IT (EUR Only)
- Note – for this option to appear, the country selected in the checkout must be “Germany”
- IBAN:
DE55499999600000005114
- Username:
VRK1234567890ALL
- Password:
password
FAILED
- Vanquis Bank (GBP Only)
- Cumberland Building Society Sandbox (GBP only)
REFUSED_BY_BANK
- OBIE Mock Bank (EUR & GBP)
- Royal Bank of Scotland Sandbox (GBP only)
- Customer Number:
123456789012
- When prompted to enter your PIN and Password, the values to enter will be displayed above each text box
- Please enter these values in each box before selecting ‘Continue’
- Triggered when making payment higher than the balance of the account used
- Customer Number:
- Fiducia & GAD IT (EUR Only)
- Note – for this option to appear, the country selected in the checkout must be “Germany
- IBAN:
DE28499999600000005115
- Username:
VRK1234567890ALL
- Password:
password
- SMS:
123456
DELAYED_AT_BANK
- OBIE Mock Bank (EUR & GBP)
- Monzo (GBP Only)
AWAITING_CHECKOUT_AUTHORISATION
- Deutsch Postbank Sandbox DE (EUR only)
- Note – for this option to appear, the country selected in the checkout must be “Germany”
- IBAN:
DE90100100100928099103
- User:
VRK1234567890ALL
- Password:
password
- Select
RolandmTAN
as the authorisation method - TAN:
123654
CANCELLED_BY_USER
Triggered if the shopper clicks on the cancel button during the checkout process, or cancels the payment at their bank.
- Click on the cancel button during the checkout
- At the bank, click on the cancel option (or equivalent) prior to login, or after login
ABANDONED_BY_USER
Triggered automatically if a payment is not completed within approximately 30 minutes. This typically happens if the shopper redirects to the bank and then navigates away to a different website or closes their browser.
- Create a payment, redirect to the bank then don’t complete the payment or click cancel
- After approximately 30 minutes, notification of this status will be received
Testing other statuses
REFUSED_BY_RISK
Refused by risk is a status you’ll only see if you’re using Volt’s Circuit Breaker product. Payments are scanned before the shopper is redirected to their bank and will fail if one of the configured rules is triggered.
- Make a payment triggering one of your risk rules or containing items on the blocklist within Circuit Breaker
Testing other countries
Testing PIX (Brasil) in the Sandbox environment
We support the testing of both successfully received transactions and failed transactions in the Sandbox environment. To test the two different flows, use the amount as the trigger.
- If the amount ends in 00 (e.g. sending 1000 to represent BRL 10.00), we will automatically simulate the payment being successfully made.
- Any other value will simulate the payment not being made, so you will not be able to see the complete checkout when redirected to the checkout page.
Check PIX integration manual to find out more about testing PIX payments.
Testing AU checkout in the Sandbox environment
Test an unsuccessful payment
We have three scenarios for testing unsuccessful payments, which are the most common reasons for a payment to fail. Enter the corresponding BSB for the scenario you’d like to test, with any 8 digit account number.
BSB | FAILURE SCENARIO THAT WILL BE SIMULATED |
---|---|
100000 | Invalid BSB |
100001 | The bank does not have PayTo capabilities |
100002 | The bank is not able to receive funds |
Testing a successful payment
If you use any other BSB, the sandbox will create a payment successfully and send you the appropriate notification. You can use any 8 digit account number.
Check PayTo integration manual to find out more about testing Australian PayTo payments.
Testing Volt Connect
The following statuses are for customers using Volt Connect only. When using Connect, the status will change to COMPLETED once the shopper has authorised the payment at their bank. It will then usually transition to RECEIVED, but very occasionally will result in the funds being NOT_RECEIVED.
Find out more about Volt Connect
NOT_RECEIVED
For customers using Volt Connect only. This simulates the payment funds not arriving in the Volt Connect account, even though they’ve been authorised at the bank.
- Create and approve a payment at any bank, with the specific
amount
of2050
- The NOT_RECEIVED status will happen once the COMPLETED status is received