Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Excerpt

Version: 1.5
Date: 19-02-2018

...

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.

Deze wordt alleen gebruikt als registratienaam, niet als naamgeving die zichtbaar is op de iDEAL QR schermen. Hiervoor wordt het veld QR Beneficiary Name gebruikt (zie verderop bij QR Generate).

Merchant

API URL

API URL's

De URL's van de Merchant waarnaar de QR back-end haar requests stuurt verstuurd.
Dit mag één URL per API zijn (initiate en status) of voor beide API's één URL

Contact

name

Naam van contactpersoon waarmee in geval van operationele problemen contact kan worden opgenomen.

Contact

email

E-mail adres van de contactpersoon

Contact

phone

Telefoon nummer van de contactpersoon

...

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-mmMM-dd hhHH: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)

...