Integratie & Installatiehandleiding
iDEAL Betaalformulier

Met deze handleiding kun je het iDEAL betaalformulier installeren binnen je website.

Het script is zo opgezet dat je in je website een simpel formulier kunt plaatsen. Dat laat je verzenden naar het iDEAL script. Op basis van opgegeven waarden in het formulier, start de betaling.

iDEAL scripts uitpakken

1. Pak het ZIP bestand dat je hebt ontvangen volledig uit.

Scripts configureren

2. Open het bestand /idealcheckout/configuration/database.php, en vul in dit bestand de gegevens van je MySQL database in (Deze kun je opvragen bij je hosting provider).

3a. Heb je al een iDEAL account bij een iDEAL aanbieder, open dan het bestand /idealcheckout/configuration/ideal.php. Vul dit bestand met de PHP code die gegenereerd wordt in de iDEAL configuratie wizard.
Zie: https://www.ideal-checkout.nl/support/configuratie-wizard

Bij sommige iDEAL aanbieders en/of iDEAL varianten moet je ook instellingen configureren in je dashboard.
Zie: https://www.ideal-checkout.nl/payment-providers

3b. Heb je nog geen iDEAL account, dan kun je de scripts eenvoudig testen m.b.v. de iDEAL Simulator. Het configuratiebestand is hiervoor standaard ingesteld.

iDEAL scripts uploaden

4. Upload het mapje "/idealcheckout/" (en alle onderliggende bestanden) in de hoofdmap van je website.

5. Geef de map "/idealcheckout/temp/" (en alle onderliggende bestanden) schrijfrechten.

iDEAL scripts installeren

6. Start het installatie script in je browser (http://www.???.nl/idealcheckout/install.php). Dit PHP script maakt een tabel aan in de database waarin alle transacties kunnen worden opgeslagen en voert enkele controles uit.

7. Controleer de eventuele meldingen, en verwijder daarna het bestand "/idealcheckout/install.php" weer van je website.

iDEAL scripts testen

8. Start het 'test'-script in je browser (http://www.???.nl/idealcheckout/test.php). Via dit script kun je eenvoudig betalingen testen om te zien of de ingestelde configuratie goed werkt. Mocht je problemen ondervinden, raadpleeg dan onze F.A.Q. Als je klaar bent met testen kun je het bestand /idealcheckout/test.php van de FTP omgeving verwijderen.

9. Het script bevat ook een 'admin'-tool om de status van transacties online te kunnen bekijken (dit kun je doorgaans ook via het iDEAL dashboard van je bank). Als je van deze tool gebruik wilt maken moet je eerst een wachtwoord instellen. Open hiervoor het bestand FTP: /idealcheckout/admin.php. Bovenin het bestand zie je deze regels.

    define('USERNAME', 'admin');
    define('PASSWORD', 'wachtwoord');

Vul op de plek waar wachtwoord staat een zelfgekozen wachtwoord in (hoofdletter gevoelig) en start vervolgens het adminscript in je browser (http://www.???.nl/idealcheckout/admin.php).

Het formulier plaatsen op je website

De minimale code voor het formulier zie je hier:

<form action="http://www.???.nl/idealcheckout/checkout.php" method="post">
    <input name="amount" type="text" value="10,00">
    <input type="submit" value="Afrekenen">
</form>

Wanneer de bezoeker op de "Afrekenen"-knop klikt, wordt (in dit voorbeeld) een iDEAL betaling van 10 euro gestart.

Je kunt er voor kiezen om de bezoeker zelf een bedrag te laten invullen, een vast bedrag te gebruiken of een keuzelijst te tonen met de beschikbare bedragen.

Je kunt dit formulier verder uitbreiden met diverse velden; zorg er voor dat de veldnamen correct worden overgenomen in het formulier, en het iDEAL script zal de waarden detecteren en verwerken. Het maakt niet uit of je gebruik wil maken van tekstvakken, keuzelijsten of zelfs verborgen velden.

Beschikbare formulier velden

Deze velden kun je allemaal instellen in het formulier. Alleen het veld "amount" is verplicht, alle overige velden zijn optioneel.

Veldnaam	Toelichting
amount *	Het te betalen/doneren bedrag. Minimaal € 1,50 tot maximaal € 10000,00 Note: In het script is een beveiliging ingebouwd dat men geen bedragen onder de € 1,50 kan afrekenen. Zo wordt gegarandeerd dat de transactiekosten die de bank jou in rekening brengt altijd lager zijn dan het bedrag dat je ontvangt. Voor een mislukte of geannuleerde betaling hoef je nooit transactiekosten te betalen.
reference	Uniek betaalnummer/referentie (max. 16 karakters). Indien niet opgegeven wordt er een automatisch volgnummer gebruikt. Note: Als automatisch volgummer wordt het AUTO_INCREMENT_ID gebruikt uit de tabel met opgeslagen transacties.
description	Betaalomschrijving (max. 32 karakters). Indien niet opgegeven wordt als omschrijving "Betaling [betaalnummer]" gebruikt
url_payment	In dit veld kun je een URL instellen. Wanneer de bezoeker de betaling annuleerd, wordt hij/zij naar deze URL gestuurd. Indien niet opgegeven, wordt er een standaard melding getoond.
url_success	In dit veld kun je een URL instellen. Wanneer de bezoeker de betaling succesvol heeft afgerond, wordt hij/zij naar deze URL gestuurd. Indien niet opgegeven, wordt er een standaard melding getoond.
url_pending	In dit veld kun je een URL instellen. Wanneer de bezoeker de betaling heeft gestart, maar (nog) niet volledig heeft afgerond, wordt hij/zij naar deze URL gestuurd. Indien niet opgegeven, wordt er een standaard melding getoond. Note: Wanneer het systeem de status "pending" terug geeft betekend dit dat de status van de betaling nog niet definitief is. Meestal is de betaling correct doorlopen, maar de betaling kan nog niet worden gegarandeerd. Je moet zelf bepalen hoe je systeem hier mee omgaat.
url_failure	In dit veld kun je een URL instellen. Wanneer de betaling door een technisch mankement is afgebroken, wordt de bezoeker naar deze URL gestuurd. Indien niet opgegeven, wordt er een standaard melding getoond. Note: Deze situatie kan zich bijvoorbeeld voor doen wanneer er een storing/onderhoud is bij de bank of uw iDEAL aanbieder.
params	In dit veld kun je een vrije tekst/parameters opnemen. Het script zelf doet niets met deze gegevens, ze worden alleen bij de transactie opgeslagen in de database in de kolom "transaction_params". Note: Als de parameter "param" NIET bestaat in de $_GET of $_POST, zal het script ALLE niet gereserveerde waarden uit de $_POST array opslaan als een serialized array in de kolom "transaction_params". Hierdoor blijven alle waarden van de extra velden die in het formulier zijn ingevuld ook bewaard bij de transactie.

Geavanceerde velden

Overzicht van speciale velden die optioneel door betaalmethoden gebruikt kunnen worden:

Veldnaam	Toelichting
gateway_code	De code van de gewenste betaalmethode. Momenteel worden deze codes ondersteund: IDEAL, MISTERCASH, DIRECTEBANKING. Default: IDEAL
language_code	De taalcode (NL, DE, EN, etc) die moet worden gebruikt binnen het betaalsysteem. Default: NL Note: De meeste betaalmethoden ondersteunen alleen NL, maar sommige betaalmethoden accepteren o.a. ook DE of EN.
country_code	De landcode (NL, BE, DE, UK, etc) waar de bezoeker vandaan komt. Default: NL
store_code	Je kunt een unieke referentie opgeven zodat je ziet vanaf welk formulier de betaling is gestart.
currency_code	Valuta code van de bestelling (EUR, GBP, USD, etc). Default: EUR Note: Bij de meeste betaalmethoden wordt alleen EUR ondersteund.