Setup with OpenBanking-provider Token.io
As Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Partner-Name |
---|
PageWithExcerpt | Wording |
---|
|
does not have access to your Token.io setup you need to send us the information required for setup in Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Platform-Name |
---|
PageWithExcerpt | Wording |
---|
|
.
You will have access to your Token.io-Dashboard after signing the contract.
Please login into your Token.io dashboard (https://dashboard.token.io/) and send the information to Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Platform-Name |
---|
PageWithExcerpt | Wording |
---|
|
– in clear text, not as a screenshot:
A sample mail to Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Platform-Name |
---|
PageWithExcerpt | Wording |
---|
|
could look like:
Panel |
---|
My Token.io setup Table Filter |
---|
hideControls | false |
---|
inverse | false |
---|
totalrow | ,,,,, |
---|
hidelabels | false |
---|
sparkName | Sparkline |
---|
hidePane | true |
---|
disableSave | false |
---|
separator | Point (.) |
---|
sparkline | false |
---|
labels | Hide Columns |
---|
default | Kategorie&&Kommentar&&Wert |
---|
isFirstTimeEnter | false |
---|
cell-width | 150 |
---|
hideColumns | true |
---|
datepattern | dd M yy |
---|
disabled | false |
---|
enabledInEditor | false |
---|
globalFilter | false |
---|
id | 1685014852448_-228874398 |
---|
updateSelectOptions | false |
---|
worklog | 365|5|8|y w d h m|y w d h m |
---|
isOR | AND |
---|
order | 0 |
---|
| Multiexcerpt |
---|
MultiExcerptName | TokenSetup |
---|
| Category | Kategorie | Value | Wert | Comment | Kommentar |
---|
Account Setting | Kontoeinstellung |
|
|
|
|
---|
Company Name | Firmenname | John Doe Limited | Max Mustermann GmbH |
|
| Member Information | Member Information |
|
|
|
|
---|
Member ID | Member ID | m:YCkxxxxxxxxxxxxxxxxxxxxxxxv:5zKtXEAq | m:YCkxxxxxxxxxxxxxxxxxxxxxxxv:5zKtXEAq |
|
| Alias | Alias | {"type":"DOMAIN","value":"xxxxxxxxxxxxx"} | {"type":"DOMAIN","value":"xxxxxxxxxxxxx"} |
|
| Public Token Key | Public Token Key | iYCC0wJXDO0Q-Bqqyi49mD_z-_IWqfmlP_jwGWWNKds | iYCC0wJXDO0Q-Bqqyi49mD_z-_IWqfmlP_jwGWWNKds | Should always be this value; Pls. let us know if it's a different one. | Es sollte immer dieser Wert sein; wenn nicht, teilen Sie uns diesen bitte mit. | Authentication Keys | Authentifizierungsschlüssel |
|
|
|
|
---|
API Key | API Key | bS1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxzJm | bS1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxzJm |
|
| Beneficiary Information | Informationen zum Begünstigten |
|
|
|
|
---|
Beneficiary | Begünstigter | Account Name | Country | Currency | IBAN / Account Number | BIC / Sort Code |
---|
DE01 | Germany | EUR | Your IBAN used as standard | Your BIC used as standard | DE02 | Germany | EUR | Optional: Another IBAN which could be selected via Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Platform-Kurz |
---|
PageWithExcerpt | Wording |
---|
| -parameter "Account" | BIC for this IBAN | UK01 | United Kingdom | GBP | Optional: Your Account Number for UK / FasterPayments | Your Sort Code for UK / FasterPayments |
| Kontoname | Land | Währung | IBAN / Kontonummer | BIC / Bankleitzahl |
---|
DE01 | Deutschland | EUR | Die IBAN, welche standardmäßig verwendet werden soll | Die BIC, welche standardmäßig verwendet werden soll | DE02 | Deutschland | EUR | Optional: Eine weitere IBAN, welche mit dem Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Platform-Kurz |
---|
PageWithExcerpt | Wording |
---|
| -Parameter "Account" selektiert werden kann
| BIC für diese IBAN | UK01 | Vereinigtes Königreich | GBP | Optional: Ihre Kontonummer für UK / FasterPayments | Ihr Sort Code für UK / FasterPayments |
|
|
|
|
|
|
Customization and Testing with OpenBanking-provider Token.io
How a payment looks like
Multiexcerpt |
---|
MultiExcerptName | samplePayment |
---|
|
Table Filter |
---|
hideControls | false |
---|
inverse | false |
---|
totalrow | ,,, |
---|
hidelabels | false |
---|
sparkName | Sparkline |
---|
hidePane | true |
---|
disableSave | false |
---|
separator | Point (.) |
---|
sparkline | false |
---|
labels | Hide Columns |
---|
default | Beschreibung&&German |
---|
isFirstTimeEnter | false |
---|
cell-width | 150 |
---|
hideColumns | true |
---|
datepattern | dd M yy |
---|
disabled | false |
---|
enabledInEditor | false |
---|
globalFilter | false |
---|
id | 1685444730643_1438657823 |
---|
updateSelectOptions | false |
---|
worklog | 365|5|8|y w d h m|y w d h m |
---|
isOR | AND |
---|
order | 0 |
---|
| Multiexcerpt |
---|
MultiExcerptName | ParameterMapping |
---|
| English | Deutsch | Description | Beschreibung |
---|
Image Added | Image Added | Static: - Logo is taken from Token.io-Dashboard → Configuration → CSS
- To is from Token.io-Dashboard → Configuration → Display name
Dynamic / from API request: - One-time payment of is taken from API-amount (e.g. amount=123)
- Transaction Ref No is taken from API-RefNr
- Description is taken from API-OrderDesc
Consumer: - selects From to choose consumer bank
- and enters IBAN
- then clicks Accept to login into consumer bank and confirm payment
| Statisch: - Das Logo stammt vom Token.io-Dashboard → Konfiguration → CSS
- Empfänger ist von Token.io-Dashboard → Konfiguration → Anzeigename
Dynamisch / von API-Anfrage: - Einmalzahlung wird vom API-Betrag übernommen (z.B. amount=123)
- Ende-zu-Ende Referenz wird von der API-RefNr genommen
- Verwendungszweck stammt aus API-OrderDesc
Verbraucher: - wählt mittels Von die Bank aus
- gibt die IBAN ein
- und klickt dann auf Zustimmen zur Anmeldung bei der Bank und Bestätigung der Zahlung
|
|
|
|
How to customize your payment / Token.io-account
After signing your contract with the Open Bank Operator (Token.io) you will get access to their dashboard.
There you can set up:
- your user details and company information (e.g. Company name, Billing details, ...)
Settings → Configuration
General
Here the "Display Name" can be changed. This is the recipient shown to the consumer ("To" / "Empfänger"):
Multiexcerpt |
---|
MultiExcerptName | TokenGeneral |
---|
|
Image Added |
Webhook
Webhook must be set to technical Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Platform-Name |
---|
PageWithExcerpt | Wording |
---|
|
URL: Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | BaseURL |
---|
PageWithExcerpt | Wording |
---|
|
/OpenBankingComplete.aspx
Multiexcerpt |
---|
MultiExcerptName | TokenWebhook |
---|
|
Image Added |
Web App Bank Selection
It's possible to limit bank selection for your consumers. It's recommended to allow "Enable all banks". The consumer can then select any supported bank.
CSS (styling of Token.io Web App (shown to your customer)
It's possible to upload your own merchant logo and customize CSS styling of Web App (shown to consumer):
Multiexcerpt |
---|
|
Image Added |
After you've uploaded your merchant logo and customized your CSS styles the new WebApp-layout can be tested via Payload Builder:
Multiexcerpt |
---|
MultiExcerptName | PayloadBuilder |
---|
|
Image Added |
After doing CSS modification a test payment can be initiated to check design:
- API Key and MemberID are automatically set by Payload Builder
- (4) Description must be unique for each payment
- (5) Amount must be used with decimal point
- (6) Currency must be EUR
- (7) IBAN is merchant's IBAN, i.e.: any of your benificiary IBAN
- (8) merchant's BIC is optional → leave empty
- (9) for testing use any Url, e.g. https://www.google.com
- (10) click on "Generate"
Then click on Test (1)
Multiexcerpt |
---|
|
Image Added |
A new tab/window will open with new design:
Multiexcerpt |
---|
MultiExcerptName | PaymentConfirmation |
---|
|
Image Added |
Settings → Authentication KeysPlease generate an API Key for your configuration and send it to Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Helpdesk-Name |
---|
PageWithExcerpt | Wording |
---|
|
:
Multiexcerpt |
---|
|
Image Added |
We also need your MemberID and other information which is shown in next section.
Settings → Member InformationThe information shown here is also needed for setup in Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Platform-Name |
---|
PageWithExcerpt | Wording |
---|
|
:
Multiexcerpt |
---|
MultiExcerptName | TokenKey2 |
---|
|
Image Added |
Settings → BeneficiaryYour merchant account may have multiple bank accounts configured. Each bank account can have an account name (assigned by you) and is defined
- either with IBAN/BIC (SEPA based)
- or with Account Number / Sort Code (FasterPayments / UK)
A sample setup may look like this:
Multiexcerpt |
---|
MultiExcerptName | TokenBeneficiary |
---|
|
Image Added |
Testing in Sandbox-mode
As long as your OpenBanking Setup is not setup in Production Mode you can test it in Sandbox Mode.
Therefore please use test data shown here: Test Instant Payment.
Key | Format | CND | Description | Beschreibung |
---|
RefNr | ans..30 | M | Reference is mandatory and must be unique for each payment, allowed characters: A..Za..z. Digits are not allowed! | Die Referenznummer des Zahlungsvorganges. Sie muss eindeutig und einmalig sein und darf nur aus folgenden Zeichen bestehen: A..Za..z. Ziffern sind nicht erlaubt! |
TransactionID | ans..64 | M | Unique transaction id returned by Instanea (transfer-id). | Eindeutige TransaktionsId von Instanea (transfer-id). |
ExtCode | n..3 | O | External Response Code from Open Banking Operator | Table Excerpt Include |
---|
static | true |
---|
name | UserData |
---|
page | UserData |
---|
type | page |
---|
|
Table Excerpt Include |
---|
static | true |
---|
name | MAC |
---|
page | MAC |
---|
type | page |
---|
|
Table Excerpt Include |
---|
static | true |
---|
name | Plain |
---|
page | Plain |
---|
type | page |
---|
|
Table Excerpt Include |
---|
static | true |
---|
name | Custom |
---|
page | Custom |
---|
type | page |
---|
|
Return parameters for URLSuccess, URLFailure and URLNotify with Instant Payment