Receiving credits | Volt Docs

Available in 🇪🇺 EU🇬🇧 UK

Not yet available in 🇦🇺 AU🇧🇷 BR

Credits to your Volt Account

If you’re using a Volt Account with Connect, you can use that account to receive funds, including shopper payments initiated by Volt as well as other credits. All credits will be available for withdrawal through a settlement batch.

Setup credit notifications

For each credit received into your Volt Account, we will send you a credit notification. Whether you are integrating directly with Volt or through a PSP/TSP, you or your partner will need to provide us with the correct URL where the notifications will be sent.

Setup in Fuzebox

First, log into Fuzebox, select Connect on the sidebar, and navigate to the Configurations tab. If you have permission to view more than one customer within your hierarchy, you will first need to select a customer in the Select Customer menu in the upper left corner.

Note – for permissions, your users will need either or both of the below, depending on whether they need to view or manage this setup. These can be found under your user settings within Fuzebox. Should you need this to be added please reach out to your technical integration contact at Volt or support at support@volt.io

View credit notification preferences
Manage credit notification preferences

Where to setup credit notifications for Connect and Volt Accounts

Once you are on the Configurations tab, click the Configure button next to Credit notifications

Configuration options

Notification URL

This is the URL that Volt will use to send credit notifications for this Account. It must begin with ‘https://’ and be able to accept a standard HTTP POST message containing custom headers and a plain text body.

If you prefer, this can be the same URL you have provided for other Volt notifications, such as payment or payout notifications.

Notification failure email

This is the email address that Volt will use to notify you if there is any issue in sending credit notifications to your notification URL.

Obtain your notification secret

The notification secret is used to create the digital signature for each message. You need to copy it and securely store it on your server to verify the signature in incoming messages.

Send a test notification

With your notification URL and failure email address configured, and the notification secret obtained, it’s time to test your notification setup. To do this, simply click the Send a test notification button. We’ll send you a signed notification and expect a response code from you.

Verify and respond with an HTTP code

After receiving a notification, verify that it came from Volt and save it to your system. Respond with an HTTP 200 code if you successfully verified the signature, or an HTTP 400 code if you could not verify it.

Troubleshooting notifications

After receiving a notification, you should respond with an HTTP 200 code.

If we do not receive a response from you, or if the returned code is anything other than 200, we will attempt to resend the notification 7 times with increasing delay intervals. If the 7th attempt fails, we will cease further retries.

Notification details

A new type of notification

In addition to the payment_received notification that you’ll receive from Connect for shopper payments, you’ll also receive a credit_received notification for the credit to your Volt Account.

By default, it means you’ll receive 2 notifications for each credit received – one of type credit_received and another of type payment_received. We have also included the payment_id for shopper payments in the new credit_received notification.

You can now choose to disable the payment_received notifications, and just process the credit_received ones. If you wish to do this, please let us know at support@volt.io and we’ll make the change for you.

Notification header

The User-Agent for credit notifications will be Volt/2.0
X-Volt-Type, specifies the content to expect (in this case, credit_received)

POST /credit_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: credit_received

Notification body

Note that the virtualAccount section will only be included if you are using our Virtual Accounts service.

{
  "creditId": "f267bfe2-a17c-41b0-895d-e2f28ff12664",
  "paymentId": "c357bfe2-f37c-r4b0-t65d-w3e28ff14444",
  "createdAt": "2024-04-08T08:00:00+00:00",
  "reference": "TEST",
  "sender": {
    "account": {
      "accountIdentifiers": {
        "iban": "XXXXXXXXXXXXXXX",
        "swiftBic": "REVOLT21XXX",
        "branchCode": "XXXXXXX",
        "accountNumber": "11111111"
      },
      "country": "LT"
    },
    "name": "Adam Smith",
    "address": "Street ABC City"
  },
  "amount": 1000,
  "currency": "EUR",
  "beneficiary": {
    "account": {
      "accountIdentifiers": {
        "iban": "XXXXXXXXXXXXXXX",
        "swiftBic": "REVOLT21XXX",
        "branchCode": "XXXXXXX",
        "accountNumber": "11111111"
      },
      "accountId": "uuid",
      "country": "LT"
    },
    "virtualAccount": {
      "accountIdentifiers": {
        "iban": "XXXXXXXXXXXXXXX",
        "swiftBic": "REVOLT21XXX",
        "branchCode": "XXXXXXX",
        "accountNumber": "11111111"
      },
      "virtualAccountId": "uuid",
      "country": "LT"
    },
    "name": null,
    "address": null
  }
}