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 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 | 16844888455871685014852448_251515740-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 |
---|
Account SettingKontoeinstellung |
|
|
|
|
---|
Company Name | Company NameFirmenname | 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 |
---|
Authentication KeysAuthentifizierungsschlüssel |
|
|
|
|
---|
API Key | API Key | bS1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxzJm | bS1xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxzJm |
|
| Beneficiary Information |
---|
Beneficiary InformationInformationen zum Begünstigten |
|
|
|
|
---|
Beneficiary | BeneficiaryBegü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 |
| Account NameCountryCurrency Account Number Sort CodeGermanyDeutschland | EUR | Die IBAN, welche standardmäßig verwendet werden soll | Die BIC, welche standardmäßig verwendet werden soll | DE02 |
| GermanyDeutschland | 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 |
| United KingdomVereinigtes 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 | 16847433789041685444730643_-12067276631438657823 |
---|
updateSelectOptions | false |
---|
worklog | 365|5|8|y w d h m|y w d h m |
---|
isOR | AND |
---|
order | 0 | | 0 |
---|
| Multiexcerpt |
---|
MultiExcerptName | ParameterMapping |
---|
| Multiexcerpt |
---|
MultiExcerptName | ParameterMapping |
---|
| English | German | Description | Beschreibung |
---|
Image Removed
| Image Removed
| Static: Logo is taken from 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: | Configuration To / is from Configuration Display nameDynamic from requestOne-time payment of / Einmalzahlung is taken from API-amount (e.g- Einmalzahlung wird vom API-Betrag übernommen (z.B. amount=123)
| Transaction Ref No / is taken from - wird von der API-RefNr genommen
| Description / Verwendungszweck is taken from - Verwendungszweck stammt aus API-OrderDesc
| Consumerselects From / Von to choose consumer bankand enters IBANthen Accept payment to login into consumer bank and confirm payment- 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 |
---|
|
![](/download/attachments/87523547/image2023-5-19_10-37-9.png?version=1&modificationDate=1684492631385&api=v2)
|
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 |
---|
|
![](/download/attachments/87523547/image2023-5-19_10-41-12.png?version=1&modificationDate=1684492872973&api=v2)
|
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 |
---|
|
![](/download/attachments/87523547/image2023-5-19_10-48-9.png?version=1&modificationDate=1684493289161&api=v2)
|
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 Modified
|
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 Modified
|
A new tab/window will open with new design:
Multiexcerpt |
---|
MultiExcerptName | PaymentConfirmation |
---|
|
Image Modified
|
Settings → Authentication Keys
Please generate an API Key for your configuration and send it to Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | Helpdesk-Name |
---|
PageWithExcerpt | Wording |
---|
|
:
Multiexcerpt |
---|
|
![](/download/attachments/87523547/image2023-5-19_10-51-22.png?version=1&modificationDate=1684493482382&api=v2)
|
We also need your MemberID and other information which is shown in next section.
Settings → Member Information
The information shown here is also needed for setup in Multiexcerpt include |
---|
SpaceWithExcerpt | EN |
---|
MultiExcerptName | HelpdeskPlatform-Name |
---|
PageWithExcerpt | Wording |
---|
|
:
Multiexcerpt |
---|
MultiExcerptName | TokenKeyTokenKey2 |
---|
|
![](/download/attachments/87523547/image2023-5-19_10-55-29.png?version=1&modificationDate=1684493729453&api=v2)
|
Settings → Beneficiary
Your 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 |
---|
|
![](/download/attachments/87523547/image2023-5-19_11-6-58.png?version=1&modificationDate=1684494419074&api=v2)
|
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.