Laatst gewijzigd 22/05/2014

9. Opties voor betaalmethoden

9.1 Keuze van de betaalmethode aan de kant van de handelaar

9.1.1 Een specifieke betaalmethode weergeven

Een klant die naar onze beveiligde betaalpagina gaat, ziet een lijst met de betaalmethoden die u in uw Ingenico ePayments account hebt geactiveerd.

Als de klant de betaalmethode niet op onze betaalpagina maar op uw website moet selecteren, kunt u ons in de verborgen velden de naam en/of het merk (brand) van de betaalmethode sturen (afhankelijk van de betaalmethode). Alleen deze specifieke betaalmethode wordt dan op onze betaalpagina weergegeven en betaling is alleen met deze betaalmethode mogelijk.

De verborgen velden zijn de volgende:

<input type="hidden" name="PM" value="">
<input type="hidden" name="BRAND" value="">

Veld Omschrijving
PM Betaalmethode of betaalmethodegroep (bv. credit card)
BRAND Merk van de (krediet)kaart (e.g. VISA)

 

Voorbeelden

  • Verborgen velden wanneer uw klant VISA op uw site heeft geselecteerd:

<input type="hidden" name="PM" value="CreditCard ">
<input type="hidden" name="BRAND" value="VISA">

  • Verborgen velden wanneer u wilt dat uw klant alleen met creditcard kan betalen (bijvoorbeeld als u ook werkt met andere betaalmethoden die u niet wilt weergeven):

<input type="hidden" name="PM" value="CreditCard ">
<input type="hidden" name="BRAND" value="">

  • Verborgen velden wanneer uw klant iDEAL op uw site heeft geselecteerd:

<input type="hidden" name="PM" value="iDEAL">
<input type="hidden" name="BRAND" value="">

OF

<input type="hidden" name="PM" value="">
<input type="hidden" name="BRAND" value="iDEAL">

 

9.1.2 Toestaan dat de klant een andere betaalmethode kiest: BACKURL

Als de klant op uw website de betaalmethode kiest, geven wij op onze betaalpagina alleen de gekozen betaalmethode weer.

Als de betaling via deze betaalmethode mislukt en de klant het via een andere betaalmethode wil proberen, krijgt hij op onze beveiligde betaalpagina's geen lijst van uw betaalmethoden te zien omdat de betaalmethode niet op onze beveiligde betaalpagina's maar op uw website is gekozen.

In dit geval kunt u de "BACKURL" gebruiken om de klant om te leiden naar een URL op uw website, waar hij een andere betaalmethode kan kiezen. Wanneer de klant op onze beveiligde betaalpagina op de knop 'Terug' klikt nadat de autorisatie is geweigerd of nadat hij de transactie heeft geannuleerd vanuit de website van een derde of een bank, leiden we hem om naar de URL die u als "BACKURL" hebt ingevoerd.

Opmerking: De in dit deel beschreven "Terug"-knop is deze op onze beveiligde betaalpagina's, NIET de "Terug"-knop van uw browser.

U kunt de gespecificeerde "BACKURL" invoeren op het tabblad "Betaalpagina" van de pagina "Technische instellingen" in uw account. Als u echter niet dezelfde "BACKURL" wilt gebruiken, kunt u ons in de verborgen transactievelden een specifieke "BACKURL" sturen.

De "BACKURL" die in de verborgen velden wordt verzonden, heft de algemene "BACKURL" op die op het tabblad "Betaalpagina" van de pagina "Technische instellingen" in uw account is ingevoerd. U kunt de "BACKURL" verzenden in het volgende verborgen veld:

<input type="hidden" name="BACKURL" value="">

Veld Omschrijving
BACKURL De URL van de webpagina die aan de klant moet worden weergegeven wanneer hij op onze beveiligde betaalpagina op de knop "Terug" klikt.

 

Als de klant zijn betaalmethode kiest op onze beveiligde betaalpagina's en niet op uw website, wordt geen rekening gehouden met de "BACKURL". Wanneer een klant op onze beveiligde betaalpagina op de knop "Terug" klikt, wordt hij omgeleid naar onze pagina voor de keuze van een beveiligde betaalmethode, die een lijst van uw betaalmethoden bevat.

9.2 Een specifieke lijst met betaalmethoden weergeven

Als u wilt dat de klant de betaalmethode in een specifieke lijst met betaalmethoden op onze betaalpagina selecteert, kunt u ons deze lijst met betaalmethoden in de verborgen velden sturen. Vervolgens worden alleen die geselecteerde betaalmethoden op onze betaalpagina weergegeven.

Het verborgen veld is het volgende:

<input type="hidden" name="PMLIST" value="">

Veld Omschrijving
PMLIST Lijst met geselecteerde betaalmethoden en/of merken van creditcards. Gescheiden door ';' (puntkomma).

 

Voorbeeld:

Wanneer u wilt dat uw klant op onze betaalpagina alleen kan kiezen uit VISA en iDEAL (en er dus ook andere betaalmethoden zijn die u niet wilt weergeven), is het verborgen veld als volgt:

<input type="hidden" name="PMLIST" value="VISA;iDEAL">

9.3 Specifieke betaalmethoden uitsluiten

Als u niet wilt dat de kaarthouder een bepaald kaartmerk te zien krijgt, kunt u hiervoor een verborgen veld gebruiken.  Dit is vooral handig voor submerken, wanneer een handelaar een merk (bijvoorbeeld MasterCard) wil aanvaarden maar niet één van de submerken ervan (bijvoorbeeld Maestro).

Het verborgen veld is het volgende:

<input type="hidden" name="EXCLPMLIST" value="">

Veld Omschrijving
EXCLPMLIST Lijst van betaalmethoden en/of creditcardmerken die NIET mogen worden getoond. Gescheiden door ';' (puntkomma).

Als een klant probeert te betalen met een kaart die gelinkt is aan een betaalmethode die en/of een (sub)merk dat u met de parameter EXCLPMLIST hebt uitgesloten, wordt het foutbericht 'Kaartnummer onjuist of niet compatibel' teruggestuurd met het veld NCERRORPLUS. De klant krijgt dan op de betaalpagina een soortgelijk bericht te zien.

9.4 Layout van de betaalmethoden

U kunt de lay-out/lijst van de betaalmethoden op onze betaalpagina bepalen met het volgende verborgen veld:

<input type="hidden" name="PMLISTTYPE" value="">

Veld Mogelijke waarden
PMLISTTYPE De mogelijke waarden zijn 0, 1 en 2:
  • 0: Horizontaal gegroepeerde logo's met de naam van de groep aan de linkerkant (standaardwaarde)
  • 1: Horizontaal gegroepeerde logo's zonder groepsnamen
  • 2: Verticale lijst van logo's met een specifieke betaalmethode of merknaam

9.5 Window voor 3-D Secure

9.5.1 3-D Secure v1.0

Als u met 3-D Secure werkt, kunt u kiezen hoe de identificatiepagina aan de klant wordt weergegeven door ons in de verborgen velden een extra parameter te sturen.

Het verborgen veld is het volgende:

<input type="hidden" name="WIN3DS" value="">

Veld Mogelijke waarden
WIN3DS
  • 'MAINW': om de identificatiepagina in het hoofdvenster weer te geven (standaardwaarde)
  • 'POPUP': om de identificatiepagina weer te geven in een pop-upvenster en aan het eind terug te keren naar het hoofdvenster

Belangrijk

Bij sommige betaalmethoden (zoals Visa, MasterCard en JCB) wordt de 'POPUP'-waarde niet toegestaan en wordt ze door het systeem omgezet in 'MAINW'. Wij raden aan het gedrag van dit veld expliciet te testen voor elke betaalmethode.

9.5.2 3-D Secure v2.1 (Beschikbaar in TEST)

Naast de eerder gevraagde parameter (WIN3DS) wordt het ten zeerste aanbevolen om de volgende parameter op te nemen.  Het bevat de voorgeconfigureerde afmetingen in pixels voor de breedte x hoogte van het venster dat in de browser van de kaarthouder wordt weergegeven.

OPMERKING: als u deze parameter niet verzendt, is de standaardwaarde 05 = Full screen.

Parameter
Mogelijke waarden
Mpi.challengeWindowSize
  • 01 = 250 x 400
  • 02 = 390 x 400
  • 03 = 500 x 600
  • 04 = 600 x 400
  • 05 = Full screen
Om de risicobeoordeling van 3DS v2 doeltreffender te maken, raden we u aan om bijkomende parameters op te sturen zoals in de lijst hier wordt beschreven.

Mits deze parameters een directe impact kunnen hebben op uw conversie, aangezien ze de kaarthouder kunnen helpen authenticeren zonder te worden omgeleid. Zie voor meer informatie de DirectLink 3DS gids.

Alhoewel deze parameters optioneel zijn, wordt voor de belangrijkste kaartsystemen met klem aangeraden dat u de volgende parameters in uw aanvraag opneemt, aangezien dit de kans op een frictieloze flow verhoogt

ECOM_BILLTO_POSTAL_CITY
ECOM_BILLTO_POSTAL_COUNTRYCODE
ECOM_BILLTO_POSTAL_STREET_LINE1
ECOM_BILLTO_POSTAL_STREET_LINE2
ECOM_BILLTO_POSTAL_STREET_LINE3
ECOM_BILLTO_POSTAL_POSTALCODE
REMOTE_ADDR
CN
EMAIL

Met de volgende testkaart kunt u een 3-D Secure-geregistreerde kaart simuleren in onze testomgeving:

Vlotte authenticatie
Merk Kaartnummer Vervaldatum
VISA 4186455175836497 Willekeurige datum in de toekomst
Mastercard
5137009801943438 Willekeurige datum in de toekomst
American Express
375418081197346 Willekeurige datum in de toekomst

Authenticatie met challenge
Merk Kaartnummer Vervaldatum
VISA 4874970686672022 Willekeurige datum in de toekomst
Mastercard
5130257474533310 Willekeurige datum in de toekomst
American Express
379764422997381 Willekeurige datum in de toekomst

Opmerking: u kunt hier meer testkaarten downloaden.

9.6 Split credit/debit cards

De functionaliteit om Visa en MasterCard te splitsen in een debet en een credit betaalmethode, laat u toe om ze u aan te bieden aan uw klanten als twee verschillende betaalmethoden (bijvoorbeeld Visa Debit en Visa Credit), of u kunt beslissen slechts een van beide splitmerken te accepteren.

Om de splitsing van krediet-en debetkaarten via e-Commerce te gebruiken, moet u de parameter CREDITDEBIT toevoegen in de verborgen velden die u naar de betaalpagina stuurt (en dus ook in de SHA-IN berekening). 

Veld Formaat
CREDITDEBIT "C": credit card (kredietkaart)
"D": debit card (debetkaart)

Gerelateerde fout: Wanneer de koper kiest voor de debetkaart methode maar vervolgens een credit card nummer ingeeft, dan wordt een foutcode teruggestuurd: “Verkeerde merk/betaalmethode werd gekozen”.

Als de betaling succesvol is verwerkt met de CREDITDEBIT parameter, zal dezelfde parameter ook worden teruggestuurd in de feedback na de verkoop. De ingediende waarden zijn C of D, de teruggestuurde waarden zijn echter "CREDIT" of "DEBIT".

U vindt deze teruggestuurde waarden ook in het transactieoverzicht via "View transacties" en "Financiële geschiedenis", en in rapporten die u daarna kan downloaden.

Configuratie in uw account

De splitfunctionaliteit kan ook worden geactiveerd en geconfigureerd per betaalmethode, in uw Ingenico ePayments account. Ga naar Split Credit / Debit Cards voor meer informatie.

9.7 Transacties met opgeslagen referenties verwerken

Transacties met bewaarde referenties (BR) gebruiken bestaande kaartgegevens die reeds opgeslagen zijn door merchants om de betaling te verwerken. Alvorens een transactie met bewaarde referenties (BR) uit te voeren, moet de kaarthouder toestemming geven aan de merchant om de kaartgegevens op te slaan. Bewaarde referenties (BR) worden meestal gebruikt voor terugkerende betalingen en geven aan of de betaling uitgevoerd wordt door een kaarthouder of een merchant.

Er zijn twee soorten transacties met bewaarde referenties (BR): transacties uitgevoerd door de kaarthouder (TUK) en transacties uitgevoerd door de merchant (TUM). Transacties uitgevoerd dor de kaarthouder (TUK) moeten altijd voor transacties uitgevoerd door de merchant (TUM) gebeuren.

Een transactie uitgevoerd door de kaarthouder (TUK) is een transactie waarbij de kaarthouder betrokken is en die hij/zij persoonlijk verifieert door middel van een handtekening, het toepassen van 3D-Secure of door zich te identificeren.

Voorbeeld van een transactie uitgevoerd door de kaarthouder (TUK):

Een kaarthouder koopt een online treinkaartje en doet een betaling. Hij/zij doet de betaling met zijn/haar kredietkaart en wordt gevraagd om de betaling te verifiëren en toe te staan. Er wordt op dat moment ook gevraagd of de kaarthouder de gegevens van de kredietkaart voor die betaling wil opslaan. Als de kaarthouder hiermee akkoord gaat, kunnen die gegevens opnieuw gebruikt worden in toekomstige transacties uitgevoerd door de merchant.

Een transactie uitgevoerd door de merchant (TUM) volgt op een transactie uitgevoerd door de kaarthouder (TUK) en op een vooraf overeengekomen doorlopende opdracht voor goederen en diensten die de kaarthouder koopt. De kaarthouder hoeft niet betrokken te zijn bij deze transactie.

Voorbeeld van een transactie uitgevoerd door de merchant (TUM):

Een merchant kan automatisch een transactie uitvoeren zodat de kaarthouder voldoet aan zijn/haar maandelijkse betaling voor een tijdschriftabonnement.

In overeenstemming met de regelgeving van Visa en MasterCard omtrent transacties met bewaarde referenties (TBR), moeten er nieuwe parameters verstuurd worden om de TBR te bepalen. 

Deze zijn van toepassing als u:

  • een alias gebruikt
  • van plan bent om terugkerende transacties uit te voeren (gepland of ongepland) na uw eerste transactie uitgevoerd door de kaarthouder (TUK)

Vereiste handeling

Deze parameters worden standaard gebruikt bij een e-Commerce-transactie:

Parameterwaarden COF_INITIATOR-COF_TRANSACTION-COF_SCHEDULE

Beschrijving

CIT-FIRST-UNSCHED
Van toepassing wanneer er een alias gebruikt of aangemaakt wordt
CIT-FIRST-SCHED

Van toepassing op een eerste geplande betaling/abonnement

De standaardwaarden worden opgegeven als u geen parameters toevoegt. Als u wilt, kunt u dit veranderen en de standaardwaarden vervangen door de nieuwe parameters te versturen. Vergeet niet om ook de SHA-handtekening te herberekenen (klik hier voor meer informatie over de SHA-handtekening)

Veld

 Waarden

Beschrijving

COF_INITIATOR* CIT Een transactie uitgevoerd door een kaarthouder
  MIT Een transactie uitgevoerd door een merchant
COF_SCHEDULE*
SCHED Een geplande transactie
  UNSCHED Een ongeplande transactie
COF_TRANSACTION*
FIRST De eerste van een reeks transacties

SUBSEQ

Opeenvolgende reeks transacties

COF_RECURRING_EXPIRY* Datum JJJJMMDD (bijv. 20190914) Momenteel enkel beschikbaar in de testomgeving.
Einddatum: datum van de laatste geplande betaling van een reeks
COF_RECURRING_FREQUENCY* 
numeriek tussen 2 en 4 karakters (bijv. 31, 031 of 0031) Momenteel enkel beschikbaar in de testomgeving.
Dagen tussen betalingen voor een geplande reeks
* Wij verzoeken u om de parameterwaardes te sturen volgens het formaat dat wordt aangegeven in de tabel. Anders zal de transactie geblokkeerd worden door ons systeem.
Ingenico ePayments, de wereldleider in diensten voor digitale betalingen, zet complexe betaaltransacties om tot vlotte en geïntegreerde betaaloplossingen op alle verkoopkanalen: online, in de winkel en mobiel. Met ons innoverende aanbod aan multichannel-betaaldiensten, van transactieaanvaarding tot transactiebetaling, en van marketing tot klantenbinding, helpen wij de ondernemers om hun betalingen te beheren, te groeperen en te beveiligen, om fraude te voorkomen en om hun verkopen te stimuleren dankzij betere conversieverhoudingen. Ingenico ePayments is een merk van de groep Ingenico, de wereldleider in geïntegreerde betaaloplossingen.

Deze website maakt gebruik van cookies om u de beste gebruikerservaring te kunnen geven. Als u deze cookies niet wilt accepteren, laten wij u toe om de cookie-instellingen te wijzigen. Klik op 'Aanvaarden' om alle cookies van deze website toe te staan. 

Cookie settings

Introductie

Functioneel

Functionele cookies zijn nodig om de website correct te laten werken. Die cookies kunnen niet worden uitgeschakeld.

Geoptimaliseerd

Met optimalisatiecookies kunnen we het gebruik van de website analyseren, zodat we deze kunnen meten en verbeteren.
Dit is het standaard niveau.

Gepersonaliseerd

Personalisatiecookies worden gebruikt voor sociale media en geavanceerde personalisatie. Hiermee kunnen we u informatie laten zien die betrekking heeft op uw bedrijf.


Voorbeelden van ondersteunde functionaliteit

  • Landvoorkeur opslaan
  • Taalvoorkeur opslaan

Voorbeelden van niet-toegestane functionaliteit

  • Persoonlijke informatie over uw bezoek opslaan
  • Anonieme tracering via Google Analytics
  • Tracering voor marketingdoeleinden

Voorbeelden van ondersteunde functionaliteit

  • Landvoorkeur opslaan
  • Taalvoorkeur opslaan
  • Anonieme tracering via Google Analytics

Voorbeelden van niet-toegestane functionaliteit

  • Persoonlijke informatie over uw bezoek opslaan
  • Tracering voor marketingdoeleinden

Voorbeelden van ondersteunde functionaliteit

  • Landvoorkeur opslaan
  • Taalvoorkeur opslaan
  • Anonieme tracering via Google Analytics
  • Inhoud weergeven die aansluit op uw interesses
  • Advertenties weergeven die aansluiten op uw interesses
  • Tracering voor marketingdoeleinden

Voorbeelden van niet-toegestane functionaliteit

  • Persoonlijke gegevens opslaan