Excerpt |
---|
Version: 1.5 |
...
Om een iDEAL QR-code te genereren, dient de Merchant de Generate API call uit te voeren. De
Generate API call bestaat uit een JSON bericht dat als body in een HTTP POST request naar de QR back-end URL wordt verstuurd.
Note |
---|
De API URL voor de Generate API calls wordt door de iDEAL QR Back-end van de betreffende Acquirer verschaft. Neem hiervoor contact op met je Acquirer. Zie ook hoofdstuk 2. |
De tabel hieronder toont de velden van het Generate API call en hun formaat.
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 yyyy-MM-dd HH:mm |
| 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)
...