Laatst gewijzigd 9/12/2015

6. Rechtstreekse opvraging

Met een verzoek om rechtstreekse opvraging vanuit uw toepassing kunt u de status van een bestelling automatisch opvragen (in plaats van handmatig in de backoffice). U kunt slechts één betaling per keer opvragen, en u ontvangt slechts een beperkt aantal gegevens over de bestelling.

Als u meer informatie over de bestelling nodig hebt, kunt u de transactie opzoeken in de backoffice of een handmatige of automatische bestandsdownload uitvoeren (zie Uw transacties raadplegen en Batch).

6.1 Opvragingsverzoek

6.1.1 Verzoek-URL

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

Vervang 'test' door 'prod'

Vervang “test” door “prod” in de verzoek-URL wanneer u overstapt op uw productie-account.

6.1.2 Verzoekparameters

Onderstaande tabel bevat de verplichte verzoekparameters om een rechtstreekse opvraging uit te voeren:

Veld
Omschrijving
ORDERID

U kunt de PAYID of de ORDERID sturen om de oorspronkelijke bestelling te identificeren. Wij raden u aan de PAYID te gebruiken.

PAYID
PAYIDSUB
U kunt de identificatie van het historiekniveau vermelden als u de PAYID gebruikt om de oorspronkelijke bestelling te identificeren (optioneel).
PSPID
De PSPID van uw account.
PSWD
Het wachtwoord van uw API-gebruiker.
USERID
Uw API-gebruiker.

6.1.3 Testpagina

Rechtstreekse opvragingsverzoeken kunt u hier testen: https://ogone.test.v-psp.com/ncol/test/testdq.asp.

6.2 Antwoord op een opvraging

Onze server stuurt een XML-antwoord op het verzoek:

Voorbeeld van een XML-antwoord op een rechtstreekse opvraging

<?xml version=”1.0”?>
<ncresponse orderID=”99999” PAYID=”1111111” PAYIDSUB=”3” NCSTATUS=”0” NCERROR=”” NCERRORPLUS=”” ACCEPTANCE=”12345” STATUS="9" ECI=”7” amount="125" currency="EUR" PM="CreditCard" BRAND="VISA" CARDNO="XXXXXXXXXXXX1111" IP="212.33.102.55"/>

Onderstaande tabel bevat een lijst van de ncresponse-tagattributen:

Veld
Gebruik
ACCEPTANCE De door de acquirer teruggestuurde aanvaardingscode
amount Bedrag van de bestelling (niet vermenigvuldigd met 100)
BRAND Kaartmerk of gelijkaardige informatie voor andere betaalmethoden
CARDNO Het gemaskeerde creditcardnummer
currency Valuta van de bestelling
ECI Electronic Commerce Indicator (E-commerce indicator - ECI)
IP IP-adres van de klant, door ons systeem gedetecteerd in een 3-lagige integratie, of door de handelaar naar ons verzonden in een 2-lagige integratie
NCERROR Foutcode
NCERRORPLUS Verklaring van de foutcode
NCSTATUS Eerste teken van NCERROR
orderID De referentie van uw bestelling
PAYID Betalingsreferentie in ons systeem
PAYIDSUB De identificatie van het historiekniveau van de onderhoudsbewerking op de PAYID
PM Betaalmethode
STATUS Transactiestatus

De standaard ncresponse-tagattributen zijn dezelfde als voor het XML-antwoord op een nieuwe bestelling, met uitzondering van de extra attributen PAYIDSUB, CARDNO en IP. 

De attributenlijst kan langer zijn voor handelaars die in hun account bepaalde opties (zoals Fraudedetectie) hebben geactiveerd. Raadpleeg de documentatie van de desbetreffende optie voor meer informatie over extra antwoordattributen die aan de optie gekoppeld zijn. 

6.2.1 Transacties verwerkt met e-Commerce (gehoste betaalpagina)

Als de transactie waarvan u de status wilt controleren werd verwerkt met e-Commerce (gehoste betaalpagina), ontvangt u mogelijk ook de volgende extra attributen (op voorwaarde dat u die velden hebt meegestuurd bij de oorspronkelijke e-Commerce-transactie).

Veld
Omschrijving
complus*
Een waarde die u wou laten terugsturen
(paramplus content)*
De parameters en hun waarden die u wou laten terugsturen

*Zie de Variabele feedbackparameters (e-Commerce-documentatie).

Voorbeeld van een XML-antwoord op een rechtstreekse opvraging voor een e-Commerce-transactie

<ncresponse orderID=”99999” PAYID=”1111111” PAYIDSUB=”3” NCSTATUS=”0” NCERROR=”” NCERRORPLUS=”” ACCEPTANCE=”12345” STATUS="9" amount="125" currency="EUR" PM="CreditCard" BRAND="VISA" CARDNO="XXXXXXXXXXXX1111" IP="212.33.102.55" COMPLUS="123456789123456789123456789" SessionID="126548354" ShopperID="73541312"/>

6.3 Mogelijke antwoordstatussen

Het veld STATUS bevat de status van de transactie (zie Mogelijke statussen).

Alleen de volgende status houdt specifiek verband met de opvraging zelf:

Status
NCERROR
NCSTATUS
Omschrijving
88
De opvraging op querydirect.asp is mislukt

6.4 Rechtstreekse opvraging als controle

De responstijd voor een DirectLink-transactieverzoek bedraagt doorgaans enkele seconden; bij sommige acquirers kunnen de responstijden echter langer zijn. 

Als u na 30 seconden van ons systeem geen antwoord hebt ontvangen, kunt u een verzoek sturen naar querydirect.asp om de status van uw recentste transactie naar orderdirect.asp op te vragen. Als u onmiddellijk antwoord krijgt met een niet-finale status voor de transactie, zijn er mogelijk problemen bij de acquirer.

Als u op die directe opvraging na 10 seconden nog geen antwoord hebt gekregen, zijn er mogelijk problemen bij ons. U kunt dit verzoek naar querydirect.asp elke 30 seconden herhalen tot u merkt dat u binnen 10 seconden een antwoord krijgt.

Opmerking
  • Dit controlesysteem kan alleen problemen bij ons detecteren als er ook een controle bij u is om na te gaan of de verzoeken uw servers correct verlaten.
  • Een probleem bij ons wordt niet noodzakelijkerwijs veroorzaakt door een defect, maar kan ook het gevolg zijn van lange responstijden, bijvoorbeeld vanwege databaseproblemen.
  • Gebruik die controles oordeelkundig om onze servers niet te bombarderen met verzoeken, zo niet kunnen wij verplicht zijn uw toegang tot de pagina querydirect.asp te beperken. 

Belangrijk

Om ons systeem te beschermen tegen onnodige overbelasting verbieden wij controles op de werking van het systeem die valse transacties of systematische opvragingen sturen en systematische opvragingen om voor elke transactie feedback te krijgen.

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