Test uw integratie

Test uw integratie

Het testen van uw ECR-integratie stelt u in staat om te bevestigen dat uw Point of Sale (POS) correct communiceert met de Market Pay betaalterminal voordat u naar productie gaat. Een gestructureerde testcampagne detecteert integratiefouten terwijl ze nog goedkoop te verhelpen zijn — in pre-productie, zonder financiële impact.

Dit artikel beschrijft wat u moet testen, hoe u elk scenario kunt activeren en introduceert de POS Integration Test Suite — een zelfstandige testboek die u kunt gebruiken om uw campagne uit te voeren en te volgen.

Voordat u begint

Bevestig dat het volgende aanwezig is:

  • Een pre-productie terminal verbonden met de Market Pay test (Dummy) acquiring host. Er worden geen echte gelden verplaatst — afwijzingen en goedkeuringen worden gesimuleerd.
  • Uw integratiemethode is bepaald: Local API (HTTP of Socket/TCP-IP), Cloud API, of App2App (Android Intent). De toepasselijke tests hangen hiervan af (zie Welke tests gelden voor mijn integratie).
  • De time-out van uw HTTP-client is langer dan 90 seconden voor betalingsoproepen. Verschillende veerkracht-scenario’s vertragen bewust de hostrespons; een kortere time-out zal die tests onterecht laten falen.

Belangrijke teststappen

  1. Valideer de happy flow. Een standaard contactloze verkoop en een standaard chip + PIN verkoop die beide worden afgerond met een goedgekeurd resultaat en een correcte bon.
  2. Onderzoek de randgevallen. Afwijzingen, afbrekingen, annuleringen, gedeeltelijke autorisatie, handtekening vereist, en speciale transacties (terugboeking, terugbetaling, pre-autorisatie, enz.).
  3. Test op veerkracht. Netwerkverlies midden in de transactie, POS-herstart, host-time-out, offline modus, en polling-gedrag.
  4. Verifieer gegevensverwerking. Dat uw POS de door de terminal teruggegeven identificatoren (POITransactionID) opslaat voor terugboekingen, terugbetalingen en statusopvragingen, en dat ServiceID uniek is per transactie.
  5. Volg en documenteer resultaten. Registreer geslaagd/niet geslaagd voor elke test zodat de campagne controleerbaar is vóór livegang.

De POS Integration Test Suite

De POS Integration Test Suite is een zelfstandige testboek die u door een volledige integratiecampagne leidt en u uw resultaten laat vastleggen — geen account en geen server nodig. Alles wordt lokaal in uw browser opgeslagen.

Het vervangt de handmatige, copy-paste aanpak van integratietests door een enkele tool die:

  • Tests filtert op uw scope. Selecteer uw 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 — bijvoorbeeld wordt de categorie Sessie automatisch verwijderd voor Cloud API.
  • Het volledige standaardboek bestrijkt zes categorieën: Sessie, Transactie, Afwijzingsscenario’s, Afbreken & Annuleren, Veerkracht, Speciale Transacties.
  • Elke test geeft een scenario, het exacte triggerbedrag, de verwachte responsvelden en een ontwikkelaarstip — plus per protocol voorbeeldberichten van verzoek/antwoord.
  • Registreert geslaagd / niet geslaagd / niet uitgevoerd per test en laat u een JSON-snapshot exporteren om te delen met uw Market Pay-contact of te archiveren voor certificering.
  • Is aanpasbaar. Voeg tests of hele categorieën toe, bewerk of verwijder ze wanneer uw integratie iets anders nodig heeft dan het standaardboek.

Hoe te gebruiken: open de test suite, voltooi de korte rondleiding, stel uw Scope in, en doorloop elke categorie terwijl u de resultaten markeert. Gebruik Export aan het einde om uw campagnerapport te produceren.

Opmerking

Vraag uw Market Pay integratiecontact om de actuele link naar de POS Integration Test Suite voor uw campagne.

Welke tests gelden voor mijn integratie

Categorie Local API (HTTP / Socket) Cloud API App2App
Sessie (Inloggen / Uitloggen, serienummercontrole, diagnose) Ja Niet van toepassing — authenticatie wordt afgehandeld op API-laag Ja
Transactie Ja Ja Ja
Afwijzingsscenario’s Ja Ja Ja
Afbreken & Annuleren Ja Ja Ja
Veerkracht Ja Ja — polling / authenticatiemechanisme kan verschillen Ja — plus Intent-resolutie
Speciale Transacties Ja — afhankelijk van functie Ja — afhankelijk van functie Ja — afhankelijk van functie

De test suite past deze filtering voor u toe zodra u uw scope instelt.

Met welke kaarten testen

Kaartemulator (aanbevolen)

Het primaire hulpmiddel voor de campagne is de Market Pay kaartemulator samen met de Dummy Server. Scenario’s worden geactiveerd door het transactiebedrag: de Dummy Server retourneert een specifieke Bank Response Code (BRC) op basis van het bedrag dat u verzendt. Dit geeft u deterministische, herhaalbare controle over afwijzingen, fouten, gedeeltelijke goedkeuringen en speciale flows — zonder tientallen fysieke kaarten nodig te hebben.

Bijvoorbeeld (elk bedrag dat niet in de triggerlijst staat, retourneert standaard Goedgekeurd):

Bedrag Getriggerd resultaat
11.00 Niet honoreren — generieke afwijzing (BRC 100)
11.01 Verlopen kaart (BRC 101)
11.16 Onvoldoende saldo (BRC 116)
11.17 Onjuiste PIN (BRC 117)
16.00 – 17.99 Gedeeltelijke autorisatie (geautoriseerd = gevraagd − €1,00)
18.00 – 18.99 Handtekening vereist op bon
19.07 Issuer inactief — 30 seconden responstijd vertraging (BRC 907)

De volledige mapping van bedrag naar BRC (inclusief kaart-specifieke bereiken) wordt per test binnen de test suite verstrekt.

Uw eigen persoonlijke kaarten gebruiken

U kunt ook uw eigen persoonlijke kaarten gebruiken in pre-productie. Omdat de pre-productieomgeving verbonden is met de Dummy acquiring host, is er geen financiële impact — er vindt geen echte autorisatie, incasso of afwikkeling plaats op uw kaart.

Dit is een nuttige aanvulling op de emulator wanneer u het gedrag van echte kaarten wilt valideren: contactloze taps, echte chiplezingen, echte PIN-invoer en de kaarthouderervaring op het terminalscherm.

Waarschuwing

Alleen contact (chip) transacties: afhankelijk van de kaart kan een contact / chip-transactie worden afgewezen. Dit is verwacht en is een eigenschap van de kaart, geen defect in uw integratie. Contactloze taps worden over het algemeen niet beïnvloed. Als u een gegarandeerde goedkeuring of een specifieke afwijzingsreden nodig heeft, gebruik dan de kaartemulator met het overeenkomstige triggerbedrag.

Het resultaat correct lezen

Controleer bij het nakijken van een transactie-uitkomst 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 binnen het responsbericht.
  • Local API HTTP gebruikt een POST → poll patroon. POST retourneert 202 Accepted; u voert daarna GET-poll uit. Een 206 betekent in uitvoering — blijf pollen; een 200 is het definitieve resultaat. Sluit een transactie nooit af op 206.
  • Sla de POITransactionID op die door de terminal wordt teruggegeven. Terugboekingen, terugbetalingen en statusopvragingen verwijzen hiernaar — niet naar uw 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 uw POS deze apart registreren van online goedkeuringen.

Exitcriteria — wanneer bent u klaar?

  • Alle VERPLICHTE tests slagen. Deze zijn blokkerend voor livegang.
  • AANBEVOLEN tests slagen, of eventuele mislukkingen zijn gedocumenteerd en geaccepteerd.
  • VOORWAARDELIJKE tests slagen voor elke optionele functie in uw scope (pre-autorisatie, DCC, fooi, toeslag, S&F, enz.).
  • Uw voltooide campagne (Export uit de test suite) wordt gedeeld met uw Market Pay-contact.

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

 

 

Het testen van uw ECR-integratie stelt u in staat te verifiëren dat uw integratie werkt zoals bedoeld voordat u naar een productieomgeving gaat.

Belangrijke teststappen zijn onder andere:

  1. Valideer de happy flow.
  2. Onderzoek niet-happy flows, inclusief scenario’s zoals time-outs en verbindingsproblemen, terwijl u de transactie-status bevestigt.
  3. Simuleer diverse acquirer-responsen om uw afhandeling van afgewezen transacties te testen.
  4. Voer tests uit met verschillende Kaarthouder Verificatiemethoden (CVM).

U kunt geëmuleerde kaarten voor de testomgeving verkrijgen via:

Opmerking. Voor fysieke kaarten dient u dit te controleren bij uw acquirer of uw Market Pay-contactpersoon.

Om niet-happy flows te testen, is er bij gebruik van de Market Pay testomgeving een regel om een specifieke responscode terug te geven op basis van het ontvangen bedrag wanneer dit voldoet aan het volgende formaat: 9XXX, waarbij

  • 9 statisch is
  • XXX de responscode is die u wilt ontvangen.

Bijvoorbeeld: de verwachte responscode is 116 (Onvoldoende saldo). U moet een transactie uitvoeren met het bedrag 9116.

Bijlagen