Refunds reporting and notifications

How to access refund reports and receive real-time notifications for refund status changes.

Refunds reporting

Refunds are part of the Settlement reports and Connect Reports. The former are available via the and in Fuzebox in the Transactions > Settlements section. You can find more details on the settlement report fields . You can find details on the Connect report .

Refunds notifications

Volt will send you one notification per refund request, which will detail its final status. You'll get a notification regardless of the way of a Refund initiation.

About the notification

This notification will be delivered to your payment notifications URL set up during the
As this is a Connect notification, the User-Agent will be Volt/2.0
It will contain an X-Volt-Type header containing refund_confirmed, refund_failed or refund_rejected so that you can easily identify the message format to process

Contrary to payment notifications, it is not possible to override the notification URL set up in Fuzebox in the Refund request. Volt will always deliver the Refund notifications to the URL defined in the application.

Refund confirmed notification

If the refund was successful we'll send you a confirmation notification with the X-Volt-Type header of refund_confirmed.

Headers

POST /payment_notification_url HTTP/1.1
Host: customer.com
Content-Type: application/json
User-Agent: Volt/2.0
X-Volt-Timed: 20200131123456
X-Volt-Signed: eda5e46baa6a676851975365e12b4ae61ee48442c0cbb8d0e3c3cfd47c3e1085
X-Volt-Type: refund_confirmed

Body

{
  "refund": "026cefa0-a174-4ca3-a1e6-533a129d9c32",
  "payment": "01dfb01b-c5ab-49e4-bfa4-277c766d5ecc",
  "status": "REFUND_CONFIRMED",
  "error": "",
  "amount": 100,
  "currency": "GBP",
  "externalReference": null,
  "merchantInternalReference": "Order for a trip to Greece 20-27.08.2023",
  "timestamp": "2022-05-12T12:41:12+00:00",
  "sender": {
    "iban": "DK8389009999910135",
    "swiftBic": "ALBPPLPW",
    "name": "test customer name"
  },
  "recipient": {
    "accountNumber": "12345678",
    "sortCode": "654321",
    "iban": "DE33500105173822933531",
    "swiftBic": "SXPYDKKKXXX",
    "name": "test recipient name"
  }
}

Refund failed notification

If the Refund was not successful, we'll send you a notification with the X-Volt-Type header of refund_failed, containing details of why the Refund failed in the error field, if available.

Headers

POST /payment_notification_url HTTP/1.1
Host: customer.com
Content-Type: application/json
User-Agent: Volt/2.0
X-Volt-Timed: 20200131123456
X-Volt-Signed: eda5e46baa6a676851975365e12b4ae61ee48442c0cbb8d0e3c3cfd47c3e1085
X-Volt-Type: refund_failed

Body

{
  "refund": "83a15d24-02b8-11ed-b939-0242ac120002",
  "payment": "01dfb01b-c5ab-49e4-bfa4-277c766d5ecc",
  "status": "REFUND_FAILED",
  "error": "Payout processing has failed or was rejected by Cash Management Provider",
  "amount": 100,
  "currency": "GBP",
  "externalReference": null,
  "merchantInternalReference": "Order for a trip to Greece 20-27.08.2023",
  "timestamp": "2022-05-12T12:41:12+00:00",
  "sender": {
    "iban": "DK8389009999910135",
    "swiftBic": "ALBPPLPW",
    "name": "test customer name"
  },
  "recipient": {
    "accountNumber": "12345678",
    "sortCode": "654321",
    "iban": "DE33500105173822933531",
    "swiftBic": "SXPYDKKKXXX",
    "name": "test recipient name"
  }
}

Refund rejected notification

If the Refund was rejected, we'll send you a notification with the X-Volt-Type header of refund_rejected, containing details of why the Refund was rejected in the error field, if available.

Header

POST /payment_notification_url HTTP/1.1
Host: customer.com
Content-Type: application/json
User-Agent: Volt/2.0
X-Volt-Timed: 20200131123456
X-Volt-Signed: eda5e46baa6a676851975365e12b4ae61ee48442c0cbb8d0e3c3cfd47c3e1085
X-Volt-Type: refund_rejected

Body

{
  "refund": "83a15d24-02b8-11ed-b939-0242ac120002",
  "payment": "01dfb01b-c5ab-49e4-bfa4-277c766d5ecc",
  "status": "REFUND_FAILED",
  "error": "Payout processing has failed or was rejected by Cash Management Provider",
  "amount": 100,
  "currency": "GBP",
  "externalReference": null,
  "merchantInternalReference": "Order for a trip to Greece 20-27.08.2023",
  "timestamp": "2022-05-12T12:41:12+00:00",
  "sender": {
    "iban": "DK8389009999910135",
    "swiftBic": "ALBPPLPW",
    "name": "test customer name"
  },
  "recipient": {
    "accountNumber": "12345678",
    "sortCode": "654321",
    "iban": "DE33500105173822933531",
    "swiftBic": "SXPYDKKKXXX",
    "name": "test recipient name"
  }
}

Refunds reporting and notifications

Refunds reporting

Refunds notifications

About the notification

Refund confirmed notification

Refund failed notification

Refund rejected notification

On this page