Start new verification process

Request location

  • Sandbox
  • Production
POST https://verify-sandbox.volt.io/verifications
POST https://verify.volt.io/verifications

Request body

The first step to verify a customer’s bank account is to make a request. We’ll ask for the following details:

  • The uniqueReference string, 1-36 characters that identify the shopper on the merchant side (required)
  • A shopper reference string, 1-36 characters (optional)
  • Country code: two letters compliant with ISO-3166-2 standard (optional)
  • Language code: two letters compliant with ISO-639-1 standard (optional)

If you want to have redirect URLs different to the ones set in the application in Fuzebox, use the custom URLs field (success, failure, cancellation).

Authorizations: OAuth
Request has to be authorised with Bearer token received via OAUTH and attached to Headers:

 Bearer eyJ0eXAiOiJKV1QiLCJhbGciO ... F_n1hAeBoplzOfQ

Request body schema: application/json
The following table explains the required details for the verification:

uniqueReference
required

string  1-36 characters (a-z, A-z, 0-9, -)
36 characters-long string that is the unique identifier on the merchant site for the shopper verification request

shopper
optional

object
Merchant shopper data with reference field

language
optional

string
Two-letter language code according to ISO-639-1 (ex: ‘pl’)

country
optional

string
Two-letter country code according to ISO-3166-2 (ex: ‘PL’)

customUrls

object
Custom redirection urls, supported fields:
successRedirectUrl, failureRedirectUrl, cancelRedirectUrl
All are optional and should be valid https urls

Example request payload:

{
   "uniqueReference": "4a1d6e521b1f82438a3abed461b58af91cda",
   "shopper": {
      "reference": "91403cd416a2c2451138a2a4f2d89dcbbc18"
   },
   "country": "GB",
   "language": "en",
   "customUrls": {
      "successRedirectUrl": "https://example.com/success",
      "failureRedirectUrl": "https://example.com/failure",
      "cancelRedirectUrl": "https://example.com/cancel"
   }
}