Skip to main content

Redirecting to Volt

At this point you should have a payment ID returned from the POST /payments endpoint. You can now send your customer to their bank to actually make the payment. For that, you now need to redirect your customer to Volt.

Create a checkout token#

Using the sample response we got after requesting the payment we must now create a Volt checkout token.

{
"id": "93b85f3c-76eb-4316-b1ae-f3370ddc59bc"
}

To do this, simply take the payment ID we returned and Base64 encode it. Using our sample ID, you should end up with a checkout token that looks like this :-

OTNiODVmM2MtNzZlYi00MzE2LWIxYWUtZjMzNzBkZGM1OWJj

Redirect your customer#

Once you have a checkout token, you should redirect your customer's browser to Volt using the following URL. During development, you should use the sandbox environment - you won't be able to make real payments but can test the end-to-end process.

https://checkout.sandbox.volt.io/{checkout_token}

Example#

https://checkout.sandbox.volt.io/OTNiODVmM2MtNzZlYi00MzE2LWIxYWUtZjMzNzBkZGM1OWJj

where {checkout_token} is the base64 encoded payment ID that you've just created.

Customer experience#

If you've preselected a bank and passed that through in the payment request then we'll show your customer a simple confirmation page before we redirect them to their bank.

If not, we'll show them the full Volt checkout page, where they'll be able to change countries and select the bank they wish to pay with.

Default country#

If you know the country where your customer is located, then you can pass it through in the checkout URL after the checkout token, using the parameter name of countryCode and a value from the supported countries below. We'll then preselect that country and show them banks from their location by default.

If you don't pass the country through, or you pass through an invalid option, we'll make a best guess at locating them from the location their browser reports.

And if we still can't locate them by geocoding, they will need to select their country from the list.

https://checkout.sandbox.volt.io/{language}/{checkout_token}?countryCode={isoCode}

Example, to display banks from Poland by default#

https://checkout.sandbox.volt.io/pl/OTNiODVmM2MtNzZlYi00MzE2LWIxYWUtZjMzNzBkZGM1OWJj?countryCode=PL

Currently supported countries#

Supply the two-letter ISO code for the country as the countryCode option in the redirect URL. If the location is unsupported the customer will need to select their location.

  • AT - Austria
  • BE - Belgium
  • BG - Bulgaria
  • CY - Cyprus
  • CZ - Czechia
  • DE - Germany
  • DK - Denmark
  • EE - Estonia
  • ES - Spain
  • FI - Finland
  • FR - France
  • GB - United Kingdom
  • GR - Greece
  • HR - Croatia
  • HU - Hungary
  • IE - Ireland
  • IS - Iceland
  • IT - Italy
  • LI - Liechtenstein
  • LT - Lithuania
  • LU - Luxembourg
  • LV - Latvia
  • MT - Malta
  • NL - Netherlands
  • NO - Norway
  • PL - Poland
  • PT - Portugal
  • RO - Romania
  • SE - Sweden
  • SI - Slovenia
  • SK - Slovakia

Preferred language#

The default language for our checkout and conformation pages is English. If you'd like them displayed in one of our other supported languages, add the two-letter country code to the path as follows :-

https://checkout.sandbox.volt.io/{language}/{checkout_token}

Example, to display the Volt sandbox pages in Polish#

https://checkout.sandbox.volt.io/pl/OTNiODVmM2MtNzZlYi00MzE2LWIxYWUtZjMzNzBkZGM1OWJj

Currently supported languages#

Supply the two-letter ISO code for the language in the redirect URL path.

  • bg - Bulgarian
  • ce - Czech
  • de - German
  • en - English
  • es - Spanish
  • fr - French
  • hr - Croatian
  • hu - Hungarian
  • it - Italian
  • lt - Lithuanian
  • lv - Latvian
  • nl - Dutch
  • pl - Polish
  • pt - Portuguese
  • ro - Romanian
  • sl - Slovenian
  • sk - Slovak

If there's a language you'd like our checkout to support, please let us know at support@volt.io.