Testing on Sandbox

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

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 REFUND_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 REFUND_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 REFUND_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 REFUND_FAILED status
• You should receive the corresponding refund notification with the X-Volt-Type of refund_failed in your payment notifications endpoint