iDEAL Advanced - Pronamic

iDEAL Advanced – Integratiehandleiding PHP
Indien de issuer-lijst bij de acquirer wijzigt, is het raadzaam de lijst in de webshop daarop zo snel
mogelijk aan te passen. Daarom is het aan te raden in de webshop functionaliteit in te bouwen
waarmee de acceptant dit op elk gewenst moment kan doen.
M.b.t. het aantal Directory-verzoeken geldt:
• Maximaal 1 maal per 24 uur;
• Geen Directory-verzoek voorafgaand aan iedere transactie.
Nota bene: Paragraaf 2.2.1 van de Referentiegids geeft een overzicht van mogelijke fouten die
kunnen optreden als de issuer-list binnen de webshop niet meer overeenstemt met de
daadwerkelijke lijst.
4.2 Transactieverzoek (RequestTransaction)
Met het Transactieverzoek, geïmplementeerd via RequestTransaction, initieert u een iDEALtransactie.
Alle hiervoor benodigde gegevens worden enerzijds afgeleid uit de door u aangeboden
parameters, anderzijds impliciet door de connector uit de configuratiegegevens gehaald.
Input
Een aanroep van RequestTransaction vereist minstens 5 parameters:
• IssuerId: het id van de issuer die de consument heeft gekozen uit de selectielijst
• PurchaseId: het aankoopnummer volgens het systeem van de webwinkel
• Amount: het bedrag in hele centen (geen decimalen; 1 euro = 100)
• Description: de omschrijving van het produkt
• EntranceCode: een door de webwinkel bepaalde code waarmee bij terugkeer in de
webwinkel de aankoop geauthenticeerd kan worden (zie paragraaf 4.2.2 voor details).
• (optioneel) ExpirationPeriod: indien anders dan de geconfigureerde waarde.
• (optioneel) MerchantReturnURL: indien anders dan de geconfigureerde waarde.
Nota bene: In de iDEAL-testomgeving wordt het resultaat van transacties bepaald door de
waarde van het aangeboden amount. Gebruik bijvoorbeeld amount=100 om een succesvolle
transactie te simuleren. Zie paragraaf 5.1 voor details.
Nota bene: De appendix "Tekenset bij Interbancaire Uitwisseling" van de Referentiegids bevat
een tabel met toegestane tekens. Overige tekens, zoals diakritische tekens, worden niet
toegestaan. Bij gebruik van een teken buiten de afgesproken tekenset in properties van het
Transaction-object (zoals Description, EntranceCode en PurchaseId) worden de tekens
geconverteerd naar een equivalent dat wel in de tekenset voorkomt.
Copyright © ING. Versie 2.3, april 2010 Pag 16 van 26