Test je integratie

Door je ECR-integratie te testen, kan je bevestigen dat je Point of Sale (POS) correct communiceert met de betaalterminal van Market Pay voordat je naar productie gaat. Een gestructureerde testcampagne brengt integratiefouten aan het licht voordat je naar productie gaat.

Hier vind je onze online tool voor zelftests: pos-test-suite.market-pay.com

Vereiste

Je moet beschikken over een preproductieterminal die verbonden is met de testacquiringhost (Dummy) van Market Pay. Er worden geen echte geldmiddelen verplaatst: weigeringen en goedkeuringen worden gesimuleerd.

De POS-integratietestsuite

De POS-integratietestsuite is een zelfstandig testboek dat je door een volledige integratiecampagne begeleidt en waarmee je je resultaten kan registreren. Je hebt geen account of server nodig. Alles wordt lokaal in je browser opgeslagen. Met deze tool kan je:

  • Tests filteren volgens je scope. Selecteer je protocol (Cloud API, Local API HTTP of TCP/IP, App2App) en schakel optionele functies in of uit (pre-autorisatie, DCC, fooi, toeslag, S&F enz.). Het boek verbergt tests die niet van toepassing zijn — de categorie Sessie wordt bijvoorbeeld automatisch verwijderd voor Cloud API.
  • Het volledige standaardtestboek doorlopen in zes categorieën: Sessie, Transactie, Scenario's voor weigeringen, Afbreken & annuleren, Veerkracht, Speciale transacties.
  • Elke test voorzien van een scenario, het exacte triggerbedrag, de verwachte responsvelden en een tip voor ontwikkelaars — plus voorbeelden van request-/responseberichten per protocol.
  • Per test geslaagd / mislukt / niet uitgevoerd registreren en een JSON-snapshot exporteren om met je Market Pay-contactpersoon te delen of voor certificering te archiveren.
  • Aanpassingen uitvoeren: tests en volledige categorieën toevoegen, bewerken of verwijderen wanneer je integratie iets nodig heeft dat verder gaat dan het standaardtestboek.

Welke kaarten je moet testen

Kaartemulator

Het belangrijkste hulpmiddel voor de campagne is de kaartscheme-emulator in combinatie met de Dummy Server. Scenario's worden getriggerd door het transactiebedrag: de Dummy Server retourneert een specifieke Bank Response Code (BRC) op basis van het bedrag dat je verstuurt. Zo krijg je deterministische, herhaalbare controle over weigeringen, fouten, gedeeltelijke goedkeuringen en speciale flows, zonder verschillende fysieke kaarten nodig te hebben.

Officiële testkaarten

Sommige schemes leveren testkaarten. Deze kaarten kunnen worden gebruikt met onze Dummy-configuratie of in een end-to-end preproductieomgeving als we een MID hebben die we kunnen configureren voor de verwachte acquirer.

Waarschuwing

Alleen contactloze (chip)transacties: afhankelijk van de kaart kan een contact-/chiptransactie worden geweigerd bij gebruik met onze Dummy-server, die de respons emuleert.  Sommige kaarten verwachten echte uitgeversgegevens die we niet naar de kaart kunnen terugsturen wanneer deze in een geëmuleerde omgeving wordt gebruikt.

Responssimulatie

Met onze Dummy-connector kunnen we bepaalde scenario's en responsen emuleren op basis van het ingevoerde bedrag, om je te helpen bij je integratie:

Bedrag Getriggerd resultaat
11.00 Niet honoreren: algemene weigering (BRC 100)
11.01 Verlopen kaart (BRC 101)
11.04 Beperkte kaart (BRC 104)
11.06 Toegestaan aantal PIN-pogingen overschreden (BRC 106)
11.09 Ongeldige handelaar (BRC 109)
11.16 Onvoldoende saldo (BRC 116)
16.20 Gedeeltelijke autorisatie (geautoriseerd = 16.20 − €0.50), indien geconfigureerd
19.07 Kaartuitgever niet operationeel (BRC 907): time-out van de host met een vertraging van 30 seconden
19.09 Systeemstoring (BRC 909): activeert offline indien geconfigureerd

Het resultaat correct lezen

Controleer bij het nakijken van het resultaat van een transactie de respons op veldniveau, niet alleen de HTTP-status:

  • Goedkeuring/weigering staat in het bericht, niet alleen in de HTTP-code. Een HTTP 200 kan nog steeds een geweigerde betaling bevatten. Controleer het resultaatveld in het responsbericht.
  • Local API HTTP gebruikt een POST → poll-patroon. POST retourneert 202 Accepted; vervolgens voer je een GET-poll uit. Een 206 betekent dat de verwerking bezig is — blijf pollen; een 200 is het definitieve resultaat. Sluit een transactie nooit af bij 206.
  • Sla de door de terminal geretourneerde POITransactionID op. Terugboekingen, terugbetalingen en statusaanvragen verwijzen hiernaar — niet naar je eigen verkoopreferentie.
  • Houd ServiceID uniek per transactie binnen een sessie. Hergebruik ervan doorbreekt de bescherming tegen dubbele betalingen.
  • Markeer offline goedkeuringen afzonderlijk. Wanneer het resultaat een offline goedkeuring aangeeft, moet je POS deze onderscheiden van online goedkeuringen.

Voltooiingscriteria: wanneer ben je klaar?

  • Alle VERPLICHTE tests zijn geslaagd. Deze zijn blokkerend voor go-live.
  • De AANBEVOLEN tests zijn geslaagd, of eventuele fouten zijn gedocumenteerd en aanvaard.
  • De VOORWAARDELIJKE tests zijn geslaagd voor elke optionele functie binnen je scope (pre-autorisatie, DCC, fooi, toeslag, S&F enz.).
  • Je voltooide campagne (Exporteren uit de testsuite) is gedeeld met je Market Pay-contactpersoon.

Hulp nodig bij je campagne? Neem contact op met je Market Pay-contactpersoon voor integratie of dien een aanvraag in via Market Pay Assist.

Was dit artikel nuttig?

Aantal gebruikers dat dit nuttig vond: 0 van 0