Hoe integreer ik online betalingen via de API in mijn website?
Kennis niveau voor dit artikel: je hebt het maken van een reservering al opgenomen in je website via gebruik van de API. Op dit moment heb je een reserveringsnummer. Daarnaast heb je een ingestelde betaalomgeving en ben je in staat via de klantpagina's betalingen aan te nemen.
Na het maken van een reservering wil je dat de klant ook deze reservering direct kan gaan betalen. Daarvoor dien je de gebruiker door te sturen naar de betaalprovider. Dit artikel beschrijft hoe je dit voorbereid. Het is immers niet zomaar een link, maar bevat (beveiligde) gegevens met betrekking tot de reservering en de betaling.
Volg de handleiding voor het aanmaken van een betaling.
Een response kan er zo uit zien:
Response: {
"PSPID": "teqainformatica",
"ORDERID": "20093094",
"AMOUNT": 37500,
"CURRENCY": "EUR",
"PARAMVAR": "33388_0",
"LANGUAGE": "nl",
"url": "https://secure.ogone.com/ncol/test/orderstandard.asp",
"SHASign": "21E90410DC5E18E405C7C751E08CD96AB9D3CA68E3C3CCDD21309827E759BBD6187413A4A239A9A47C7AE3746F64118F29273208D859AC7C670254EB2D271EC0"
}
Met deze response kan een formulier gebouwd worden.
Laat hiervoor de velden url er uit, dat is de locatie waar het formulier gepost dient te worden.
De overige velden zijn de inhoudelijke velden van het formulier. Deze hoeven uiteraard niet aan de gebruiker getoond te worden, maar zijn wel nodig voor een succesvolle betaling.
<!DOCTYPE html>
<html>
<body>
<h2>Example form online payment</h2>
<form action="https://secure.ogone.com/ncol/test/orderstandard.asp" method="POST">
<label for="fname">PSPID:</label><br>
<input type="text" id="PSPID" name="PSPID" value="teqainformatica"><br>
<label for="fname">ORDERID:</label><br>
<input type="text" id="ORDERID" name="ORDERID" value="20093094"><br>
<label for="fname">AMOUNT:</label><br>
<input type="text" id="AMOUNT" name="AMOUNT" value="37500"><br>
<label for="fname">CURRENCY:</label><br>
<input type="text" id="CURRENCY" name="CURRENCY" value="EUR"><br>
<label for="fname">PARAMVAR:</label><br>
<input type="text" id="PARAMVAR" name="PARAMVAR" value="33388_0"><br>
<label for="fname">LANGUAGE:</label><br>
<input type="text" id="LANGUAGE" name="LANGUAGE" value="nl"><br>
<label for="fname">SHASign:</label><br>
<input type="text" id="SHASign" name="SHASign" value="21E90410DC5E18E405C7C751E08CD96AB9D3CA68E3C3CCDD21309827E759BBD6187413A4A239A9A47C7AE3746F64118F29273208D859AC7C670254EB2D271EC0"><br> <input type="submit" value="Submit">
</form>
<p>If you click the "Submit" button, the form-data will be sent to a page called "https://secure.ogone.com/ncol/test/orderstandard.asp".</p>
</body>
</html>
Uitproberen
Eerst uitproberen kan nu via bijvoorbeeld https://www.w3schools.com/html/tryit.asp?filename=tryhtml_form_submit:
Stap 1
Stap 2, uitvoeren:
Als het resultaat scherm op deze manier wordt getoond, is de koppeling correct gelegd.
Als er nog problemen zijn dan zal dit via een (relevante) fout code door de betaalprovider worden teruggekoppeld.
Dit artikel is niet bedoeld voor standaard betalingen. Die werken "out of the box". Dit artikel is alleen bedoeld voor verdergaande integratie, als de boekingsdialoog al via de API is ontsloten.
