Tracking payments received

Each time a payment is received and reconciled, we’ll update your payment to RECEIVED status.

Payment received notification

Once the payment status has been updated to RECEIVED, we’ll send a notification to your payment notification endpoint. Please note that the format of this notification is different to a Volt Gateway notification. At this stage, you’re free to take whatever action is required e.g. dispatching goods.

Please note

COMPLETED notifications may, in some cases, arrive after the RECEIVED notifications.

Notification details

  • Volt will send you one notification per payment
  • This notification will be delivered to your payment notification URL
  • The User-Agent will be Volt/2.0 for Connect notifications and will also contain an X-Volt-Type header of payment_received so that you can easily identify the message format to process

Notification 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: payment_received

Notification content

{
  "paymentId":"75809566-3fbe-4f14-bd8d-e6cd49ecedb7",
  "timestamp":"2019-10-28T12:34:56+01:00",
  "currency":"GBP",
  "amount":1234567,
  "status":"RECEIVED",
  "reference":"PayerReference",
  "sender":{
    "location": "GB",
    "accountNumber":"12345678",
    "sortCode":"232290",
    "iban":null,
    "swiftBic":null,
    "name":"Mr John and Mrs Jane Smith"
  }
}

Additional Information

Sender fields will only be available to you if we can ensure compliance with data protection laws.

Notification fields

  • paymentId is Volt’s internal ID for the payment, as returned in your initial payment request
  • timestamp is when the notification was generated
  • currency is the currency of the payment
  • amount is the amount of the payment, shown in minor units of currency (pence, cents) rather than pounds, euros or dollars
  • status is the payment status
  • reference is the reference you specified for the payment
  • sender contains the sender’s bank details as supplied to Volt
    • location is the two-letter ISO code for the sender’s country (if known)
    • accountNumber is the domestic account number
    • sortCode is the UK sort code
    • iban is the international bank account number (for international or SEPA payments)
    • swiftBic is the SWIFT BIC for the sender’s bank
    • name is the sender’s name

The sender key may contain different fields depending on the sender’s location. For example, senders in the UK may contain sortCode and accountNumber, while SEPA payments will contain iban. International payments may also contain a swiftBic field.

Processing payments

If a payment was confirmed by the bank, the payment scheme shows how long it can take to arrive in your virtual IBAN.

Payment Schema Processing days
Faster Payments Scheme 1
SEPA Credit Transfer (within country) 8
SEPA Credit Transfer (within SEPA Zone) 8
SEPA Instant Credit Transfer (within country) 1
SEPA Instant Credit Transfer (within SEPA Zone) 1
SWIFT 8
CHAPS 3
ELIXIR 2
BACS 5
NICS 1
RIX 1

If the payment is not received within the stated timeframe, we’ll change the payment status to NOT_RECEIVED and send the following notification:

{
  "payment":"75809566-3fbe-4f14-bd8d-e6cd49ecedb7",
  "reference":"PayerReference",
  "amount":1234567,
  "status":"NOT_RECEIVED",
  "currency":"GBP",
  "timestamp":"2019-10-28T12:34:56+01:00"
}

Notification fields

  • payment is Volt’s internal ID for the payment, as returned in your initial payment request
  • reference is the reference you specified for the payment
  • amount is the amount of the payment, as always in minor units of currency (pence, cents) rather than pounds, euros or dollars
  • status is the status of the payment
  • currency is the currency of the payment
  • timestamp is when the notification was generated

Sandbox setup

Additional Information

When integrating with us on the sandbox environment you can setup a given Volt Connect account to have a payment made to it result in status NOT_RECEIVED if the amount for this payment is exactly 2050 in minor currency units (eurocents, pennies etc).