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