Excerpt |
---|
Version: 1.5 |
...
Om gebruik te kunnen maken van iDEAL QR dient een Merchant een iDEAL contract bij een van de bij iDEAL aangesloten Acquiring partijen te hebben. Voor het registreren voor iDEAL QR dient de Merchant met haar Acquirer contact op te nemen en zich te registreren bij de centrale iDEAL QR back-end. Na acceptatie van zijn registratie kan de Merchant iDEAL QR codes laten genereren en connectie maken met de QR back-end om iDEAL betaalverzoeken uit gescande QR codes te initiëren.
De volgende informatie moet worden geregistreerd voorafgaand aan deelname aan het QR protocol.
Data-element | Omschrijving |
---|---|
MerchantID | Aansluitnummer / MerchantID zoals de Merchant bij de Acquirer bekend is. |
legalName | De juridische naam van de Merchant, zoals deze geregistreerd staat bij de Acquirer. |
Merchant API URLAPI URL's | De URL's van de Merchant waarnaar de QR back-end haar requests stuurt verstuurd. |
Contact name | Naam van contactpersoon waarmee in geval van operationele problemen contact kan worden opgenomen. |
Contact | E-mail adres van de contactpersoon |
Contact phone | Telefoon nummer van de contactpersoon |
...
Naam | Omschrijving | Formaat |
---|---|---|
| Dit is het ID dat de Merchant heeft ontvangen bij de onboarding bij de QR back-end. Deze identificeert de Merchant bij de QR backend. | AN..36 |
| Het bedrag dat voor de specifieke QR code vooraf is ingevuld. Er wordt een punt (.) gebruikt als decimaalteken. Amount mag geen 0 zijn (iDEAL betalingen van 0 cent zijn niet mogelijk). | DEC (12,2) |
| In dit veld wordt aangegeven of het bedrag aanpasbaar moet zijn voor de Consument in de app. Waarde false als het bedrag niet aanpasbaar moet zijn, true als deze wel aanpasbaar moet zijn. | true/false |
| In dit veld moet een maximaal bedrag worden gegeven als het bedrag aanpasbaar is. Moet groter zijn dan 0 en groter dan "amount" | DEC (12,2) |
| In dit veld kan een minimaal bedrag worden gegeven als het bedrag aanpasbaar is. Moet groter zijn dan 0 en kleiner dan "amount" | DEC (12,2) |
| De omschrijving van de betaling zoals deze in de app wordt getoond en zoals deze in het iDEAL berichten protocol wordt meegegeven. | AN..max 35 |
| In dit veld wordt aangegeven of de iDEAL QR code slechts eenmaal mag worden gebruikt of dat het een QR code betreft die meerdere malen gebruikt mag worden. | true/false |
| De datum en tijd waarop de QR code vervalt en dus niet meer kan worden gebruikt voor een iDEAL transactie (UTC) | DT |
| De naam van de begunstigde van de iDEAL QR transactie die op de app te zien is. | AN..100 |
| De Merchant sub-id zoals ook gebruikt voor de iDEAL transactie. 0 wanneer geen sub-id aanwezig is. | N..Max 6 |
| De referentie die door de Merchant ook wordt meegegeven in het iDEAL protocol. | ANS..Max 35 |
| In dit veld wordt door Merchant aangegeven wat de grootte van de QR code is in pixels. De waarde kan tussen de 100-2000 px liggen. | N..100-2000 |
...
HMAC Voorbeeld (ter validatie van implementatie):
Message body: {"qr_id":"
1234test
","qr_url": "
https://qrcode.ideal.nl/1234test"}
Secret key: key123
Resulting HMAC signature hash: ae36cd6aeea48c050c3cf80f8bc25170f37fc2346d1ee294a8b815a2cca9c736
...
APPENDIX: Voorbeeldberichten IDEAL QR (Body)
...