Test je integratie

Test je integratie

Het testen van je ECR-integratie stelt je in staat te bevestigen dat je Point of Sale (POS) correct communiceert met de Market Pay betaalterminal voordat je naar productie gaat. Een gestructureerde testcampagne detecteert integratiefouten voordat je naar productie gaat.

Vereiste

Je moet een pre-productie terminal hebben die verbonden is met de Market Pay test (Dummy) acquiring host. Er worden geen echte gelden verplaatst: afwijzingen en goedkeuringen worden gesimuleerd.

De POS Integratie Test Suite

De POS Integratie Test Suite is een zelfstandige testboek die je door een volledige integratiecampagne leidt en je resultaten laat registreren, zonder account en zonder server. Alles wordt lokaal in je browser opgeslagen. Dit hulpmiddel stelt je in staat om:

  • Tests te filteren op jouw scope. Selecteer je protocol (Cloud API, Local API HTTP of TCP/IP, App2App) en schakel optionele functies in of uit (pre-auth, DCC, fooi, toeslag, S&F, enz.). Het boek verbergt tests die niet van toepassing zijn — bijvoorbeeld wordt de categorie Sessie automatisch verwijderd voor Cloud API.
  • Het volledige standaardboek te doorlopen over zes categorieën: Sessie, Transactie, Afwijzingsscenario’s, Afbreken & Annuleren, Veerkracht, Speciale Transacties.
  • Elke test een scenario te geven, het exacte triggerbedrag, de verwachte responsvelden en een ontwikkelaarstip — plus per protocol voorbeeldberichten van verzoek/antwoord.
  • Pass / fail / niet-uitgevoerd per test te registreren en een JSON-snapshot te exporteren om te delen met je Market Pay-contact of te archiveren voor certificering.
  • Aan te passen: tests en hele categorieën toe te voegen, te bewerken of te verwijderen wanneer je integratie iets nodig heeft dat verder gaat dan het standaardboek.

Opmerking

Je kunt de POS Test Suite downloaden op deze pagina.

Met welke kaarten testen

Kaartemulator

Het primaire hulpmiddel voor de campagne is de scheme kaartemulator samen 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. Dit geeft je deterministische, herhaalbare controle over afwijzingen, fouten, gedeeltelijke goedkeuringen en speciale flows, zonder dat je verschillende fysieke kaarten nodig hebt.

Officiële testkaarten

Sommige schema’s bieden testkaarten aan, deze kaarten kunnen worden gebruikt met onze Dummy-opstelling of in een end-to-end preproductieomgeving als we een MID hebben om te configureren tegen de verwachte acquirer.

Waarschuwing

Alleen contact (chip) transacties: afhankelijk van de kaart kan een contact / chip transactie worden afgewezen wanneer deze wordt gebruikt met onze Dummy server die respons emuleert. Sommige kaarten verwachten daadwerkelijke issuer-gegevens die wij niet kunnen teruggeven aan de kaart wanneer deze in een geëmuleerde omgeving wordt gebruikt.

Responssimulatie

Onze Dummy connector stelt ons in staat sommige scenario’s en responsen te emuleren op basis van het ingevoerde bedrag om je te helpen bij de integratie:

BedragGetriggerd resultaat
11.00Niet honoreren: generieke afwijzing (BRC 100)
11.01Verlopen kaart (BRC 101)
11.04Beperkte kaart (BRC 104)
11.06Toegestane PIN-pogingen overschreden (BRC 106)
11.09Ongeldige handelaar (BRC 109)
11.16Onvoldoende saldo (BRC 116)
16.20Gedeeltelijke autorisatie (geautoriseerd = 16.20 − €0,50), indien geconfigureerd
19.07Kaartuitgever niet bereikbaar (BRC 907): Host timeout met 30 seconden vertraging
19.09Systeemstoring (BRC 909): triggert offline als geconfigureerd

Het resultaat correct interpreteren

Bij het controleren van een transactie-uitkomst, verifieer de respons op veldniveau, niet alleen de HTTP-status:

  • Goedkeuring/afwijzing staat in het bericht, niet alleen in de HTTP-code. Een HTTP 200 kan nog steeds een afgewezen betaling bevatten. Controleer het resultaatveld in het responsbericht.
  • Local API HTTP gebruikt een POST → poll patroon. POST retourneert 202 Accepted; je doet daarna een GET-poll. Een 206 betekent in uitvoering — blijf poll’en; een 200 is het definitieve resultaat. Sluit een transactie nooit af op 206.
  • Bewaar de POITransactionID die door de terminal wordt teruggegeven. Terugboekingen, terugbetalingen en statusvragen verwijzen hiernaar — niet naar je eigen verkoopreferentie.
  • Houd ServiceID uniek per transactie binnen een sessie. Hergebruik ervan breekt de bescherming tegen dubbele betalingen.
  • Markeer offline goedkeuringen apart. Wanneer het resultaat een offline goedkeuring aangeeft, moet je POS dit duidelijk registreren apart van online goedkeuringen.

Voltooiingscriteria: wanneer ben je klaar?

  • Alle VERPLICHTE tests slagen. Deze zijn blokkerend voor go-live.
  • AANBEVOLEN tests slagen, of eventuele fouten zijn gedocumenteerd en geaccepteerd.
  • VOORWAARDELIJKE tests slagen voor elke optionele functie in jouw scope (pre-auth, DCC, fooi, toeslag, S&F, enz.).
  • Je voltooide campagne (export uit de test suite) is gedeeld met je Market Pay-contact.

Hulp nodig met je campagne? Neem contact op met je Market Pay integratiecontact of dien een verzoek in via Market Pay Assist.

Bijlagen

Bijlagen