iDEAL Advanced - Pronamic

iDEAL Advanced – Integratiehandleiding PHP
4.2.2 Redirect naar de webshop
Na de betaling (succesvol of niet) via internetbankieren wordt de consument automatisch terug
geleid naar de webshop van de acceptant, via de URL die als waarde van merchantReturnURL
is geconfigureerd. 6
Validatie
De return-URL bevat automatisch de entranceCode en het transactionId van de transactie.
De entranceCode is initieel door de acceptant meegegeven als parameter van het
Betaalprotocol, en kan nu (in combinatie met het transactie id) gebruikt worden om de consument
te ‘authenticeren’ als degene voor wie de transactie ook is gestart.
Nota bene: Het wordt aangeraden om deze validatie altijd uit te voeren. Houd daarbij rekening
met de vereiste minimale variatie van de entranceCode, zoals bepaald in 3.3.1 van de
Referentiegids.
Vervolgens zal de webshop de status van de transactie opvragen. Gebruik hiervoor de functie
RequestTransactionStatus (zie volgende paragraaf).
4.3 Statusverzoek (RequestTransactionStatus)
Na het uitvoeren van een betaalopdracht, dient de webshop in alle gevallen zelf de status van de
transactie op te vragen via het zogenaamde Navraagprotocol van iDEAL. Dit protocol is in de
iDEAL Advanced connector geïmplementeerd via de functie RequestTransactionStatus.
Input
Een aanroep van RequestTransactionStatus vereist als parameter uitsluitend het
TransactionId van de te controleren transactie.
Resultaat
Een aanroep van RequestTransactionStatus kan in essentie twee resultaten opleveren:
• Indien er geen fout optreedt, wordt een AcquirerStatusResponse object teruggegeven
dat de volgende elementen bevat:
o AcquirerId: het ID van de acquirer.
o TransactionId: het ID van de transactie.
6 Indien voor speciale gevallen een andere URL gewenst is, kan de in configuratie opgegeven URL worden overruled door
de merchantReturnURL property van de Connector (tijdelijk) aan te passen.
Copyright © ING. Versie 2.3, april 2010 Pag 18 van 26