Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Note toegevoegd over GENERATE API URL's


Excerpt

Version: 1.5
Date: 19-02-2018

...

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

merchant_token

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

amount

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)

amount_changeable

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

amount_max 
(conditioneel)

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)

amount_min
(optioneel)

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)

description

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

one_off

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

expiration

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
UTC

beneficiary

De naam van de begunstigde van de iDEAL QR transactie die op de app te zien is.

AN..100

merchant_sub_id

De Merchant sub-id zoals ook gebruikt voor de iDEAL transactie. 0 wanneer geen sub-id aanwezig is.

N..Max 6

purchase_id

De referentie die door de Merchant ook wordt meegegeven in het iDEAL protocol.

ANS..Max 35

size

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)

...