Reversal notifications

Sometimes a pay-in credit to your Volt account could be reversed automatically (returned back to sender). The reversal could happen weeks or even months after receiving a pay-in credit. When this happens a notification can be triggered and sent to the notifications web hook URL provided during onboarding.

The credit_reversed notification described below is not sent by default. If you wish to receive them, you need to opt-in. Please contact your account or implementation manager for further details, or email us at support@volt.io.

X-Volt-Signed: The signature of the message
X-Volt-Timed: The timestamp of the message
X-Volt-Type: credit_reversed

Body

{
  "eventId": "02399d85-80b4-4945-8001-a75f0877432d",
  "notificationType": "credit_reversed",
  "timestamp": "2024-04-08T08:00:00+00:00",
  "transactionDetails": {
    "id": "f267bfe2-a17c-41b0-895d-e2f28ff12664",
    "status": "SUCCESS",
    "errors": [],
    "debtorDetails": {
      "debtorAccount": {
        "accountNumber": "XXXXXXXXXXXXXXX",
        "financialInstitution": "REVOLT21XXX",
        "country": "LT"
      },
      "debtorName": "Adam Smith",
      "debtorAddress": null,
      "viban": null
    },
    "debitAmount": {
      "amount": "1000",
      "currency": "EUR"
    },
    "date": "2024-04-08T08:00:00+00:00",
    "remittanceInfo": {
      "line1": null,
      "line2": null,
      "line3": null,
      "line4": null
    },
    "externalId": "72de0d43-7b15-4b57-b1cb-88b8c72d70fe",
    "creditorDetails": {
      "creditorAccount": {
        "accountNumber": null,
        "financialInstitution": null,
        "country": null
      },
      "creditorName": "John Doe",
      "creditorAddress": null,
      "viban": null,
      "account": {
        "iban": null
      }
    },
    "creditAmount": {
      "amount": "1000",
      "currency": "EUR"
    }
  }
}

Field	Type	Notes
`eventType`	uuid	notification identifier
`notificationType`	string	`credit_reversed`
`timestamp`	timestamp	timestamp when notification was created and sent
`transactionDetails.id`	uuid	Volt reversal identifier
`transactionDetails.status`	string	always SUCCESS
`transactionDetails.errors`	array	empty for reversals
`transactionDetails.debtorDetails.debtorAccount.accountNumber`	string	IBAN or Account Number
`transactionDetails.debtorDetails.debtorAccount.financialInstitution`	string	SWIFT/BIC or Sort code
`transactionDetails.debtorDetails.debtorAccount.country`	string	country code
`transactionDetails.debtorDetails.debtorName`	string	original credit beneficiary name
`transactionDetails.debtorDetails.viban`	string	virtual IBAN number (if available)
`transactionDetails.debitAmount.amount`	string	amount in minor units
`transactionDetails.debitAmount.currency`	string	currency code
`transactionDetails.date`	timestamp
`transactionDetails.externalId`	uuid	transaction identifier at banking provider (if available)
`transactionDetails.creditorDetails.creditorAccount.accountNumber`	string	IBAN or Account Number
`transactionDetails.creditorDetails.creditorAccount.financialInstitution`	string	SWIFT/BIC or Sort code
`transactionDetails.creditorDetails.creditorAccount.country`	string	country code
`transactionDetails.creditorDetails.creditorName`	string	original credit payer name
`transactionDetails.creditorDetails.viban`	string	virtual IBAN number (if available)
`transactionDetails.creditAmount.amount`	string	amount in minor units
`transactionDetails.creditAmount.currency`	string	currency code

Reversal notifications

Retry strategy

Security

Headers

Body

On this page