Instellen iDEAL

De eindklant kan in het eindklantenportaal, openstaande facturen zelf betalen met iDEAL. Dit artikel beschrijft wat er voor nodig is om dit te realiseren.

Op dit moment is alleen de betalingsservice iDEAL beschikbaar met Buckaroo als provider.

Inrichting

Voordat er met iDEAL betaalt kan worden dient op de eerste plaats het betreffende kantoor of agent een contract te sluiten met een provider. De sleutels die hieruit voortkomen worden gebruikt voor inrichting van de betalingsservice.

  1. Ga in de meta designer (WinUI) naar object “Payment service” (17000) en open een nieuwe member

  2. Het object bevat de volgende properties:

    1. Actief, staat de betalingsservice aan? Als niet actief dan is het iDEAL-icoontje niet zichtbaar.

    2. Type betalingsservice, met welke service kan de eindklant betalen? Momenteel is alleen iDEAL beschikbaar. Wanneer er andere betalingsservices aangesloten moeten worden, zal dit ontwikkeld moeten worden.

    3. Aanbieder betalingsservice, welke provider biedt deze betalingsservice aan? Er zijn vaak meerdere partijen die een betalingsservice kunnen aanbieden. Momenteel wordt alleen die van Buckaroo ondersteund.

    4. Naam van het icon, naamsverwijzing naar het plaatje van de betalingsservice. Naam moet overeenkomen met die in de servercode.

    5. Naam van de betalingsservice, naam van de betalingsservice zoals die wordt getoond op het web aan de eindklant.

    6. Websitekey, code gekoppeld aan de website (ekp-domein). Zichtbaar op beheersite van de aanbieder.

    7. Digitale handtekening key, code van degene die een contract heeft bij de aanbieder. Zichtbaar op beheersite van de aanbieder.

    8. Is een testtransactie, indicator of het om een testsituatie gaat. Als deze uit staat wil het niet zeggen dat het live is. Vaak moet op de beheersite ook ingesteld zijn dat het geen test is.

    9. Kantoor, het kantoor gekoppeld aan deze betaaldienst. Indien gevuld dan agent leeg.

    10. Agent, de agent gekoppeld aan deze betaaldienst. Indien gevuld dan kantoor leeg.

 

Voorbeeld inrichting:

Functioneel

Als een eindklant inlogt op het portaal en voor zijn kantoor/agent is een betalingsservice ingeregeld dan is dat zichtbaar bij de openstaande facturen:

Er wordt geen onderscheid gemaakt in factuursoorten. Alle soorten komen in aanmerking.

Zodra de gebruiker op het icoon klikt, wordt het iDEAL-proces gestart. Het resultaat van de betaling wordt als volgt getoond:

De tekst “Dit is een testtransactie” is alleen zichtbaar als het veld “Is een testtransactie” aan staat.

Alleen als de betaling succesvol is verlopen, wordt er bij de zojuist betaalde factuur vermeld dat deze is betaald:

Pas wanneer de banktransactie in de Anva-backoffice is verwerkt, en AWI de factuur met een import heeft bijgewerkt, zal de factuur verdwijnen uit de lijst met openstaande facturen.

Testen van de service

Buckaroo heeft een testpagina beschikbaar waar de gebruiker het gewenste resultaat kan selecteren:

 

Voor elke mogelijke optie kan er een return-url opgegeven worden. Voor AWI is dan er één voor alle situaties. Echter als je test dan is de betreffende test-website vaak niet bereikbaar vanaf buiten. Denk maar aan de feature-omgevingen. Om toch van buitenaf op de interne website terecht te komen is er een tool beschikbaar: https://ngrok.com/

Installeer ngrok en start als volgt voor bijvoorbeeld feature14: ngrok.exe http feature14ekp.awi -host-header="feature14ekp.awi"

In de command window:

Vervolgens ga je in de browser naar de aangegeven feature-ekp-omgeving en vervang je de url door degene uit de command-window. In bovenstaand voorbeeld zou dat http://1683444f.ngrok.io zijn.

Nu is de ekp-website wel bereikbaar vanaf buiten en kom je op de juiste pagina terecht nadat er een keuze is gemaakt op de Buckaroo-testpagina.