Betalen via het internet is hot en als Ogone Certified Solution Provider leek het ons nuttig om een blogpost te schrijven over het implementeren van Ogone e-Commerce binnen je website.
In enkele stappen zal ik aantonen hoe je snel en gemakkelijk betalingen kunt laten gebeuren via Ogone e-Commerce op je website.

Test account aanvragen

Om een Ogone e-Commerce integratie te kunnen doen moet je over een Ogone e-Commerce account beschikken. Op deze pagina kun je een testaccount aanvragen. Even alle velden invullen waaronder je PSPID en na verificatie van Ogone krijg je een wachtwoord toegestuurd waarmee je dan samen met je PSPID kunt inloggen in de testomgeving van je account. Deze testaccount gebruik je om alle instellingen op punt te zetten, betalingen te testen en indien alles afgewerkt is de test omzetten naar een productieaccount.

Account instellen

Nadat Ogone je gegevens geverifieerd heeft en je het wachtwoord hebt ontvangen kunnen we onze e-Commerce account gaan instellen. Dit doe je op https://secure.ogone.com/ncol/test/admin_ogone.asp. Onmiddelijk na de eerste login wordt er gevraagd om je wachtwoord te wijzigen wat je ook best kan doen wegens veiligheidsredenen.

Op de startpagina van de Ogone test omgeving zie je welke stappen je nog moeten overlopen vooraleer je je testaccount kunt gebruiken.

Uw administratieve gegevens

Hier dien je de administratieve gegevens in te vullen van de klant of jezelf. Deze gegevens kunnen later bij het activeren van de productieaccount nog aangepast worden. Heb je alles ingevuld klik op Bevestigen en naar 'Uw factureringsgegevens' om de factureringsgegevens in te vullen. Aangezien we in de testaccount zitten is dit niet nodig om in te vullen. We slaan deze stap over en klikken op Bevestigen en naar 'Uw abonnement en opties'.

Uw abonnement en opties

Kies hier gewoon een abonnement, bij het activeren van de productieaccount dien je pas een abonnement te kiezen dat je effectief wenst te gebruiken. Deze pagina bevestigen en eveneens deze van 'Uw opties'.

Uw betaalmethoden

Hier kun je de betaalmethoden instellen die je wenst te gebruiken op je website. In de testfase maak ik meestal enkel gebruik van VISA. Bij het activeren van de productie account dienen de gewenste betaalmethodes geactiveerd te worden. Hiervoor dien je een contract aan te gaan met een acquirer.

Uw technische instellingen

Hier kun je alle technische instellingen van je e-Commerce aanpassen van veiligheid tot communicatie met de server. Alle puntjes worden uitgebreid besproken op deze pagina.

Activeer uw account

Indien je alle vorige stappen voltooid heb kunnen we nu onze testaccount activeren. Nog even de algemene voorwaarden accepteren en de uw testaccount is actief.

Betalingsformulier opstellen

Nadat de Ogone account correct opgezet en actief is, kunnen we het betalingsformulier gaan integreren binnen de website. Het betalingsformulier is een standaard HTML-form waarvan de action naar Ogone zal verwijzen. Een standaard betalingsformulier zal er als volgt uitzien:

<form action="https://secure.ogone.com/ncol/XXXX/orderstandard.asp" id="form1" method="post" name="form1">
	<!-- algemene parameters --> 
	<input name="PSPID" type="hidden" value="" /> 
	<input name="orderID" type="hidden" value="" /> 
	<input name="amount" type="hidden" value="" /> 
	<input name="currency" type="hidden" value="" /> 
	<input name="language" type="hidden" value="" /> 
	<input name="CN" type="hidden" value="" /> 
	<input name="EMAIL" type="hidden" value="" /> 
	<input name="ownerZIP" type="hidden" value="" /> 
	<input name="owneraddress" type="hidden" value="" /> 
	<input name="ownercty" type="hidden" value="" /> 
	<input name="ownertown" type="hidden" value="" /> 
	<input name="ownertelno" type="hidden" value="" /> 

	<!-- controle voor de betaling--> 
	<input name="SHASign" type="hidden" value="" /> 

	<!-- layout informatie--> 
	<input name="TITLE" type="hidden" value="" /> 
	<input name="BGCOLOR" type="hidden" value="" /> 
	<input name="TXTCOLOR" type="hidden" value="" /> 
	<input name="TBLBGCOLOR" type="hidden" value="" /> 
	<input name="TBLTXTCOLOR" type="hidden" value="" /> 
	<input name="BUTTONBGCOLOR" type="hidden" value="" /> 
	<input name="BUTTONTXTCOLOR" type="hidden" value="" /> 
	<input name="LOGO" type="hidden" value="" /> 
	<input name="FONTTYPE" type="hidden" value="" /> 


	<!-- feedback na de betaling--> 
	<input name="accepturl" type="hidden" value="" /> 
	<input name="declineurl" type="hidden" value="" /> 
	<input name="exceptionurl" type="hidden" value="" /> 
	<input name="cancelurl" type="hidden" value="" /> 

	<input id="submit2" name="submit2" type="submit" value="" /> 
</form>

In de TEST omgeving is de URL: https://secure.ogone.com/ncol/test/orderstandard.asp In de PRODUCTIE omgeving is de URL: https://secure.ogone.com/ncol/prod/orderstandard.asp BELANGRIJK : Wanneer je de testaccount hebt omgezet naar een productieaccount, mag je zeker de action van het form niet vergeten aan te passen: 'test' aanpassen naar 'prod'.

Hieronder een overzicht van alle velden/parameters:

Kleuren kunnen opgegeven worden met hun hexadecimale notitie (#FFFFFF) of hun naam (white). Een lijst van alle mogelijke parameters kun je vinden op deze pagina.

Templates gebruiken

Standaard ziet de betaalpagina van Ogone er zo uit.

Zowel jij als ik weten dat vaak niet past binnen de stijl van de website. Geen probleem, Ogone laat ons toe om gebruik te maken van een template. Hiervoor dient de parameter 'tp'. Via deze parameter kun je het adres opgeven naar een template zoals bijvoorbeeld deze https://secure.ogone.com/ncol/template_standard.htm. Het enig wat je moet doen is een HTML-pagina opbouwen met de vermelding $$$PAYMENT ZONE$$$. Deze vermelding zal dan aangepast worden naar het betalingsformulier.

Bijvoorbeeld voor de ticketverkoop van Pukkelpop hebben we gebruik gemaakt van een template en kun je betaalpagina meer integreren binnen je eigen website.

Betalingen testen

Wanneer het formulier klaar is, kunnen we beginnen met testen. Tijdens het testen van het betalingsformulier kun je gebruikmaken van een kredietkaart (VISA) met kaartnummer 4111111111111111 (één 4 en vijftien 1) en kaart verificatiecode 123.

Mogelijke fouten tijdens het testen

• unknown order/1/r Deze fout treedt op wanneer het bestelformulier op een andere pagina staat dan vermeld onder Technische informatie - punt 2.2.
• unknown order/1/s Deze fout treedt op wanneer de SHASign meegegeven in de hidden fields niet overeenstemt met de gegenereerde SHAstring van Ogone.
• unknown order/0/s Deze fout treedt op wanneer het SHASign veld in de hidden fields leeg is, maar toch blijkt ingevuld te zijn onder Technische informatie - punt 3.2 en punt 4.4.
• PSPID not found or not active Deze fout treedt op wanneer de waarde ingegeven in het PSPID niet bestaat binnen Ogone of nog niet geactiveerd werd.
• no (for instance: no PSPID) Deze fout treedt op wanneer leeg is.
• too long (for instance: currency too long) Deze fout treedt op wanneer de waarde in te lang is.
• amount too long or not numeric: ... OR Amount not a number Deze fout treedt op wanneer de waarde in amount te lang is of niet juiste karakters bevat zoals bijvoorbeeld , (komma) of . (punt).
• not a valid currency Deze fout treedt op wanneer de opgegeven currency verkeerd is of niet bestaat.
• The currency is not accepted by the merchant Deze fout treedt op wanneer de opgegeven currency niet werd opgegeven als gewenste currency onder Configuratie - Abonnement - Pagina 4 : Munten.
• ERROR, PAYMENT METHOD NOT FOUND FOR: ... Deze fout treedt op wanneer de opgegeven PM (payment method) niet overeenkomt met één van de ingestelde betalingsmogelijkheden (Configuratie - Betaalmiddel).

Betaalmethodes activeren

Alle gekozen betaalmethodes dienen geactiveerd te worden onder Configuratie - Betaalmiddel. Om elke gewenste betaalmethode te activeren, dient er met de betreffende maatschappij een contract ondertekend te worden. Indien men vragen heeft over deze contracten of over het verdere verloop van de activering van de betaalmethodes kan men best contact opnemen met Ogone zelf of op deze pagina https://secure.ogone.com/ncol/prod/ogone_faq.asp?faqmode=2&categid=12

Productie account aanvragen

Wanneer alle betalingsmethodes geactiveerd werden en het testen afgelopen is, kunnen we de testaccount omvormen naar een productieaccount. Deze stap is enkel mogelijk wanneer de testaccount correct werd ingesteld na het overlopen van de vorige stappen. Onder Configuratie - Productie account aanmaken dien je de gewenste PSPID op te geven die je wil gebruiken in de productieomgeving. Wanneer je op Overdracht klikt werd de productie account aangemaakt en moet je inloggen op https://secure.ogone.com/ncol/prod/frame_ogone.asp?Branding=Ogone〈=3 met je PSPID en je testwachtwoord. Wanneer je de eerste keer inlogt binnen de productie omgeving wordt er gevraagd om je wachtwoord te veranderen. Eens je wachtwoord veranderd is en je op einde geklikt hebt, dien je de aansluiting in te vullen voor de productieaccount. Dit laat je best door de klant invullen, tenzij je over de gegevens van de klant beschikt. Om de bedrijfsnaam aan te passen, dien je een support ticket te versturen naar Ogone. Opnieuw moeten dan alle stappen overlopen worden door de klant waar men het type abonnement, taal, munten en factureringsinformatie dient op te geven. Wanneer de aansluiting correct werd ingevuld, dienen de gekozen betalingsmethodes geactiveerd worden. Voor meer informatie hierover dient men best contact op te nemen met Ogone of op deze pagina https://secure.ogone.com/ncol/prod/ogone_faq.asp?faqmode=2&categid=12. Bij de technische informatie dient er enkel onder punt 1.2 de e-mails aangepast te worden naar het e-mailadres van de klant. Als alles correct is ingevuld, moet enkel de productieaccount nog geactiveerd worden. Hiervoor moeten alle stappen die door Ogone zijn opgelegd, overlopen worden. Wanneer de productieaccount actief is, dient enkel nog de action van form aangepast te worden van test naar prod. Na deze laatste aanpassingen kunnen er nu via het betaalformulier online betalingen via Ogone gedaan worden.

Enkele nuttige links/documenten

• documentatie Basis Ogone e-Commerce
• documentatie geavanceerde Ogone e-Commerce (Engelse versie)
• Hoe je technische parameters te configureren
• Paramater cookbook
• Ogone Testaccount aanmaken en configureren
• Ogone backoffice gebruikershandleiding
• Lijst van betalingsstatussen en foutcodes
• Hoe uw betalingen consulteren en beheren

Een Ogone e-Commerce implementatie op je eigen website doen valt zoals je zelf hebt kunnen lezen wel goed mee. Heb je toch problemen, vragen of opmerkingen van, tijdens of over de implementatie kun je steeds terecht bij de snelle en vriendelijke support van Ogone. Meer info hierover op deze pagina.