Refunds reporting and notifications

Refunds reporting

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

Please note that all Volt reports express the values in minor units. This means that 100 reported = 1 unit of the respective currency.

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 Application creation
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"
  }
}