1. API voor POS-ontwikkelaars
  2. Gebruikershandleidingen

Webservices API-gids voor POS-ontwikkelaars

​  Laatst bijgewerkt: 

 

  Neem rechtstreeks contact op met Trust Payments voor goedkeuring voordat je deze inhoud in je integratie gebruikt.

 

Eerste stappen

  

 

  Uw bibliotheek configureren

Je moet eerst je systeem configureren om een veilige verbinding te maken met Trust Payments. Klik op de onderstaande link en volg de instructies om ervoor te zorgen dat je systeem met succes een basisverzoek naar onze gateway kan sturen. Zodra dit is gebeurd, wordt in de onderstaande instructies uitgelegd hoe u verzoeken kunt verzenden om betaalfuncties uit te voeren met uw betaalautomaat.

  Open de configuratie-instructies in een nieuw tabblad

 

Verwerk transactie

 

 

  AUTH Overzicht

Om een kaarttransactie te verwerken, moet je een AUTH verzoek indienen en het geretourneerde antwoord verwerken.

 

  1. autorisatie
    • Je dient een AUTH verzoek in bij het Trust Payments eindpunt met behulp van onze Webservices API.
    • De Status betaling wordt gebruikt om de status van de transactie aan te geven.
    • Wanneer een betaling is geautoriseerd door de wervende bank, wordt Status betaling normaal gesproken ingesteld op "0".
    • Trust Payments geeft een antwoord op AUTH dat een succes- of foutmelding geeft.
  2. In afwachting van betaling
    • Na een succesvolle autorisatie wordt het geld gereserveerd op de bankrekening van de klant tot afwikkeling.
    • Gedurende deze tijd kun je opvragen en updates uitvoeren via onze Webservices API of MyST (ons online transactiebeheer portal).
    • Updates kunnen alleen worden uitgevoerd als Status betaling "0" of "1" is.
  3. Voltooiing
    • afwikkeling gebeurt meestal binnen 24 uur, maar dit kan variëren afhankelijk van de betrokken banken en de betalingsmethode.
    • Zodra het geld is overgemaakt, wordt het overgemaakt naar je bankrekening. Hierdoor wordt Status betaling bijgewerkt naar "100".
    • Je kunt restituties uitvoeren door een verzoek in te dienen via onze Webservices API of MyST (ons online transactiebeheer portal).
    • Voor sommige betalingstypen kan de transactie de status "10" hebben, wat betekent dat afwikkeling bezig is, maar nog niet voltooid.
  4. Fouten afhandelen
    • Als een transactie wordt geannuleerd of als er op enig moment in het proces een storing optreedt, wordt Status betaling ingesteld op "3".
    • Verdere acties kunnen niet worden uitgevoerd en het geld wordt teruggestort op de bankrekening van de klant.
    • Als u kijkt naar de foutcode (errorcode) kunt u de reden van onverwachte storingen achterhalen.

  Verwerking AUTH

AUTH Aanvraag

Om een AUTH verzoek succesvol te verwerken, moet u de onderstaande specificatie volgen:

AUTH Aanvraag
{
  "alias":"webserv3",
  "version":"1.00",
  "request":[{
    "accounttypedescription":"POS",
    "baseamount":"1000",
    "carddataentrymode":"CONTACTLESS",
    "cardholderauthenticationmethod":"ONLINEPIN",
    "currencyiso3a":"GBP",
    "deviceencryptedtrack2data":"C8AC965B70FD1F590EAA44F2D55511A5B29D55A1B98F0C70",
    "deviceencryptedpin":"C9A8FEB60C5B26CD",
    "deviceencryptionkeytype":"AES-256",
    "deviceksn":"1234567822334A0000000001",
    "expirydate":"12/2028",
    "iccdata": "9F02060000000010009F03060000000000009F2608A1B2C3D4E5F6A1B28202A1B29F360200018A02A1B29F3403A1B2C39F2701A18410A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B29F3501A19F6E06A1B2C3D4E5F69F1E10313233343536373831323334353637389F1020A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B29110A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2DF3114A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D49F5B14A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D47166A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B7219A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A19F0901019F3303015ABC9F1A0208269505A1B2C3D4E59F5301A15F2A0208269A032212129C01009F370400010001",
    "orderreference":"My_Order_123",
    "requesttypedescriptions":"AUTH",
    "sitereference":"test_mikepos76455",
    "terminalcardcapturecapability":"2",
    "terminalcardoutputcapability": "3",
    "terminalid":"12345678",
    "terminalinputcapability":["CONTACTLESS","ICC"],
    "terminaloperatingenvironment":"2",
    "terminaloutputcapability":"B",
    "terminalpinentrycapability":"4"
  }]
}

 

Specificatie veld

Verplicht Veld Formaat Lengte Beschrijving
X1-EN.png accounttypedescription Alpha Max 20

Het type rekening dat wordt gebruikt om de transactie te verwerken. Geef "POS" op bij het verwerken van POS-transacties.
X1-EN.png baseamount Numeriek Max 13

Het bedrag van de transactie in basiseenheden, zonder komma's of decimalen, dus £10 wordt weergegeven als 1000.

Als de klant cashback aanvraagt, is dit baseamount het totaal dat van de kaart van de klant wordt afgeschreven, inclusief de waarde die is opgegeven in het veld cashbackbaseamount.
X1-EN.png kaartgegevensinvoermodus Alpha Max 18

De volgende waarden worden ondersteund:

  • CONTACTLOOS - Auto via contactloze M/Chip.
  • ICC - Auto via ICC.
  • ICCUNRELIABLE - Gegevens zijn gechipt gelezen en mogelijk onbetrouwbaar.
  • MAGSTRIPE - Auto via magneetstrip.
  • MAGSTRIPEFAILEDICC - Auto via magstrip - fallback als Auto via ICC mislukt.
  • MAGSTRIPEPARTIAL - Auto via mag stripe maar mag stripe gegevens niet volledig gelezen/overgebracht.

Als u een online PIN-transactie faciliteert, kunt u alleen CONTACTLESS, ICC of ICCUNRELIABLE opgeven.
X1-EN.png kaarthouderauthenticatiemethode Alpha Max 15

De volgende waarden worden ondersteund:

  • ONDERTEKENING - Handtekening. (Kan alleen worden ingediend als de kaartgegevensinvoermodus "CONTACTLESS", "ICC", "ICCUNRELIABLE", "MAGSTRIPE", "MAGSTRIPEFAILEDICC" of "MAGSTRIPEPARTIAL" is)
  • MOBILEDEVICECVM - CVM uitgevoerd door mobiel apparaat. (Kan alleen worden ingediend als carddataentrymode "CONTACTLESS" is)
  • NOCVM - Niet geverifieerd. (Kan alleen worden ingediend als carddataentrymode "CONTACTLESS", "ICC", "ICCUNRELIABLE", "MAGSTRIPE", "MAGSTRIPEFAILEDICC" of "MAGSTRIPEPARTIAL" is)
  • ONLINEPIN - Online PIN. (kan alleen worden ingevoerd als de kaartgegevensinvoermodus "CONTACTLESS", "ICC" of "ICCUNRELIABLE" is)
  • OFFLINEPIN - Offline PIN. (Kan alleen worden ingediend als de kaartgegevensinvoermodus "ICC" of "ICCUNRELIABLE" is)
X1-EN.png currencyiso3a ISO3A 3

De Munt van de transactie.

Klik hier voor een volledige lijst van beschikbare munteenheden.
X1-EN.png requesttypedescriptions Alpha Max 20 U moet "AUTH" invoeren, zoals in het verzoekvoorbeeld.
X1-EN.png sitereference Alfanumeriek
& underscore 		Max 50

Identificeert uw site op het Trust Payments systeem.

Wanneer u het AUTH verzoek test, zorg er dan voor dat u uw test indient sitereference. Dit zorgt ervoor dat transacties naar onze testbank worden verwerkt en er geen geld van eigenaar wisselt. Wanneer u live gaat, moet u uw test omwisselen sitereference voor uw live sitereference.

Klik hier voor test kaartnummers die u kunt gebruiken in AUTH verzoeken tijdens het testen.

Als u uw sitereferentie niet kent, neem dan contact op met ons Support Team.
X1-EN.png terminalcardcapturecapability Numeriek 1

De volgende waarden worden ondersteund:

  • 0 - Onbekend.
  • 1 - Geen mogelijkheid om kaarten vast te leggen.
  • 2 - Kan kaarten vastleggen.
X1-EN.png terminalcardoutputcapability Alfanumeriek 1

De volgende waarden worden ondersteund:

  • 0 - Onbekend.
  • 1 - Geen.
  • 2 - Magnetische strip schrijven.
  • 3 - ICC.
  • S - Andere
X1-EN.png terminalid Numeriek 8

Identificatie van POS-terminal.
X1-EN.png terminalinputcapaciteit Lijst van snaren  

Geef een lijst van de modi voor kaartgegevensinvoer die door deze terminal worden ondersteund:

  • CONTACTLESS - Mogelijkheid om contactloze betalingen te accepteren (zowel mobiel als met kaart).
  • ICC - Mogelijkheid om betalingen met contact Integrated Circuit Card (AKA "Chip en PIN") te accepteren.
  • KEYED - Mogelijkheid om betalingen te accepteren waarbij kaartgegevens handmatig in de terminal worden ingevoerd.
  • MAGSTRIPE - Mogelijkheid om veegbetalingen te accepteren.
X1-EN.png terminalbedieningsomgeving Numeriek 1

De volgende waarden worden ondersteund:

  • 0 - Onbekend.
  • 1 - Geen terminal gebruikt.
  • 2 - Op het terrein van de kaartacceptant, bijgewoond.
  • 3 - Buiten het terrein van de kaartacceptant, bijgewoond.
X1-EN.png uitvoercapaciteit terminal Char 1

De volgende waarden worden ondersteund:

  • U - Onbekend.
  • N - Geen.
  • P - Afdrukken.
  • D - Weergeven.
  • B - Afdrukken en weergave.
X1-EN.png terminalpinentrycapability Alfanumeriek 1

De volgende waarden worden ondersteund:

  • U - Onbekend.
  • N - De terminal kan geen PIN-code invoeren.
  • X - Terminal heeft mogelijkheid tot PIN-invoer, maar PIN-pad werkt momenteel niet.
  • O - Andere.
  • 4 - De terminal kan een pincode van 4 cijfers invoeren.
  • 5 - De terminal kan een pincode van 5 cijfers invoeren.
  • 6 - Terminal kan pincode invoeren, pincode 6+ cijfers.
X2-EN.png kaartvolgnummer Alfanumeriek Max. 3

Het kaartvolgnummer wordt gebruikt om kaarten met hetzelfde PAN te identificeren en te onderscheiden.

Dit wordt ingediend als een 2-cijferige waarde tot "99" (dit kan ook voorafgegaan worden door een 0, bijvoorbeeld "099").

Moet worden ingediend indien beschikbaar.
X2-EN.png apparaatencryptedpan Alfanumeriek N/A

Gecodeerd PAN nummer.

Afhankelijk van de betalingsmethode moet je EEN van de volgende velden invullen:

  • apparaatencryptedpan
  • deviceencryptedtrack2data (aanbevolen)
  • pan
  • track2data
X2-EN.png deviceencryptedpin Alfanumeriek N/A

Gecodeerd PIN-blok.

Vereist bij het faciliteren van online PIN-functionaliteit.
X2-EN.png apparaatencryptedtrack2data Alfanumeriek N/A

Versleutelde track 2-gegevens.

Afhankelijk van de betalingsmethode moet je EEN van de volgende velden invullen:

  • apparaatencryptedpan
  • deviceencryptedtrack2data (aanbevolen)
  • pan
  • track2data
X2-EN.png apparaatencryptiesleuteltype Alfanumeriek, inclusief koppeltekens N/A

Kan zijn: "2DES", "3DES", "AES-128", "AES-192", "AES-256".

We raden aan om altijd de sterkste encryptie te gebruiken (in dit geval AES-256).

Verplicht indien velden deviceencryptedpan of deviceencryptedtrack2data zijn opgegeven.
X2-EN.png apparaateksn Alfanumeriek 20-24

Key Serial Number (KSN) van de transactie. Dit wordt verstrekt door het versleutelingsapparaat door de aaneenschakeling van een unieke identificatiecode met een interne versleutelingsteller.

Verplicht indien velden deviceencryptedpan of deviceencryptedtrack2data zijn opgegeven.
X2-EN.png expirydate Datum MM/JJJJ Max. 7

De op de kaart gedrukte vervaldatum.

Vereist bij het indienen van deviceencryptedpan of pan.
X2-EN.png iccdata EMV tag formaat 4

Ondersteunde waarden:

5F2A, 71, 72, 82, 84, 8A, 91, 95, 9A, 9C, 9F02, 9F03, 9F09, 9F10, 9F1A, 9F1E, 9F26, 9F27, 9F33, 9F34, 9F35, 9F36, 9F37, 9F3B, 9F53, 9F6E, DF31.

Vereist voor ICC, CONTACTLESS, ICCUNRELIABLE.
X2-EN.png pan Numeriek 12-19

Dit is het lange nummer dat op de voorzijde van de kaart van de klant is gedrukt.

Afhankelijk van de betalingsmethode moet je EEN van de volgende velden invullen:

  • apparaatencryptedpan
  • deviceencryptedtrack2data (aanbevolen)
  • pan
  • track2data
X2-EN.png track2data ISO 7813 Max 40

Track 2-gegevens - dit is de informatie op de chip of magneetstrip van de creditcard/debetkaart van de klant. Verzend deze samen met de start/einde sentinel en LRC indien aanwezig.

Afhankelijk van de betalingsmethode moet je EEN van de volgende velden invullen:

  • apparaatencryptedpan
  • deviceencryptedtrack2data (aanbevolen)
  • pan
  • track2data
X3-EN.png billingpostcode Alfanumeriek Max 25 De Postcode facturatie of postcode. Dit moet een geldige postcode zijn voor de billingcountryiso2a ingediend.
X3-EN.png billingpremise Alfanumeriek, inclusief
symbolen 		Max 25 Het huisnummer of de eerste regel van het factuuradres van de klant.
X3-EN.png billingstreet Alfanumeriek, inclusief
symbolen 		Max 127 De straat die is ingevoerd voor het factuuradres van de klant.
X3-EN.png kasbasisbedrag Numeriek Max 13

Het cashbackbedrag aangevraagd door de klant.
X3-EN.png chargedescription Alfanumeriek, inclusief
symbolen 		Max 25

Dit is een beschrijving van de betaling die op het bankafschrift van de klant verschijnt.

 Geldige tekens:

  • Hoofdletters/kleine letters A-Z
  • Cijfers 0-9
  • Ruimtes
  • Interpunctie: + - _ . @ ( )
X3-EN.png merchantemail E-mail Max 255 Het e-mailadres van de handelaar. Maximale lengte van 255 (maximaal 64 tekens voor het "@"-symbool).
X3-EN.png operatorname Alfanumeriek Max 255 De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt. Standaard is dit de gebruikersnaam van de Web Services in het verzoek. Dit kan worden overschreven met een aangepaste waarde door dit veld door te geven in het verzoek (optioneel).
X3-EN.png orderreference

Alfanumeriek, inclusief
symbolen

 Max 25

Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen.

Opmerking: Dit kan op een later tijdstip worden bijgewerkt (alleen als de transactie in behandeling is afwikkeling).

Aanbevolen lengte 25 tekens of minder (exacte lengte afhankelijk van wervende bank).

Niet-naleving van dit voorschrift kan ertoe leiden dat de tekst in de transactie wordt ingekort.
X3-EN.png parenttransactionreference Alfanumeriek
& koppeltekens 		Max 25 Hiermee kunt u de transactionreference van een vorig verzoek. De belangrijkste details worden overgenomen van dit verzoek.
X3-EN.png paymenttypedescription Alpha Max 20

Betalingsmethode (bijv. "VISA" of "MASTERCARD").
X3-EN.png settleduedate Datum JJJJ-MM-DD 10 U kunt dit veld in het verzoek opnemen om de datum te specificeren waarop u uw transactie wilt laten afwikkelen. Dit moet binnen 7 dagen na de datum autorisatie zijn.
X3-EN.png settlestatus Numeriek Max. 3 Een numerieke waarde die wordt gebruikt om de instructie afwikkeling te definiëren. Als u hier geen waarde opgeeft, wordt de settlestatus standaard "0".

Klik voor meer informatie over het proces afwikkeling .
AUTH Reactie

Het volgende is een voorbeeld van een AUTH antwoord dat aangeeft dat het verzoek met succes werd verwerkt.

AUTH Reactie
{
  "requestreference":"W23-fjgvn3d8",
  "version":"1.00",
  "response":[{
    "accounttypedescription": "POS",
    "acquirerresponsecode": "00",
    "acquirerresponsemessage": "Approved or completed Successfully",
    "authcode": "000005",
    "baseamount": "2000",
    "currencyiso3a": "GBP",
    "errorcode": "0",
    "errormessage": "Ok",
    "iccdataresponse": "8A023030",
    "issuer":"Test Issuer",
    "issuercountryiso2a": "GB",
    "livestatus": "0",
    "maskedpan": "411111######1111",
    "merchantcategorycode": "7001",
    "merchantcountryiso2a": "GB",
    "merchantname": "Test Merchant",
    "merchantnumber": "12345",
    "operatorname": "webservices@example.com",
    "orderreference": "MyOrder123",
    "paymenttypedescription": "VISA",
    "requesttypedescription": "AUTH",
    "retrievalreferencenumber": "300316080007",
    "securityresponseaddress": "0",
    "securityresponsepostcode": "0",
    "securityresponsesecuritycode": "0",
    "settleduedate": "2023-01-03",
    "settlestatus": "0",
    "stan": "080007",
    "transactionreference": "8-103-7",
    "transactionstartedtimestamp": "2023-01-03 16:36:53"
  }],
  "secrand":"zO9"
}

 

Specificatie veld

Verplicht Veld Formaat Lengte Beschrijving
X4-EN.png accounttypedescription Alpha Max 20 Het type rekening dat wordt gebruikt om de transactie te verwerken. Verwacht dat "POS" wordt teruggestuurd bij het uitvoeren van POS-transacties.
X4-EN.png baseamount Numeriek Max 13

Het bedrag van de transactie in basiseenheden, zonder komma's of decimalen, dus £10 wordt weergegeven als 1000.

Mastercard kan cashbackverzoeken weigeren. Als dit gebeurt, wordt het cashbackbaseamount-veld geretourneerd met waarde "0" en dit bedrag wordt ook afgetrokken van het totaal baseamount geretourneerd.
X4-EN.png currencyiso3a ISO3A 3

De Munt van de transactie.

Klik hier voor een volledige lijst van beschikbare munteenheden.
X4-EN.png errorcode Numeriek 1-5 De foutcode (errorcode) moet worden gebruikt om te bepalen of het verzoek succesvol was of niet.
  • Als de foutcode "0" is, is de transactie geslaagd.
  • Als de foutcode niet "0" is, was de transactie niet succesvol.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.
X4-EN.png errormessage Alfanumeriek Max 255 Dit geeft een korte uitleg over de oorzaak van de fout.

Voor succesvolle transacties wordt dit geretourneerd als "Ok".

Klik hier voor een volledige lijst van errorcode en berichtwaarden.
X4-EN.png uitgever Alfanumeriek Max 255 De uitgever van de kaart van de klant.
X4-EN.png issuercountryiso2a ISO2A 2

Het land voor de uitgever van de kaart van de klant.
Dit zal in ISO2A formaat zijn.

Klik hier voor een volledige lijst van landcodes.
X4-EN.png livestatus Numeriek 1
  • 0 - Transactie verwerkt met een testrekening.
  • 1 - Transactie verwerkt met een live rekening.
X4-EN.png maskedpan Alfanumeriek inclusief "#" 12-19 Het veld maskedpan veld vertegenwoordigt het kaartnummer van de klant. De waarde van maskedpan veld wordt gemaskeerd in het antwoord. Het grootste deel van het nummer wordt opzettelijk verborgen door "#" tekens, bijv. 411111######0211.
X4-EN.png merchantnumber Alfanumeriek Max 32 Het handelaarsnummer dat werd gebruikt om de transactie te verwerken. Verstrekt door de wervende bank.
X4-EN.png operatorname Alfanumeriek Max 255 De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt.
X4-EN.png paymenttypedescription Alpha Max 20 Betalingsmethode (bijv. "VISA" of "MASTERCARD").
X4-EN.png requesttypedescription Alpha Max 20 "AUTH" wordt in het antwoord teruggezonden.
X4-EN.png securityresponseaddress Numeriek 1 Het resultaat van AVS en beveiligingscodecontroles.

Klik hier voor meer informatie.
X4-EN.png securityresponsepostcode Numeriek 1 Het resultaat van AVS en beveiligingscodecontroles.

Klik hier voor meer informatie.
X4-EN.png securityresponsesecuritycode Numeriek 1 Het resultaat van AVS en beveiligingscodecontroles.

Klik hier voor meer informatie.
X4-EN.png settleduedate Datum JJJJ-MM-DD 10 De datum waarop de transactie zal worden afgewikkeld.
X4-EN.png settlestatus Numeriek Max. 3

Een numerieke waarde die wordt gebruikt om de voortgang van afwikkeling met betrekking tot deze transactie aan te geven.

Klik hier voor een volledige lijst van settlestatus waarden.
X4-EN.png transactionreference Alfanumeriek, inclusief
koppeltekens 		Max 25 Een unieke referentie voor de transactie toegewezen door Trust Payments. U hebt deze referentie nodig om een terugbetaling uit te voeren of de transactie bij te werken.
X4-EN.png transactionstartedtimestamp Datum tijd JJJJ-MM-DD hh:mm:ss 19 Het tijdstip waarop de transactie werd verwerkt.
X2-EN.png acquirerresponsecode Alfanumeriek Max 255

Gebruikt door uw verwerver om het resultaat van het verzoek aan te geven.

Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie.
X2-EN.png acquirerresponsemessage Alfanumeriek Max 255

Gebruikt door uw verwerver om het resultaat van het verzoek aan te geven.

Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie.
X2-EN.png authcode Alfanumeriek Max 255

De autorisatie code verstrekt door de uitgevende bank. Deze zal verschillen afhankelijk van de bank die u gebruikt.

Wordt alleen geretourneerd als de transactie is toegestaan.
X2-EN.png kasbasisbedrag Numeriek Max 13

Het cashbackbedrag aangevraagd door de klant.

Mastercard kan cashbackverzoeken weigeren. Als dit gebeurt, wordt cashbackbaseamount teruggestuurd met waarde "0".

Dit veld wordt teruggegeven indien het beschikbaar is.
X2-EN.png chargedescription Alfanumeriek, inclusief symbolen Max 25

Dit is een beschrijving van de betaling die op het bankafschrift van de klant verschijnt.

 Geldige tekens:

  • Hoofdletters/kleine letters A-Z
  • Cijfers 0-9
  • Ruimtes
  • Interpunctie: + - _ . @ ( )

Dit veld wordt teruggestuurd als het naar de wervende bank wordt gestuurd.
X2-EN.png errordata Alfanumeriek Max 255

Aanvullende informatie om te helpen bij het oplossen van de fout.

Wordt alleen geretourneerd als er een fout is opgetreden.
X2-EN.png iccdatarespons EMV tag formaat Max. 4

ICC-gegevensantwoord teruggestuurd van de kaartuitgever van de klant.

Alleen teruggestuurd voor ICC, CONTACTLOOS, ICCUNRELIABLE.
X2-EN.png merchantcategorycode Alfanumeriek Max 255

Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantcity Alfanumeriek Max 127

Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantcountryiso2a ISO2A 2

Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantname Alfanumeriek Max 255

Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantstatecode Alfanumeriek Max 127

Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantzipcode Alfanumeriek Max 10

Dit zijn gegevens die gekoppeld zijn aan de rekening die gebruikt wordt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact opnemen met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png orderreference Alfanumeriek, inclusief
symbolen 		Max 255

Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen.

Opmerking: Dit kan op een later tijdstip worden bijgewerkt (alleen als de transactie in behandeling is afwikkeling).

Dit veld wordt teruggestuurd indien het in het verzoek is ingediend.
X2-EN.png retrievalreferencenumber Alfanumeriek Max 255

Een ISO-term. Deze wordt gebruikt om te verwijzen naar de brontransactie.

Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie.
X2-EN.png stan ISO 8583 Ongedefinieerd

Het STAN (System Trace Audit Number) dat bij de transactie hoort. Dit volgt de ISO 8583-norm.

Dit veld wordt teruggegeven indien het beschikbaar is.
X2-EN.png tid Alfanumeriek Max 255

De terminal ID die gebruikt wordt om de transactie te verwerken. Dit wordt gekoppeld aan uw handelaarsnummer wanneer wij uw rekening in onze systemen instellen.

Of dit veld wordt geretourneerd, hangt af van uw acquiring bank. Neem contact op met ons Support Team als u hulp nodig heeft.

 

Terugbetalingstransactie

 

 

  REFUND Overzicht

Om een verwerkte transactie terug te betalen, moet je een REFUND verzoek indienen en het teruggestuurde antwoord verwerken.

 

  1. Handelaar/partner dient REFUND aanvraag in.
  2. Trust Payments valideert het verzoek en neemt contact op met de bank.
  3. Trust Payments verwerkt de terugbetaling met de betrokken verwerver.
  4. Trust Payments ontvangt de resultaten van de aanvraag en geeft deze door aan de handelaar/partner.
  5. Merchant/partner ontvangt en interpreteert dit antwoord.

  Verwerking REFUND

REFUND Aanvraag
REFUND met ouder REFUND met online PIN 
{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "parenttransactionreference":"1-2-345678",
    "requesttypedescriptions":"REFUND",
    "sitereference":"test_site12345"
  }]
}

 

Specificatie veld

Verplicht Veld Formaat Lengte Beschrijving
X1-EN.png requesttypedescriptions Alpha Max 20 De vereiste Verzoektype is "REFUND".
X1-EN.png sitereference Alfanumeriek
& underscore 		Max 50

Een unieke referentie die uw account identificeert. Deze ontvangt u wanneer u zich voor het eerst bij ons aanmeldt.

De site referentie in het verzoek REFUND moet dezelfde zijn als de site referentie die is gebruikt voor de verwerking van het bovengeschikte AUTH verzoek.
X2-EN.png accounttypedescription Alpha Max 20

Het type rekening dat wordt gebruikt om de transactie te verwerken. Geef "POS" op bij het verwerken van POS-transacties.

Dit veld is vereist, tenzij de parenttransactionreference is ingediend om gegevens te erven van de transactie die in plaats daarvan wordt terugbetaald.
X2-EN.png baseamount Numeriek Max 13

Het restitutiebedrag in basiseenheden, zonder komma's of decimalen, dus £10 wordt weergegeven als 1000.

Dit bedrag kan niet hoger zijn dan het uiteindelijke bedrag dat op uw bankrekening wordt gestort.

Dit veld is vereist, tenzij de parenttransactionreference is ingediend om gegevens te erven van de transactie die in plaats daarvan wordt terugbetaald.

Als parenttransactionreference wordt ingediend, wordt de volledige baseamount geërfd van de ouder (inclusief eventuele cashback die in de oorspronkelijke transactie is gespecificeerd), tenzij dit wordt opgeheven door een lagere waarde in het baseamount veld.
X2-EN.png kaartgegevensinvoermodus Alpha Max 18

De volgende waarden worden ondersteund:

  • CONTACTLOOS - Auto via contactloze M/Chip.
  • ICC - Auto via ICC.
  • ICCUNRELIABLE - Gegevens zijn gechipt gelezen en mogelijk onbetrouwbaar.
  • MAGSTRIPE - Auto via magneetstrip.
  • MAGSTRIPEFAILEDICC - Auto via magstrip - fallback als Auto via ICC mislukt.
  • MAGSTRIPEPARTIAL - Auto via mag stripe maar mag stripe gegevens niet volledig gelezen/overgebracht.

Als u een online PIN-transactie faciliteert, kunt u alleen CONTACTLESS, ICC of ICCUNRELIABLE opgeven.

Dit veld is vereist, tenzij de parenttransactionreference is ingediend om gegevens te erven van de transactie die in plaats daarvan wordt terugbetaald.
X2-EN.png kaarthouderauthenticatiemethode Alpha Max 15

De volgende waarden worden ondersteund:

  • ONDERTEKENING - Handtekening. (Kan alleen worden ingediend als de kaartgegevensinvoermodus "CONTACTLESS", "ICC", "ICCUNRELIABLE", "MAGSTRIPE", "MAGSTRIPEFAILEDICC" of "MAGSTRIPEPARTIAL" is)
  • MOBILEDEVICECVM - CVM uitgevoerd door mobiel apparaat. (Kan alleen worden ingediend als carddataentrymode "CONTACTLESS" is)
  • NOCVM - Niet geverifieerd. (Kan alleen worden ingediend als carddataentrymode "CONTACTLESS", "ICC", "ICCUNRELIABLE", "MAGSTRIPE", "MAGSTRIPEFAILEDICC" of "MAGSTRIPEPARTIAL" is)
  • ONLINEPIN - Online PIN. (kan alleen worden ingevoerd als de kaartgegevensinvoermodus "CONTACTLESS", "ICC" of "ICCUNRELIABLE" is)
  • OFFLINEPIN - Offline PIN. (Kan alleen worden ingediend als de kaartgegevensinvoermodus "ICC" of "ICCUNRELIABLE" is)

Dit veld is vereist, tenzij de parenttransactionreference is ingediend om gegevens te erven van de transactie die in plaats daarvan wordt terugbetaald.
X2-EN.png kaartvolgnummer Alfanumeriek Max. 3

Het kaartvolgnummer wordt gebruikt om kaarten met hetzelfde PAN te identificeren en te onderscheiden.

Dit wordt ingediend als een 2-cijferige waarde tot "99" (dit kan ook voorafgegaan worden door een 0, bijvoorbeeld "099").

Dit veld moet worden ingevuld als het beschikbaar is, tenzij het parenttransactionreference is, dan worden de gegevens overgenomen van de transactie die wordt terugbetaald.
X2-EN.png currencyiso3a ISO3A 3

De Munt van de restitutie.

Klik hier voor een volledige lijst van beschikbare munteenheden.

Dit veld is vereist, tenzij de parenttransactionreference is ingediend om gegevens te erven van de transactie die in plaats daarvan wordt terugbetaald.
X2-EN.png apparaatencryptedpan Alfanumeriek N/A

Gecodeerd PAN nummer.

Als parenttransactionreference wordt ingediend, dan worden de gegevens overgenomen van de transactie die wordt terugbetaald. Als dit niet het geval is, moet je in plaats daarvan EEN van de volgende velden invoeren:

  • apparaatencryptedpan
  • deviceencryptedtrack2data (aanbevolen)
  • pan
  • track2data
X2-EN.png deviceencryptedpin Alfanumeriek N/A

Gecodeerd PIN-blok.

Vereist bij het faciliteren van online PIN-functionaliteit.
X2-EN.png apparaatencryptedtrack2data Alfanumeriek N/A

Versleutelde track 2-gegevens.

Als parenttransactionreference wordt ingediend, dan worden de gegevens overgenomen van de transactie die wordt terugbetaald. Als dit niet het geval is, moet je in plaats daarvan EEN van de volgende velden invoeren:

  • apparaatencryptedpan
  • deviceencryptedtrack2data (aanbevolen)
  • pan
  • track2data
X2-EN.png apparaatencryptiesleuteltype Alfanumeriek, inclusief koppeltekens N/A

Kan zijn: "2DES", "3DES", "AES-128", "AES-192", "AES-256".

We raden aan om altijd de sterkste encryptie te gebruiken (in dit geval AES-256).

Verplicht indien velden deviceencryptedpan of deviceencryptedtrack2data zijn opgegeven.
X2-EN.png apparaateksn Alfanumeriek 20-24

Key Serial Number (KSN) van de transactie. Dit wordt verstrekt door het versleutelingsapparaat door de aaneenschakeling van een unieke identificatiecode met een interne versleutelingsteller.

Verplicht indien velden deviceencryptedpan of deviceencryptedtrack2data zijn opgegeven.
X2-EN.png expirydate Datum MM/JJJJ Max. 7

Dit veld wordt gebruikt om een restitutie met een bijgewerkte vervaldatum te verwerken.

Vereist bij het indienen van deviceencryptedpan.
X2-EN.png iccdata EMV tag formaat 4

Ondersteunde waarden:

5F2A, 71, 72, 82, 84, 8A, 91, 95, 9A, 9C, 9F02, 9F03, 9F09, 9F10, 9F1A, 9F1E, 9F26, 9F27, 9F33, 9F34, 9F35, 9F36, 9F37, 9F3B, 9F53, 9F6E, DF31.

Vereist voor ICC, CONTACTLESS en ICCUNRELIABLE, tenzij de parenttransactionreference is ingediend om in plaats daarvan gegevens te erven van de transactie die wordt terugbetaald.
X2-EN.png pan Numeriek 12-19

Dit is het lange nummer dat op de voorzijde van de kaart van de klant is gedrukt.

Als parenttransactionreference wordt ingediend, dan worden de gegevens overgenomen van de transactie die wordt terugbetaald. Als dit niet het geval is, moet je in plaats daarvan EEN van de volgende velden invoeren:

  • apparaatencryptedpan
  • deviceencryptedtrack2data (aanbevolen)
  • pan
  • track2data
X2-EN.png parenttransactionreference Alfanumeriek
& koppeltekens 		Max 25

Dit veld moet de Transactiereferentie bevatten van het AUTH verzoek dat u wilt terugbetalen.

Ofwel parenttransactionreference moet gegevens overnemen van de transactie die wordt terugbetaald, of de volgende velden moeten in plaats daarvan worden ingediend:

  • accounttypedescription
  • baseamount
  • kaartgegevensinvoermodus
  • kaarthouderauthenticatiemethode
  • kaartvolgnummer
  • currencyiso3a
  • Slechts EEN van de volgende: deviceencryptedpan, deviceencryptedtrack2data, pan of track2data
  • deviceencryptedpin
  • apparaatencryptiesleuteltype
  • apparaateksn
  • expirydate (Alleen vereist als deviceencryptedpan of pan is ingediend)
  • iccdata (Alleen vereist voor ICC, CONTACTLESS en ICCUNRELIABLE)
  • terminalcardcapturecapability
  • terminalcardoutputcapability
  • terminalid
  • terminalinputcapaciteit
  • terminalbedieningsomgeving
  • uitvoercapaciteit terminal
  • terminalpinentrycapability
  • track2data

Als u de parenttransactionreference om de restitutie uit te voeren, houd er dan rekening mee dat standaard het volledige baseamount wordt terugbetaald (inclusief het cashbackbasebedrag, indien van toepassing). Je kunt dit gedrag opheffen door een lager baseamount in het verzoek op te geven.
X2-EN.png terminalcardcapturecapability Numeriek 1

De volgende waarden worden ondersteund:

  • 0 - Onbekend.
  • 1 - Geen mogelijkheid om kaarten vast te leggen.
  • 2 - Kan kaarten vastleggen.

Dit veld is vereist, tenzij de parenttransactionreference is ingediend om gegevens te erven van de transactie die in plaats daarvan wordt terugbetaald.
X2-EN.png terminalcardoutputcapability Alfanumeriek 1

De volgende waarden worden ondersteund:

  • 0 - Onbekend.
  • 1 - Geen.
  • 2 - Magnetische strip schrijven.
  • 3 - ICC.
  • S - Andere

Dit veld is vereist, tenzij de parenttransactionreference is ingediend om gegevens te erven van de transactie die in plaats daarvan wordt terugbetaald.
X2-EN.png terminalid Numeriek 8

Identificatie van POS-terminal.

Dit veld is vereist, tenzij de parenttransactionreference is ingediend om gegevens te erven van de transactie die in plaats daarvan wordt terugbetaald.
X2-EN.png terminalinputcapaciteit Lijst van snaren  

Geef een lijst van de modi voor kaartgegevensinvoer die door deze terminal worden ondersteund:

  • CONTACTLESS - Mogelijkheid om contactloze betalingen te accepteren (zowel mobiel als met kaart).
  • ICC - Mogelijkheid om betalingen met contact Integrated Circuit Card (AKA "Chip en PIN") te accepteren.
  • KEYED - Mogelijkheid om betalingen te accepteren waarbij kaartgegevens handmatig in de terminal worden ingevoerd.
  • MAGSTRIPE - Mogelijkheid om veegbetalingen te accepteren.

Dit veld is vereist, tenzij de parenttransactionreference is ingediend om gegevens te erven van de transactie die in plaats daarvan wordt terugbetaald.
X2-EN.png terminalbedieningsomgeving Numeriek 1

De volgende waarden worden ondersteund:

  • 0 - Onbekend.
  • 1 - Geen terminal gebruikt.
  • 2 - Op het terrein van de kaartacceptant, bijgewoond.
  • 3 - Buiten het terrein van de kaartacceptant, bijgewoond.

Dit veld is vereist, tenzij de parenttransactionreference is ingediend om gegevens te erven van de transactie die in plaats daarvan wordt terugbetaald.
X2-EN.png uitvoercapaciteit terminal Char 1

De volgende waarden worden ondersteund:

  • U - Onbekend.
  • N - Geen.
  • P - Afdrukken.
  • D - Weergeven.
  • B - Afdrukken en weergave.

Dit veld is vereist, tenzij de parenttransactionreference is ingediend om gegevens te erven van de transactie die in plaats daarvan wordt terugbetaald.
X2-EN.png terminalpinentrycapability Alfanumeriek 1

De volgende waarden worden ondersteund:

  • U - Onbekend.
  • N - De terminal kan geen PIN-code invoeren.
  • X - Terminal heeft mogelijkheid tot PIN-invoer, maar PIN-pad werkt momenteel niet.
  • O - Andere.
  • 4 - De terminal kan een pincode van 4 cijfers invoeren.
  • 5 - De terminal kan een pincode van 5 cijfers invoeren.
  • 6 - Terminal kan pincode invoeren, pincode 6+ cijfers.

Dit veld is vereist, tenzij de parenttransactionreference is ingediend om gegevens te erven van de transactie die in plaats daarvan wordt terugbetaald.
X2-EN.png track2data ISO 7813 Max 40

Track 2-gegevens - dit is de informatie op de chip of magneetstrip van de creditcard/debetkaart van de klant. Verzend deze samen met de start/einde sentinel en LRC indien aanwezig.

Als parenttransactionreference wordt ingediend, dan worden de gegevens overgenomen van de transactie die wordt terugbetaald. Als dit niet het geval is, moet je in plaats daarvan EEN van de volgende velden invoeren:

  • apparaatencryptedpan
  • deviceencryptedtrack2data (aanbevolen)
  • pan
  • track2data
X3-EN.png chargedescription Alfanumeriek, inclusief
symbolen 		Max 25

Dit is een beschrijving van de betaling die op het bankafschrift van de klant verschijnt.

 Geldige tekens:

  • Hoofdletters/kleine letters A-Z
  • Cijfers 0-9
  • Ruimtes
  • Interpunctie: + - _ . @ ( )
X3-EN.png orderreference

Alfanumeriek, inclusief
symbolen

 Max 25

Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen.

Als dit niet wordt ingediend, wordt het geërfd van het bovengeschikte AUTH verzoek.
X3-EN.png paymenttypedescription Alpha Max 20

Betalingsmethode (bijv. "VISA" of "MASTERCARD").
REFUND Reactie
REFUND Reactie
{
  "requestreference":"W23-22rd4301",
  "version":"1.00",
  "response":[{
    "accounttypedescription":"POS",
    "acquirerresponsecode":"00",
    "acquirerresponsemessage": "Approved or completed Successfully",
    "authcode":"TEST REFUND ACCEPTED",
    "baseamount":"2000",
    "currencyiso3a":"GBP",
    "errorcode":"0",
    "errormessage":"Ok",
    "issuer":"SecureTrading Test Issuer1",
    "issuercountryiso2a":"US",
    "livestatus":"0",
    "maskedpan":"411111######1111",
    "merchantcategorycode": "7001",
    "merchantcountryiso2a":"GB",
    "merchantname":"Test Merchant",
    "merchantnumber":"00000000",
    "operatorname":"webservices@example.com",
    "orderreference":"My_Order_123",
    "parenttransactionreference":"1-2-345678",
    "paymenttypedescription":"VISA",
    "requesttypedescription":"REFUND",
    "securityresponseaddress":"0",
    "securityresponsepostcode":"0",
    "securityresponsesecuritycode":"0",
    "settleduedate":"2016-12-07",
    "settlestatus":"0",
    "transactionreference":"1-2-345679",
    "transactionstartedtimestamp":"2016-12-07 15:31:48"
  }],
  "secrand":"SNQVg"
}

 

Specificatie veld

Verplicht Veld Formaat Lengte Beschrijving
X4-EN.png accounttypedescription Alpha Max 20 Het type rekening dat wordt gebruikt om de terugbetaling te verwerken. Verwacht dat "POS" wordt geretourneerd bij het uitvoeren van POS-transacties.
X4-EN.png baseamount Numeriek Max 13 Het bedrag van de terugbetaling in basiseenheden, zonder komma's of decimalen, dus £10 wordt weergegeven als 1000.
X4-EN.png currencyiso3a ISO3A Max. 3

De Munt van de restitutie.

Klik hier voor een volledige lijst van beschikbare munteenheden.
X4-EN.png errorcode Numeriek 1-5 De Foutcode moet worden gebruikt om te bepalen of de terugbetaling is gelukt of niet.
  • Als de Foutcode "0" is, was de terugbetaling succesvol.
  • Als de Foutcode niet "0" is, is de restitutie niet gelukt.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.
X4-EN.png errormessage Alfanumeriek Max 255 Dit geeft een korte uitleg over de oorzaak van de fout.

Voor succesvolle restituties wordt dit geretourneerd als "Ok".

Klik hier voor een volledige lijst van errorcode en berichtwaarden.
X4-EN.png uitgever Alfanumeriek Max 255 De uitgever van de kaart van de klant.
X4-EN.png issuercountryiso2a ISO2A 2

Het land voor de uitgever van de kaart van de klant.
Dit zal in ISO2A formaat zijn.

Klik hier voor een volledige lijst van landcodes.
X4-EN.png livestatus Numeriek 1
  • 0 - Restitutie verwerkt met een testaccount.
  • 1 - Restitutie verwerkt met een live account.
X4-EN.png maskedpan Alfanumeriek inclusief "#" 12-19 Het veld maskedpan veld vertegenwoordigt het kaartnummer van de klant. De waarde van maskedpan veld wordt gemaskeerd in het antwoord. Het grootste deel van het nummer wordt opzettelijk verborgen door "#" tekens, bijv. 411111######0211.
X4-EN.png merchantnumber Alfanumeriek Max 32 Het handelaarsnummer dat is gebruikt om de terugbetaling te verwerken. Verstrekt door de acquiring bank.
X4-EN.png operatorname Alfanumeriek Max 255 De waarde van dit veld bevat de naam van de gebruiker die de terugbetaling heeft verwerkt.
X4-EN.png paymenttypedescription Alpha Max 20 Betalingsmethode (bijv. "VISA" of "MASTERCARD").
X4-EN.png requesttypedescription Alpha Max 20 "REFUND" wordt geretourneerd in het antwoord.
X4-EN.png securityresponseaddress Numeriek 1 Het resultaat van AVS en beveiligingscodecontroles.

Klik hier voor meer informatie.
X4-EN.png securityresponsepostcode Numeriek 1 Het resultaat van AVS en beveiligingscodecontroles.

Klik hier voor meer informatie.
X4-EN.png securityresponsesecuritycode Numeriek 1 Het resultaat van AVS en beveiligingscodecontroles.

Klik hier voor meer informatie.
X4-EN.png settleduedate Datum JJJJ-MM-DD 10 De datum waarop de restitutie wordt verrekend.
X4-EN.png settlestatus Numeriek Max. 3

Een numerieke waarde die wordt gebruikt om de voortgang van afwikkeling met betrekking tot deze restitutie aan te geven.

Klik hier voor een volledige lijst met settlestatus waarden.
X4-EN.png transactionreference Alfanumeriek, inclusief koppeltekens Max 25 Een unieke referentie voor de restitutie die is toegewezen door Trust Payments. U hebt deze referentie nodig om de restitutie bij te werken.
X4-EN.png transactionstartedtimestamp Datum tijd JJJJ-MM-DD hh:mm:ss Max. 19 Het tijdstip waarop de restitutie is verwerkt.
X2-EN.png acquirerresponsecode Alfanumeriek Max 255

Gebruikt door uw verwerver om het resultaat van het verzoek aan te geven.

Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie.
X2-EN.png acquirerresponsemessage Alfanumeriek Max 255

Gebruikt door uw verwerver om het resultaat van het verzoek aan te geven.

Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie.
X2-EN.png authcode Alfanumeriek Max 255

De autorisatie code verstrekt door de uitgevende bank. Deze zal verschillen afhankelijk van de bank die u gebruikt.

Alleen geretourneerd als de restitutie is goedgekeurd.
X2-EN.png kasbasisbedrag Numeriek Max 13

Het cashbackbedrag aangevraagd door de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.
X2-EN.png errordata Alfanumeriek Max 255

Aanvullende informatie om te helpen bij het oplossen van de fout.

Wordt alleen geretourneerd als er een fout is opgetreden.
X2-EN.png merchantcategorycode Alfanumeriek Max 255

Dit zijn gegevens die zijn gekoppeld aan de account die wordt gebruikt om de restitutie te verwerken. Als je deze velden wilt wijzigen, neem dan contact op met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantcity Alfanumeriek Max 127

Dit zijn gegevens die zijn gekoppeld aan de account die wordt gebruikt om de restitutie te verwerken. Als je deze velden wilt wijzigen, neem dan contact op met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantcountryiso2a ISO2A Max. 2

Dit zijn gegevens die zijn gekoppeld aan de account die wordt gebruikt om de restitutie te verwerken. Als je deze velden wilt wijzigen, neem dan contact op met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantname Alfanumeriek Max 255

Dit zijn gegevens die zijn gekoppeld aan de account die wordt gebruikt om de restitutie te verwerken. Als je deze velden wilt wijzigen, neem dan contact op met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantstatecode Alfanumeriek Max 127

Dit zijn gegevens die zijn gekoppeld aan de account die wordt gebruikt om de restitutie te verwerken. Als je deze velden wilt wijzigen, neem dan contact op met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantzipcode Alfanumeriek Max 10

Dit zijn gegevens die zijn gekoppeld aan de account die wordt gebruikt om de restitutie te verwerken. Als je deze velden wilt wijzigen, neem dan contact op met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png orderreference Alfanumeriek, inclusief symbolen Max 255

Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen.

Opmerking: Dit kan op een later tijdstip worden bijgewerkt (alleen als de restitutie in behandeling is afwikkeling).

Dit veld wordt teruggestuurd indien het in het verzoek is ingediend.
X2-EN.png parenttransactionreference Alfanumeriek, inclusief koppeltekens Max 25

De transactionreference van de transactie die wordt terugbetaald, waarvan de belangrijkste details zijn overgenomen.

Dit veld wordt teruggestuurd indien het in het verzoek is ingediend.
X2-EN.png retrievalreferencenumber Alfanumeriek Max 255

Een ISO-term. Deze wordt gebruikt om te verwijzen naar de bronrestitutie.

Dit varieert afhankelijk van uw wervende bank. Neem contact op met uw bank voor meer informatie.
X2-EN.png tid Alfanumeriek Max 255

De terminal ID die wordt gebruikt om de terugbetaling te verwerken. Dit is gekoppeld aan je handelaarsnummer toen we je account in onze systemen instelden.

Of dit veld wordt geretourneerd, hangt af van uw acquiring bank. Neem contact op met ons Support Team als u hulp nodig heeft.

 

Transactie bijwerken

 

 

  TRANSACTIONUPDATE Overzicht

Om updates uit te voeren op een verwerkte transactie, moet je een TRANSACTIONUPDATE verzoek indienen en het geretourneerde antwoord verwerken. Het TRANSACTIONUPDATE verzoek bestaat uit filters en updates.

 

  1. Filters
    • Zie filters als zoekcriteria. Trust Payments zal deze gebruiken om de bij te werken transactie te vinden, de updates zo mogelijk uit te voeren en een antwoord terug te sturen ter bevestiging.
    • Een filter met transactionreference "1-2-345" zou de transactie die overeenkomt met deze referentie vinden en bijwerken.
  2. Updates
    • Er zijn een aantal velden die kunnen worden bijgewerkt, zoals beschreven in de onderstaande specificaties.
    • Een lopende transactie kan bijvoorbeeld worden geannuleerd door settlestatus bij te werken naar "3", waarna gereserveerde fondsen op de rekening van de klant automatisch worden teruggeboekt.
    • De settlebaseamount kan ook worden bijgewerkt om een lager betalingsbedrag te vereffenen dan oorspronkelijk was toegestaan.

  Verwerking TRANSACTIONUPDATE

TRANSACTIONUPDATE Aanvraag

Hieronder volgen voorbeelden van TRANSACTIONUPDATE verzoeken:

Emittent script opschorten opnieuw inschakelen Annuleren Gedeeltelijke afwikkeling 
{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescriptions":["TRANSACTIONUPDATE"],
    "filter":{
      "sitereference":[{"value":"test_site12345"}],
      "transactionreference":[{"value":"1-2-3"}]
    },
    "updates":{"issuerscriptresults":"8A023030A1"}
  }]
}

 

Filters veldspecificatie

Verplicht Veld Formaat Lengte Beschrijving
X1-EN.png sitereference Alfanumeriek inclusief underscore Max 50 De unieke referentie voor de Trust Payments site die verband houdt met de transactie die u wilt bijwerken.
X1-EN.png transactionreference Alfanumeriek, inclusief koppeltekens Max 25 De unieke Trust Payments referentie voor de transactie die u wilt bijwerken.

 

Veldspecificatie bijwerken

De volgende velden kunnen worden bijgewerkt wanneer updates worden uitgevoerd op AUTH en REFUND verzoeken.

Verplicht Veld Formaat Lengte Beschrijving
X3-EN.png issuerscriptresults Hexadecimaal (0-9, A-F) 10

Alleen ondersteund bij het bijwerken van AUTH met een antwoord dat iccdataresponse bevatte.

Opdrachten die door de uitgever van de kaart van de klant worden verzonden (bekend als "issuer scripts") kunnen uit het iccdataresponse worden gehaald. Zodra de terminal deze commando's tegen de kaart heeft uitgevoerd, kunnen de resultaten worden ingediend als een bijwerking van de transactie met behulp van het veld issuerscriptresults.

Het is het beste om deze stap uit te voeren na het verwerken van een AUTH verzoek, zodat onze gegevens up-to-date blijven.
X3-EN.png orderreference Alfanumeriek, inclusief
symbolen 		Max 25 Update de unieke orderreferentie die kan worden opgeslagen op het Trust Payments systeem.
X3-EN.png settlebaseamount Numeriek Max 13 Het bedrag van de transactie in basiseenheden, zonder komma's of decimalen, dus €10,50 zou 1050 zijn. Deze waarde moet hoger zijn dan nul en lager dan of gelijk aan het oorspronkelijke autorisatiebedrag.
X3-EN.png settleduedate Datum JJJJ-MM-DD Max 10 Datum waarop de transactie zal worden afgewikkeld. Indien vandaag of eerder, wordt de transactie afgewikkeld wanneer afwikkeling de volgende keer wordt uitgevoerd (mits niet opgeschort of geannuleerd).
X3-EN.png settlestatus Numeriek Max. 3 Deze waarde heeft betrekking op de status van de transactie.
TRANSACTIONUPDATE Reactie

Hieronder staat een voorbeeld van een TRANSACTIONUPDATE antwoord dat is teruggestuurd na een geslaagde transactie-update.

TRANSACTIONUPDATE antwoord
{
  "requestreference":"W23-tkrxwkc6",
  "version":"1.00",
  "response":[{
    "errorcode":"0",
    "errormessage":"Ok",
    "requesttypedescription":"TRANSACTIONUPDATE",
    "transactionstartedtimestamp":"2019-12-17 10:58:20"
  }],
  "secrand":"SptlJutnBnQ"
}

Zorg ervoor dat Foutcode "0" is. Dit geeft aan dat het TRANSACTIONUPDATE verzoek met succes is verwerkt. Als de Foutcode niet "0" is, is het verzoek mogelijk niet verwerkt zoals verwacht.

 

Specificatie veld

Verplicht Veld Formaat Lengte Beschrijving
X4-EN.png errorcode Numeriek Max 5 Via Foutcode moet worden bepaald of de update geslaagd is of niet.
  • Als de Foutcode "0" is, was de update succesvol.
  • De Foutcode "20004" (Ontbrekende ouder) kan soms worden geretourneerd als je te snel na het verwerken van het initiële verzoek een update probeert uit te voeren. Als dit gebeurt, wacht dan een paar seconden en probeer het opnieuw.
  • Als Foutcode niet "0" is, was de update niet succesvol.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.
X4-EN.png errormessage Alfanumeriek Max 255 Dit geeft een korte uitleg over de oorzaak van de fout.

Voor succesvolle transacties wordt dit geretourneerd als "Ok".

Klik hier voor een volledige lijst van errorcode en berichtwaarden.
X4-EN.png requesttypedescription Alpha Max 20 "TRANSACTIONUPDATE" wordt teruggestuurd in het antwoord.
X4-EN.png transactionstartedtimestamp Datum tijd JJJJ-MM-DD hh:mm:ss 19 Het tijdstip waarop de update is verwerkt.
X2-EN.png errordata Alfanumeriek Max 255

Aanvullende informatie om te helpen bij het oplossen van de fout.

Wordt alleen geretourneerd als er een fout is opgetreden.

 

Vraagtransactie

 

 

  TRANSACTIONQUERY Overzicht

Om details te bekijken en de status van een verwerkte transactie te controleren, moet je een TRANSACTIONQUERY verzoek indienen en het geretourneerde antwoord verwerken.

 

  1. Filters
    • Het verzoek TRANSACTIONQUERY bestaat voornamelijk uit filters. Zie filters als zoekcriteria; het geretourneerde antwoord zal informatie bevatten die voldoet aan de opgegeven filters.
    • Een filter met transactionreference "1-2-345" zou bijvoorbeeld opgeslagen details voor de genoemde transactie retourneren.
  2. Geavanceerd zoeken
    • Als een query overeenkomt met meerdere verzoeken, worden deze allemaal geretourneerd in één reactie. Als je deze uitkomst wilt vermijden, raden we je aan zo specifiek mogelijk te zijn in je verzoek, door zoveel filters in te dienen als nodig is.
    • Als je bijvoorbeeld een starttimestamp en endtimestamp opgeeft, worden er details geretourneerd van alle aanvragen die op je account zijn verwerkt tussen de opgegeven tijden.
    • Je kunt ook meerdere waarden opgeven voor elk opgegeven filter. Je kunt bijvoorbeeld een filter opgeven voor transactionreference waarden "23-9-1" en "23-9-2", en alle verzoeken die overeenkomen met deze waarden worden teruggestuurd in het antwoord. (We geven hieronder een voorbeeld van dit geval)

  Verwerking TRANSACTIONQUERY

TRANSACTIONQUERY Aanvraag

Om het verzoek TRANSACTIONQUERY met succes te kunnen verwerken, moet u ten minste één geldig filter indienen.

 

TRANSACTIONQUERY Aanvraag
{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescriptions":["TRANSACTIONQUERY"],
    "filter":{
      "sitereference":[{"value":"test_site12345"}],
      "transactionreference":[{"value":"23-9-1"},{"value":"23-9-2"}]
    }
  }]
}

 

Specificatie veld

In de volgende tabel staan alle velden die u in het filter kunt opnemen bij het verwerken van een TRANSACTIONQUERY verzoek.

  Hoewel geen van de volgende filtervelden verplicht is, moet ten minste één filter worden ingediend om het verzoek met succes te kunnen verwerken. Daarom zijn de meeste velden hieronder als voorwaardelijk gemarkeerd.

Een uitzondering op dit gedrag is het sitereference filter, dat niet alleen kan worden ingediend; het moet vergezeld gaan van ten minste één ander filter. Deze beperking wordt opgelegd om de belasting van onze servers te verminderen.

Verplicht Veld Formaat Lengte Beschrijving
X2-EN.png accounttypedescription Alpha Max 20 Het type rekening dat wordt gebruikt om het verzoek te verwerken. Geef "POS" op om POS-transacties te filteren.
X2-EN.png billingpostcode Alfanumeriek, inclusief symbolen Max 25 De Postcode facturatie of postcode. Dit moet een geldige postcode zijn voor de billingcountryiso2a ingediend.
X2-EN.png billingpremise Alfanumeriek, inclusief symbolen Max 20 Het nummer of de naam van het gebouw van het factuuradres van de klant.
X2-EN.png billingstreet Alfanumeriek, inclusief symbolen Max 20 De straatnaam van het factuuradres van de klant.
X2-EN.png currencyiso3a ISO3A 3

De transactie Munt.

Klik hier voor een volledige lijst van Munt codes.
X2-EN.png eindtijdstempel Datum Tijd JJJJ-MM-DD HH:MM:SS Max. 19 Alleen verzoeken die vóór de opgegeven tijdstempel zijn verwerkt, worden geretourneerd.

(In tegenstelling tot andere filters kunt u slechts één endtimestamp in een verzoek indienen)
X2-EN.png orderreference Alfanumeriek, inclusief symbolen Max 25 Uniek referentienummer dat u opgeeft voor het verzoek.
X2-EN.png pan Numeriek 12-19 Dit is het kaartnummer dat op de voorkant van de kaart van de klant staat.
X2-EN.png parenttransactionreference Alfanumeriek, inclusief koppeltekens Max 25 Unieke referentie van het bovengeschikte verzoek.
X2-EN.png paymenttypedescription Alpha Max 20 Het type kaart van de klant (bijv. "VISA" of "MASTERCARD").
X2-EN.png requesttypedescription Alpha Max 20

De Verzoektype die bij de transactie hoort. Bijvoorbeeld "AUTH" of "REFUND".

Klik hier voor een volledige lijst van soorten verzoeken.
X2-EN.png starttimestamp Datum Tijd JJJJ-MM-DD HH:MM:SS Max. 19 Alleen verzoeken die na de opgegeven tijdstempel zijn verwerkt, worden geretourneerd.

(In tegenstelling tot andere filters kunt u slechts één starttimestamp in een verzoek indienen)
X2-EN.png transactionreference Alfanumeriek, inclusief koppeltekens Max 25 De unieke referentie in verband met de transactie, toegewezen door Trust Payments.
X3-EN.png sitereference Alpha Max 50

De sitereferentie die de transactie heeft verwerkt.

Het filter sitereferentie moet samen met ten minste één ander filter worden ingediend, anders wordt een foutmelding teruggestuurd.
TRANSACTIONQUERY Reactie

Wanneer u met succes een TRANSACTIONQUERY verzoek hebt ingediend, krijgt u een antwoord dat in afzonderlijke records is opgedeeld.

Elke record bevat een variërend aantal antwoordvelden, die afhankelijk zijn van de Verzoektype die in de record is aangegeven. Als de record bijvoorbeeld een requesttypedescription van "AUTH" heeft, dan moet u de veldspecificatie in de autorisatie raadplegen.

Bovendien bevat het antwoord een veld genaamd "found", dat het aantal records aangeeft dat overeenstemt met de in het verzoek opgegeven filters. Als gevonden een waarde "0" heeft, zijn er geen records gevonden met de door u opgegeven filters.

Hier is bijvoorbeeld een vereenvoudigd voorbeeld van de structuur van het antwoord, bestaande uit 2 records (beide zijn van het type "AUTH"):

TRANSACTIONQUERY antwoord
{"requestreference":"W72-pg3q2he9",
  "version":"1.00",
  "response":[{
    "errorcode":"0",
    "errormessage":"Ok",
    "found":"2",
    "records":[{
      "accounttypedescription":"POS",
      "acquirerresponsecode":"00",
      "acquirerresponsemessage": "Approved or completed Successfully",
      "authcode":"TEST22",
      "baseamount":"1050",
      "currencyiso3a":"GBP",
      "errorcode":"0",
      "errormessage":"Ok",
      "expirydate":"10\/2022",
      "fraudrating":"0",
      "interface":"PASS-JSON-JSON",
      "issuer":"Test Issuer",
      "issuercountryiso2a":"GB",
      "livestatus":"0",
      "maskedpan":"411111######1111",
      "merchantcategorycode": "7001",
      "merchantcountryiso2a":"GB",
      "merchantname":"Test Merchant",
      "operatorname":"webservices@example.com",
      "orderreference":"My_Order_123",
      "paymenttypedescription":"VISA",
      "requesttypedescription":"AUTH",
      "retrievalreferencenumber": "300316080007",
      "securityresponseaddress":"0",
      "securityresponsepostcode":"0",
      "securityresponsesecuritycode":"2",
      "settlebaseamount":"1050",
      "settleduedate":"2019-12-17",
      "settlestatus":"0",
      "sitereference":"test_site12345",
      "terminalid":"12345678",
      "transactionreference":"23-9-1",
      "transactionstartedtimestamp":"2019-12-17 09:35:03"
    },
    {
      "accounttypedescription":"POS",
      "acquirerresponsecode":"00",
      "acquirerresponsemessage": "Approved or completed Successfully",
      "authcode":"TEST03",
      "baseamount":"1050",
      "currencyiso3a":"GBP",
      "errorcode":"0",
      "errormessage":"Ok",
      "expirydate":"10\/2022",
      "fraudrating":"0",
      "interface":"PASS-JSON-JSON",
      "issuer":"SecureTrading Test Issuer1",
      "issuercountryiso2a":"US",
      "livestatus":"0",
      "maskedpan":"411111######1111",
      "merchantcategorycode": "7001",
      "merchantcountryiso2a":"GB",
      "merchantname":"Test Merchant",
      "operatorname":"webservices@example.com",
      "orderreference":"My_Order_123",
      "paymenttypedescription":"VISA",
      "requesttypedescription":"AUTH",
      "retrievalreferencenumber": "300316080007",
      "securityresponseaddress":"0",
      "securityresponsepostcode":"0",
      "securityresponsesecuritycode":"2",
      "settlebaseamount":"1050",
      "settleduedate":"2019-12-17",
      "settlestatus":"0",
      "sitereference":"test_site12345",
      "terminalid":"12345678",
      "transactionreference":"23-9-2",
      "transactionstartedtimestamp":"2019-12-17 09:35:10"
    }],
    "requesttypedescription":"TRANSACTIONQUERY",
    "transactionstartedtimestamp":"2019-12-17 09:36:21"
  }],
  "secrand":"uISZfw8wKWR"
}

  Per antwoord kunnen maximaal 500 records worden teruggestuurd.

Het gevonden veld zal nooit een waarde hoger dan 500 opleveren, ook al voldoen meer dan 500 verzoeken aan de opgegeven criteria.

 

Fouten begrijpen

Zorg ervoor dat u de Foutcode (errorcode)s in het antwoord:

  • Op het hoogste niveau van het antwoord, samen met transactionstartedtimestamp en gevonden, is er een errorcode. Dit geeft aan of het TRANSACTIONQUERY verzoek al dan niet succesvol was. Als de errorcode hier niet "0" is, was het TRANSACTIONQUERY verzoek niet succesvol. U moet het probleem aanpakken en het opnieuw proberen.
  • Bovendien zal elk record zijn eigen errorcode. Dit geeft aan of het verzoek in de record al dan niet succesvol was.
  • Voor een volledige lijst van foutcodes (errorcode) gebruikt door Trust Payments, klik hier.

 

Specificatie veld

De volgende tabel bevat alle velden die in een gegeven record kunnen worden teruggegeven.

Velden worden alleen geretourneerd als de gegevens beschikbaar zijn voor het opgevraagde verzoek.
Dit kan variëren afhankelijk van Verzoektype.

Verplicht Veld Formaat Lengte Beschrijving
X4-EN.png accounttypedescription Alpha Max 20 Het type rekening dat wordt gebruikt om het opgevraagde verzoek te verwerken. Verwacht dat "POS" wordt geretourneerd bij het opvragen van POS-transacties.
X4-EN.png baseamount Numeriek Max 13

Het bedrag van de opgevraagde transactie in basiseenheden, zonder komma's of decimalen, dus €10 wordt ingediend als 1000.

Mastercard kan cashbackverzoeken weigeren. Als dit gebeurt, wordt het cashbackbaseamount-veld geretourneerd met waarde "0" en dit bedrag wordt ook afgetrokken van het totaal baseamount geretourneerd.
X4-EN.png currencyiso3a ISO3A 3

De Munt van de opgevraagde transactie.

Klik hier voor een volledige lijst van beschikbare munteenheden.
X4-EN.png errorcode Numeriek Max 5 De foutcode (errorcode) moet worden gebruikt om te bepalen of het (de) opgevraagde verzoek(en) succesvol was (waren).
  • Als de foutcode "0" is, is de transactie geslaagd.
  • Als de foutcode niet "0" is, was de transactie niet succesvol.

Klik hier voor een volledige lijst van errorcode en berichtwaarden.
X4-EN.png errormessage Alfanumeriek Max 255 Dit geeft een korte uitleg over de oorzaak van de fout.

Voor succesvolle transacties wordt dit geretourneerd als "Ok".

Klik hier voor een volledige lijst van errorcode en berichtwaarden.
X4-EN.png interface Alfanumeriek, inclusief symbolen Max 50

Vertegenwoordigt de interface via welke het opgevraagde verzoek werd verwerkt. De volgende zijn gangbare voorbeelden:

  • "JWT-JWT-JWT" - JavaScript Library of Mobile SDK.
  • "MYST" - MyST (bijv. Refund, Virtuele terminal of Payout terminal).
  • "PASS-JSON-JSON" - Webservices API met JSON-opmaak.
  • "PASS-XML-XML" - Webservices API met XML-opmaak.
X4-EN.png livestatus Numeriek 1
  • 0 - De opgevraagde transactie is verwerkt met een testrekening.
  • 1 - De opgevraagde transactie is verwerkt met een live-rekening.
X4-EN.png

maskedpan

 Alfanumeriek inclusief "#" 12-19

Het veld maskedpan veld vertegenwoordigt het kaartnummer van de klant. De waarde van maskedpan veld wordt gemaskeerd in het antwoord. Het grootste deel van het nummer wordt opzettelijk verborgen door "#" tekens, bijv. 411111######0211.
X4-EN.png operatorname Alfanumeriek Max 255 De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt.
X4-EN.png paymenttypedescription Alpha Max 20 Betalingsmethode (bijv. "VISA" of "MASTERCARD").
X4-EN.png requesttypedescription Alpha Max 20 Het type verzoek dat in de record wordt teruggestuurd.
X4-EN.png settlebaseamount Numeriek Max 13

De waarde van het te verrekenen bedrag. Het verrekende bedrag kan worden bijgewerkt om lager te zijn dan het oorspronkelijk geautoriseerde bedrag met een TRANSACTIONUPDATE verzoek.

X4-EN.png settleduedate Datum JJJJ-MM-DD Max 10 De datum waarop de opgevraagde transactie zal worden afgewikkeld.
X4-EN.png settlestatus Numeriek Max. 3

Een numerieke waarde die wordt gebruikt om de voortgang van afwikkeling met betrekking tot de opgevraagde transactie aan te geven.

Klik hier voor een volledige lijst van settlestatus waarden.
X4-EN.png sitereference Alfanumeriek
& underscore 		Max 50

De sitereferentie via welke het opgevraagde verzoek is verwerkt.
X4-EN.png terminalid Alfanumeriek 8 Identificatie van POS-terminal.
X4-EN.png transactionreference Alfanumeriek, inclusief
koppeltekens 		Max 25 Een unieke referentie voor de opgevraagde transactie, toegewezen door Trust Payments. U hebt deze referentie nodig om een terugbetaling uit te voeren of de transactie bij te werken.
X4-EN.png transactionstartedtimestamp  Datum tijd JJJJ-MM-DD hh:mm:ss Max. 19 Het tijdstip waarop de opgevraagde transactie werd verwerkt.
X2-EN.png

acquirerresponsecode

 Alfanumeriek Max 255

Gebruikt door uw verwerver om het resultaat van het opgevraagde verzoek aan te geven.

Of deze velden worden teruggestuurd, hangt af van uw acquiring bank. Neem contact op met ons Support Team als u hulp nodig heeft.
X2-EN.png

acquirerresponsemessage

 Alfanumeriek Max 255
X2-EN.png authcode Alfanumeriek Max 255

De autorisatie code verstrekt door de uitgevende bank. Deze zal verschillen afhankelijk van de bank die u gebruikt.

Wordt alleen geretourneerd indien de opgevraagde transactie werd geautoriseerd.
X2-EN.png billingpostcode Alfanumeriek Max 25

De postcode die is ingevoerd voor het factuuradres van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.
X2-EN.png billingpremise Alfanumeriek, inclusief
symbolen 		Max 25

Het huisnummer of de eerste regel van het factuuradres van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.
X2-EN.png billingstreet Alfanumeriek, inclusief
symbolen 		Max 127

De straat die is ingevoerd voor het factuuradres van de klant.

Dit veld wordt teruggegeven indien het beschikbaar is.
X2-EN.png kasbasisbedrag Numeriek Max 13

Het cashbackbedrag aangevraagd door de klant.

Mastercard kan cashbackverzoeken weigeren. Als dit gebeurt, wordt cashbackbaseamount weergegeven met waarde "0".

Dit veld wordt teruggegeven indien het beschikbaar is.
X2-EN.png chargedescription Alfanumeriek, inclusief
symbolen 		Max 25

Dit is een beschrijving van de opgevraagde betaling die op het bankafschrift van de klant staat.

Dit veld wordt teruggegeven indien het beschikbaar is.
X2-EN.png errordata Alfanumeriek Max 255

Aanvullende informatie om te helpen bij het oplossen van de fout.

Wordt alleen geretourneerd als er een fout is opgetreden.
X2-EN.png expirydate Datum MM/JJJJ Max. 7

De op de kaart gedrukte vervaldatum.

Alleen teruggestuurd voor kaarttransacties.
X2-EN.png fraudrating Numeriek Max. 2

Dit veld heeft betrekking op onze interne fraudecontroles, zoals gedocumenteerd in dit artikel. Deze waarde vertegenwoordigt de momenteel toegewezen frauderating van de opgevraagde transactie.

Deze functie is opt-in. Indien niet ingeschakeld op uw sitereferentie, wordt altijd 0 teruggestuurd.

Als u zich heeft aangemeld:

  • -1 geeft aan dat er controles in behandeling zijn.
  • Hoe hoger de frauderating, hoe groter het aantal verdachte kenmerken dat door ons fraudesysteem is vastgesteld.
  • Standaard brengen wij u op de hoogte van transacties met een frauderating van 2 of hoger.
  • Standaard schorten wij alle transacties op die een frauderating van 5 of hoger hebben.

Klik hier voor meer informatie.

Alleen teruggestuurd voor kaarttransacties.
X2-EN.png uitgever Alfanumeriek Max 255

De uitgever van de kaart van de klant.

Alleen teruggestuurd voor kaarttransacties.
X2-EN.png issuercountryiso2a ISO2A 2

Het land voor de uitgever van de kaart van de klant.
Dit zal in ISO2A formaat zijn.

Klik hier voor een volledige lijst van landcodes.

Alleen teruggestuurd voor kaarttransacties.
X2-EN.png merchantcategorycode Alfanumeriek Max 255

Dit zijn gegevens die verband houden met de rekening die wordt gebruikt om de opgevraagde transactie te verwerken. Als u deze velden wilt wijzigen, neem dan contact op met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantcity Alfanumeriek Max 127

Dit zijn gegevens die verband houden met de rekening die wordt gebruikt om de opgevraagde transactie te verwerken. Als u deze velden wilt wijzigen, neem dan contact op met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantcountryiso2a ISO2A 2

Dit zijn gegevens die verband houden met de rekening die wordt gebruikt om de opgevraagde transactie te verwerken. Als u deze velden wilt wijzigen, neem dan contact op met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantname Alfanumeriek Max 255

Dit zijn gegevens die verband houden met de rekening die wordt gebruikt om de opgevraagde transactie te verwerken. Als u deze velden wilt wijzigen, neem dan contact op met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantstatecode Alfanumeriek Max 127

Dit zijn gegevens die verband houden met de rekening die wordt gebruikt om de opgevraagde transactie te verwerken. Als u deze velden wilt wijzigen, neem dan contact op met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png merchantzipcode Alfanumeriek Max 10

Dit zijn gegevens die verband houden met de rekening die wordt gebruikt om de opgevraagde transactie te verwerken. Als u deze velden wilt wijzigen, neem dan contact op met ons Support Team.

De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
X2-EN.png orderreference Alfanumeriek, inclusief
symbolen 		Max 25

De unieke referentie bestelling voor het opgevraagde verzoek die is opgeslagen op het Trust Payments systeem.

Dit veld wordt teruggegeven indien het beschikbaar is.
X2-EN.png parenttransactionreference Alfanumeriek
& koppeltekens 		Max 25

De transactionreference van een eerder verzoek, waarvan belangrijke details zijn overgenomen in het opgevraagde verzoek.

Dit veld wordt teruggegeven indien het beschikbaar is.
X2-EN.png retrievalreferencenumber Alfanumeriek Max 255

Een ISO-term. Deze wordt gebruikt om te verwijzen naar de brontransactie.

Dit veld wordt geretourneerd indien beschikbaar. Dit hangt af van uw wervende bank. Neem contact op met uw bank voor meer informatie.
X2-EN.png securityresponseaddress Numeriek 1

Het resultaat van AVS en beveiligingscodecontroles. Deze bevatten een van de volgende waarden:

  • 0 - Acquirer heeft geen informatie gekregen die nodig is om deze controle uit te voeren.
  • 1 - De aankoper kan de verstrekte informatie niet controleren.
  • 2 - De door de klant verstrekte informatie komt overeen met de gegevens van de kaartuitgever.
  • 4 - De door de klant verstrekte informatie komt NIET overeen met de gegevens van de kaartuitgever.

Klik hier voor meer informatie.

Deze velden worden teruggegeven indien ze beschikbaar zijn.
X2-EN.png securityresponsepostcode Numeriek 1
X2-EN.png securityresponsesecuritycode Numeriek 1
X2-EN.png settledtimestamp Datum tijd JJJJ-MM-DD hh:mm:ss Max. 19

De datum en tijd waarop de opgevraagde transactie is afgewikkeld.

Wordt alleen geretourneerd als de transactie is afgewikkeld.
X2-EN.png stan ISO 8583 Ongedefinieerd

Het STAN (System Trace Audit Number) dat bij de transactie hoort. Dit volgt de ISO 8583-norm.

Dit veld wordt teruggegeven indien het beschikbaar is.
X2-EN.png tid Alfanumeriek Max 255

De terminal ID die wordt gebruikt om de opgevraagde transactie te verwerken. Dit is gekoppeld aan uw handelaarsnummer toen wij uw rekening in onze systemen instelden.

Of dit veld wordt geretourneerd, hangt af van uw acquiring bank. Neem contact op met ons Support Team als u hulp nodig heeft.
X2-EN.png updatereason Alfanumeriek Max 255

De meest recente partij die een bijwerking van de geretourneerde transactie heeft uitgevoerd. Als de transactie nooit is bijgewerkt nadat het eerste verzoek was verzonden, wordt dit veld niet ingevuld. Bekende voorbeelden:

  • De gebruikersnaam van de gebruiker die de update heeft uitgevoerd.
  • "rulemanager" - Transactie werd bijgewerkt door onze Regelbeheer.
  • "securitypolicy" - Transactie is bijgewerkt volgens het beveiligingsbeleid van uw account.
  • "settlement" - Transactie werd bijgewerkt door onze afwikkeling motor.
  • "duplicaat" - Transactie werd beschouwd als een duplicaat en opgeschort door onze duplicaatcontroles.

Dit veld wordt teruggegeven indien het beschikbaar is.
Was dit artikel nuttig?
0 van de 0 vonden dit nuttig
Avatar
Michael Buckley

 

Meer lezen over dit onderwerp