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