How to test refunds

Testing on Sandbox

We have created an automated process to enable you to test both CONFIRMED and FAILED scenarios using our Sandbox environment.

Testing the signing of your refund request can only be completed in the production environment. We suggest creating a small payment then refunding it to test that your signature works.

Find out more about signing requests

Test for confirmed refunds

You can test a successful refund using Fuzebox or the Connect API in the Sandbox environment once you’ve created a payment and received a payment_received notification for it.

Using Fuzebox

Using the Volt API, create a payment with an amount of 1177 minor units.
Send this payment using the Volt Mock Bank
Find the payment in Fuzebox
Wait until the status of the payment has changed to RECEIVED
Click on the Refund Transaction button and enter your authentication code when prompted
After a few seconds, the refund request should transition to the CONFIRMED status
You should receive the corresponding refund notification with the X-Volt-Type of refund_confirmed in your payment notifications endpoint

Using the API

Using the Volt API, create a payment with an amount of 1177 minor units.
Send this payment using the Volt Mock Bank
Wait until you receive the payment_received notification
Send a full refund request for that payment ID, by POSTing a body containing empty JSON.

POST

https://api.sandbox.volt.io/payments/{paymentId}/request-refund

Body

{}

After a few seconds, the refund request should transition to the CONFIRMED status
You should receive the corresponding refund notification with the X-Volt-Type of refund_confirmed in your payment notifications endpoint

Test for failed refunds

You can also test a failed refund using Fuzebox or the Connect API for a previously received payment. It’s important that when you’re creating your payment, you use a value of exactly 1178. This will automatically trigger the refund to fail when you request it.

Using Fuzebox

Using the Volt API, create a payment with an amount of 1178 minor units.
Send this payment using the Volt Mock Bank
Find the payment in Fuzebox
Wait until the status of the payment has changed to RECEIVED
Click on the Refund Transaction and enter your authentication code
After a few seconds, the refund request should transition to the FAILED status
You should receive the corresponding refund notification with the X-Volt-Type of refund_failed in your payment notifications endpoint

Using the API

Using the Volt API, create a payment with an amount of 1178 minor units.
Send this payment using the Volt Mock Bank
Wait until you receive the payment_received notification
Send a full refund request for that payment ID, by POSTing a body containing empty JSON.

POST

https://api.sandbox.volt.io/payments/{paymentId}/request-refund

Body

{}

After a few seconds, the refund request should transition to the FAILED status
You should receive the corresponding refund notification with the X-Volt-Type of refund_failed in your payment notifications endpoint