Laatst gewijzigd 9/12/2015

3. Een nieuw bestellingsverzoek indienen

3.1 Verzoek-URL

  • De verzoek-URL in de TEST-omgeving is https://ogone.test.v-psp.com/ncol/test/orderdirect.asp.
  • De verzoek-URL in de PRODUCTIE-omgeving is https://secure.ogone.com/ncol/prod/orderdirect.asp.

Vervang 'test' door 'prod'

Vervang “test” door “prod” in de verzoek-URL wanneer u overstapt op uw productie-account. Als u vergeet de verzoek-URL te wijzigen wanneer u in productie begint te werken met echte bestellingen, worden uw transacties verstuurd naar de testomgeving en niet verwerkt door de acquirers / banken.

3.2 Verzoekparameters

Onderstaande tabel bevat de verzoekparameters voor het versturen van een nieuw bestellingsverzoek:

Formaat: AN = alfanumeriek / N = numeriek, maximaal aantal toegelaten tekens
Veld Omschrijving Formaat Verplicht
PSPID
De naam waaronder u bent geregistreerd in ons systeem.
AN, 30
Ja
ORDERID
Uw unieke bestellingsnummer (referentie van de handelaar).
AN, 40
Ja
USERID
Naam van uw applicatiegebruiker (API-gebruiker). Meer informatie over hoe u een API-gebruiker aanmaakt, vindt u in de User Manager-documentatie.
AN, 20 (min. 2)
Ja
PSWD
Wachtwoord van de API-gebruiker (USERID).
AN
Ja
AMOUNT
Te betalen bedrag, VERMENIGVULDIGD MET 100, aangezien het formaat van het bedrag geen decimaaltekens of andere scheidingstekens mag bevatten.
N, 15 Ja
CURRENCY
Valuta van de bestelling in ISO-lettercode, bijvoorbeeld: EUR, USD, GBP, CHF enz.
AN, 3 Ja
CARDNO
Kaart- / rekeningnummer.
AN, 21
Ja
ED
Vervaldatum.
MM/JJ of MMJJ
Ja
COM
Beschrijving van de bestelling.
AN, 100
Nee
CN
Naam van de klant.
AN, 35
Nee
EMAIL
E-mailadres van de klant.
AN, 50
Nee
SHASIGN
Handtekening (gehashte tekenreeks) om de gegevens te authenticeren (zie SHA-IN-versleuteling).
AN, 128
Ja
CVC
Kaartverificatiecode (Card Verification Code). Afhankelijk van het merk van de kaart is de verificatiecode een code van 3 of 4 cijfers op de voor- of achterkant van de kaart, een uitgiftenummer, een startdatum of een geboortedatum.
N, 5
Ja
ECOM_PAYMENT_
CARD_VERIFICATION
Alternatief voor de kaartverificatiecode: geboortedatum / uitgiftenummer / enz. (afhankelijk van uw land of bank)
N, 5
Nee
OWNERADDRESS
Straatnaam en huisnummer van de klant.
AN, 50
Nee
OWNERZIP
Postcode van de klant.
AN, 10
Nee
OWNERTOWN
Gemeente of stad van de klant.
AN, 40
Nee
OWNERCTY
Land van de klant, bv. BE, NL, FR enz.
AN, 2 Nee
OWNERTELNO
Telefoonnummer van de klant.
AN, 30
Nee
OPERATION

Bepaalt het type gevraagde transactie.

U kunt een standaardbewerking configureren (betaalprocedure) in de sectie 'Default operation code' (Standaard bewerkingscode) van het tabblad 'Global transaction parameters' (Algemene transactieparameters') op de pagina 'Technical Information' (Technische informatie). Wanneer u in het verzoek een bewerkingscode verzendt, overschrijft die de standaardwaarde.

Mogelijke waarden:
  • RES: verzoek om autorisatie
  • SAL: verzoek om directe verkoop
  • RFD: terugbetaling, niet gekoppeld aan een voorafgaande betaling, dus geen onderhoudsbewerking voor een bestaande transactie (u kunt deze bewerking niet gebruiken zonder specifieke toelating van uw acquirer).

Optioneel:

  • PAU: verzoek om pre-autorisatie:
      In overleg met uw acquirer kunt u deze bewerkingscode gebruiken om tijdelijk een bedrag op de kaart van een klant te reserveren. Dat is een courante praktijk in de reis- en verhuurbranche.
      PAU / pre-autorisatie kan momenteel alleen gebruikt worden voor MasterCard-transacties en wordt door een beperkt aantal acquirers ondersteund. U kunt deze bewerkingscode niet instellen als standaard in uw Ingenico ePayments-account.
      Als u PAU gebruikt voor transacties via acquirers of met kaartmerken die pre-autorisatie niet ondersteunen, worden die transacties niet geblokkeerd, maar verwerkt als normale (RES) autorisaties.
A, 3
Ja
WITHROOT
Voegt een root-element toe aan ons XML-antwoord. Mogelijke waarden: ‘Y’ of leeg.
Y of <leeg>
Nee
REMOTE_ADDR
IP-adres van de klant (alleen voor fraudedetectiemodule). Als geen landcontrole moet worden uitgevoerd op het IP-adres, stuurt u 'NONE'.
AN
Nee
RTIMEOUT

Time-out van het verzoek voor de transactie (in seconden, waarde tussen 30 en 90)

Belangrijk: de waarde die u hier instelt, moet kleiner zijn dan de time-outwaarde in uw systeem (!)

N, 2
Nee
ECI

Electronic Commerce Indicator (E-commerce indicator - ECI).

U kunt een standaard ECI-waarde configureren op de accountpagina 'Technical information' (Technische informatie), tabblad 'Global transaction parameters' (Algemene transactieparameters), sectie 'Default ECI value' (Standaard ECI-waarde). Wanneer u in het verzoek een ECI-waarde verzendt, overschrijft die de standaard ECI-waarde.

Mogelijke (numerieke) waarden:
0 - Doorgehaald
1 - Handmatig ingevoerd (MOTO) (kaart niet aanwezig)
2 - Herhaling (van MOTO)
3 - Afbetalingen
4 - Handmatig ingevoerd, kaart aanwezig
7 - E-commerce met SSL-codering
9 - Herhaling (van e-commerce)
N, 2
Nee

De lijst van mogelijk te versturen parameters kan langer zijn voor handelaars die in hun account bepaalde opties of functies geactiveerd hebben. Raadpleeg de documentatie van de desbetreffende optie voor meer informatie over extra parameters die aan de optie gekoppeld zijn.

Volgende verzoekparameters zijn verplicht voor nieuwe bestellingen:

  • PSPID en USERID
  • PSWD
  • ORDERID
  • AMOUNT (x 100)
  • CURRENCY
  • CARDNO
  • ED
  • CVC
  • OPERATION

3.3 Testpagina

Onze testpagina om bestellingsverzoeken te versturen in DirectLink vindt u hier: https://ogone.test.v-psp.com/ncol/test/testodl.asp.

3.4 Specifieke betaalmethoden uitsluiten

Als er betaalmethoden zijn die u een klant niet ter beschikking wilt stellen, kunt u dat doen met behulp van een parameter.
Dit is vooral handig voor submerken, wanneer u een merk (bijvoorbeeld MasterCard) wilt aanvaarden, maar niet één van de submerken ervan (bijvoorbeeld Maestro).

Dit is de parameter:

Veld Gebruik
EXCLPMLIST
Lijst van betaalmethoden en/of creditcardmerken die NIET mogen worden gebruikt.
U moet de waarden van elkaar scheiden met een “;” (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 “Card number incorrect or incompatible” (Kaartnummer onjuist of niet compatibel) teruggestuurd met het veld NCERRORPLUS.

3.5 Bestellingsverzoek met behulp van 3-D Secure

Ons systeem ondersteunt het gebruik van 3-D Secure met DirectLink.

Belangrijk

  • Als u 3-D Secure met DirectLink wenst te gebruiken, dan moet u de optie D3D in uw account geactiveerd hebben.">
  • Sommige acquirers vereisen het gebruik van 3-D Secure. Vraag na bij uw acquirer of dit voor u het geval is.

3.6 Credit-/debitcards splitsen

De functie om VISA en MasterCard te splitsen in een debit- en een creditbetaalmethode stelt u in staat om ze aan uw klanten aan te bieden als twee verschillende betaalmethoden (bv. VISA Debit en VISA Credit). U kunt ook beslissen om van beide gesplitste merken slechts één optie te aanvaarden.

Om de splitsing in credit- en debitcards te gebruiken via DirectLink moet u de parameter CREDITDEBIT opnemen in de velden die u naar de pagina orderdirect.asp stuurt (en dus ook in de SHA-IN-berekening!).

Veld Formaat
CREDITDEBIT "C": creditcard
"D": debitcard

Aanverwante fout: als de koper debitcard kiest als betaalmethode en vervolgens een creditcardnummer invoert, wordt een foutcode teruggestuurd: ‘Wrong brand/Payment method was chosen’ (Verkeerd merk / betaalmethode gekozen).

Als de betaling met succes verwerkt is met de parameter CREDITDEBIT wordt dezelfde parameter ook teruggestuurd in het XML-antwoord en/of kan hij worden opgevraagd met een rechtstreekse opvraging. Terwijl de ingediende waarde echter C of D is, is de teruggestuurde waarde 'CREDIT' of 'DEBIT'.

U vindt die teruggestuurde waarden ook in het transactieoverzicht via 'Beheer transacties' en 'Financiële historiek/Dagtotalen' en in rapporten die u nadien kunt downloaden.

Configuratie in uw account

In uw Ingenico ePayments-account kunt u de functie 'splitsen' ook activeren en configureren per betaalmethode. Ga naar Split credit/debit cards voor meer informatie.

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