orderID

Het orderID identificeert het order. U kiest dit zelf.

Bijv. UUID v4 om een uniek orderID aan te maken

string

Ja

descriptionText

De beschrijving van het betalingsverzoek. POM zal deze weergeven in het betalingsscherm.

string

Neen

descriptionUrl

Plaatst een HTML-link achter de beschrijving van het betalingsverzoek om bijv. te verwijzen naar een informatiepagina over het product of de dienst

string

Neen

amount

Het te betalen bedrag voor het order tot op 2 cijfers achter het decimale punt

string

Ja

dueDate

De uiterste betaaldatum

Deze datum hoeft alleen meegegeven te worden voor wie wil afwijken van de standaardwaarde die werd meegegeven bij de aansluiting.

De betaling gebeurt in principe meteen, dus de dueDate zal gewoonlijk de datum van morgen zijn.

string

Neen

communication

Dit veld wordt genegeerd indien u een OraFin-aansluiting heeft.

Indien u geen OraFin-aansluiting heeft, moet in dit veld een vrije mededeling meegegeven worden.

string

Conditioneel

paymentMethod

Als het contract met de Payment Service Provider toestaat om dit veld leeg te laten, kan de betaler elke methode gebruiken die op het contract voorzien is.

U kunt ervoor kiezen deze methodes te beperken door een specifieke methode mee te sturen.

Neem contact op met de PSP om te weten welke methoden op uw contract zijn toegestaan.

String

Neen

expiryDate

De datum waarop het betalingsverzoek vervalt in UTC-formaat. Deze datum moet minstens gelijk zijn aan de dueDate.

Indien dit veld leeggelaten wordt, zal by default de vervaldatum (expirydate) worden overgenomen uit het aansluitingsformulier.

string

Neen

language

De taal van het betalingsverzoek:

• 2 karakters voor de taalcode volgens ISO 639

• gevolgd door '_'

• gevolgd door 2 karakters voor de landcode volgens ISO 3166-2

Bijvoorbeeld: nl_BE

Indien u dit veld leeg laat, wordt er bij default nl_BE gehanteerd.

string

Neen

ipdcCode

De IPDC-code van het product.

Dit veld is altijd verplicht. Als u een OraFin-aansluiting heeft, wordt de IPDC-code gebruikt voor de boekhouding in OraFin.

Gebruik hier de code uit de IPDC-dienstencatalogus.

Bijvoorbeeld: 961

Zie ook https://productencatalogus.vlaanderen.be/

string

Ja

redirectUrl

U kunt een URL doorgeven naar waar er geredirect wordt na het afronden van een online betaling. Zo kan de betaler naar de gewenste context worden gestuurd.

U kunt ook een vaste URL configureren bij de PSP.

string

Neen

customerType

Geeft mee of de betaling voor een particuliere of een professionele aankoop gebeurt.

Dit veld is verplicht als u een OraFin-aansluiting heeft. Mogelijke waarden zijn KSZ (voor een particuliere aankoop) of KBO (voor een professionele aankoop).

String

Indien OraFin-aansluiting: Ja

Indien geen OraFin-aansluiting: Neen

insz

Het rijksregisternummer voor een particuliere aankoop.

Dit veld is verplicht als u een OraFin-aansluiting heeft en het customerType = KSZ.

Bijvoorbeeld: 82200501055

String

Indien OraFin-aansluiting EN customerType = KSZ: Verplicht veld

Anders: geen verplicht veld

kboNumber

Het KBO-nummer voor een professionele aankoop. Dit veld is verplicht als u een OraFin- aansluiting heeft en het customerType = KBO.

Bijvoorbeeld: 7682949223

String

Indien OraFin -aansluiting EN customerType = KBO: Verplicht veld

Anders: geen verplicht veld