Overview
Setting up and handling Volt payment notifications via webhooks
About Volt Notifications
We inform you of a payment's success/failure/pending status by sending a POST request that contains a digitally signed payment notification to a secure URL on your server. This happens in the background and is not visible to the shopper.
Notification vs Return URL
You should always rely on the information sent in notifications rather than the return URL the shopper was redirected to. This is especially important for embedded checkouts where the return URLs are not used.
By using a secret key that you receive during application setup, you can check the signature of the message to confirm that it came from Volt and is a genuine notification. Never process any message that appears to originate at Volt without performing this verification step first.
If a status was originally pending, we'll send you another notification when it changes to success or failure. Each notification will be digitally signed, and you'll then need to confirm that you have received the notification and the signature is correct.
Important!
The success notification is only a confirmation that the payment was successfully initiated at the bank. Some banks allow payments to be cancelled after they are initiated so this is not a guarantee that the funds will arrive in your account. Note, however, that we do issue payment received notifications via Connect.
Payment notifications
For our core Gateway and Pay by Link products, we'll send a notification to your payment notification URL if:
- A payment initiation is complete
- A payment is delayed
- The payment initiation fails for any reason
Notification fields
The body of the notification contains a JSON formatted data structure, which has the following fields:
Prop
Type
Example notification body
If the payment was refused by the shopper's bank:
{
"payment": "292d48f6-90f3-450b-93eb-0b480b8b70dd",
"reference": "Invoice-12346",
"merchantInternalReference": "Order for a trip to Greece 20-27.08.2026",
"amount": 1000,
"status": "COMPLETED",
"detailedStatus": "COMPLETED"
}View expected payment processing times
Additional notification content
Volt can provide additional details in your payment notifications. The following table shows the full list of supported fields. It is possible to manage the additional notification content through our merchant portal Fuzebox inside the Application section.
List of available fields:
Prop
Type
Example notification content:
{
"payment":"f839adfb-4b16-422d-a056-b10d5307660f",
"reference":"uniquereference",
"merchantInternalReference": "Order for a trip to Greece 20-27.08.2026",
"amount":2500,
"status":"COMPLETED",
"detailedStatus": "COMPLETED",
"sender":{
"iban":"DE63500105173256774934",
"accountNumber": null,
"sortCode": null,
"name":"Mrs Jane Doe",
"bank":{
"id":"ea54dc4d-d2e4-481f-8424-a9eb9a2db4ab",
"country":"DE",
"groupName":"Norisbank",
"branchName":"Norisbank Berlin",
"bic8":"HANDSESS"
}
}
}How is this guide?
Last updated on