iDEAL Advanced - Pronamic
iDEAL Advanced - Pronamic
iDEAL Advanced - Pronamic
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
<strong>iDEAL</strong> <strong>Advanced</strong> – Integratiehandleiding PHP<br />
4 Development<br />
Dit hoofdstuk beschrijft in detail hoe de <strong>iDEAL</strong>-protocollen geïntegreerd kunnen worden in een<br />
webshop. Binnen <strong>iDEAL</strong> wordt gebruik gemaakt van de volgende protocollen:<br />
- Directory-protocol: ophalen van de lijst van bij <strong>iDEAL</strong> aangesloten issuers. Hieruit kiest de<br />
consument (klant van de webshop) diens eigen bank. De <strong>iDEAL</strong> <strong>Advanced</strong> PHP Connector<br />
ondersteunt dit protocol via de functie GetIssuerList.<br />
- Betaalprotocol: starten en uitvoeren van een transactie, waarbij geld wordt overgemaakt van<br />
de door de consument gekozen issuer naar de acquirer van de acceptant. De <strong>iDEAL</strong><br />
<strong>Advanced</strong> PHP Connector ondersteunt dit protocol via de functie RequestTransaction.<br />
- Navraagprotocol: opvragen van de status van een transactie. Zie hiervoor o.a. de paragraaf<br />
over de Haalplicht (4.3.1). De <strong>iDEAL</strong> <strong>Advanced</strong> PHP Connector ondersteunt dit protocol via<br />
de functie RequestTransactionStatus.<br />
- Foutenprotocol: richtlijnen voor het verwerken van foutsituaties (zie hiervoor ook paragraaf<br />
2.5 van de <strong>iDEAL</strong> Referentiegids). De <strong>iDEAL</strong> <strong>Advanced</strong> PHP Connector ondersteunt dit<br />
protocol impliciet: elke foutsituatie wordt afgehandeld via een exception; in het geval van<br />
<strong>iDEAL</strong>-fouten is dat een IDealException. Elke IDealException omvat o.a. alle <strong>iDEAL</strong><br />
ErrorRes informatie, inclusief de consumerMessage.<br />
Nota bene: Indien tussen de webshop en de acquirer een proxy server aanwezig is, dienen<br />
speciale maatregelen genomen te worden. Zie hiervoor paragraaf 4.5.<br />
4.1 Directory-verzoek (GetIssuerList)<br />
Het Directory-verzoek, in de <strong>iDEAL</strong> <strong>Advanced</strong> Connector geïmplementeerd via GetIssuerList,<br />
zorgt ervoor dat de meest recente lijst van aangesloten Issuers (banken van consumenten) wordt<br />
opgehaald. Op basis van deze lijst dient in de webshop de keuzelijst met banken gevuld te<br />
worden. Hieruit kiest de consument vervolgens diens bank.<br />
Input<br />
Een aanroep van GetIssuerList vereist geen parameters.<br />
Resultaat<br />
Een aanroep van GetIssuerList kan twee resultaten opleveren:<br />
• Indien er geen fout optreedt, wordt een DirectoryResponse object teruggegeven dat de<br />
volgende elementen bevat:<br />
o IssuerShortList: De short list met de issuers met het grootste marktaandeel.<br />
o IssuerLongList: De long list met de overige issuers.<br />
Copyright © ING. Versie 2.3, april 2010 Pag 14 van 26