Webservices API-gids voor POS-ontwikkelaars Trust Payments

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

Eerste stappen

Uw bibliotheek configureren

U moet eerst uw systeem configureren om veilig met Trust Payments te kunnen communiceren. Om ervoor te zorgen dat uw systeem met succes een basisverzoek kan indienen bij onze gateway, volgt u de onderstaande link en voert u de instructies uit. Zodra u klaar bent, wordt in de aanvullende instructies hieronder 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.

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.
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.
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.
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:

Alleen voor gebruik in de testomgeving.

Kan worden gebruikt zonder speciale toestemmingen en sleuteluitwisseling.

{
  "alias":"{{wsapi_username}}",
  "version":"1.00",
  "request":[{
    "accounttypedescription":"POS",
    "baseamount":"1000",
    "carddataentrymode":"CONTACTLESS",
    "cardholderauthenticationmethod":"NOCVM",
    "currencyiso3a":"GBP",
    "expirydate":"12/2028",
    "iccdata": "9F02060000000010009F03060000000000009F2608A1B2C3D4E5F6A1B28202A1B29F360200018A02A1B29F3403A1B2C39F2701A18410A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B29F3501A19F6E06A1B2C3D4E5F69F1E10313233343536373831323334353637389F1020A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B29110A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2DF3114A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D49F5B14A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D47166A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B7219A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A19F0901019F3303015ABC9F1A0208269505A1B2C3D4E59F5301A15F2A0208269A032212129C01009F370400010001",
    "orderreference":"My_Order_123",
    "pan":"4111111111111111",
    "requesttypedescriptions":"AUTH",
    "sitereference":"{{site_reference}}",
    "terminalcardcapturecapability":"2",
    "terminalcardoutputcapability": "3",
    "terminalid":"12345678",
    "terminalinputcapability":["CONTACTLESS","ICC"],
    "terminaloperatingenvironment":"2",
    "terminaloutputcapability":"B",
    "terminalpinentrycapability":"4"
  }]
}

Voor gebruik in certificerings- en productieomgevingen.

Speciale machtigingen en sleuteluitwisseling vereist.
Neem contact op met ons Integratie Support Team voor meer informatie.

{
  "alias":"{{wsapi_username}}",
  "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":"{{site_reference}}",
    "terminalcardcapturecapability":"2",
    "terminalcardoutputcapability": "3",
    "terminalid":"12345678",
    "terminalinputcapability":["CONTACTLESS","ICC"],
    "terminaloperatingenvironment":"2",
    "terminaloutputcapability":"B",
    "terminalpinentrycapability":"4"
  }]
}

Specificatie veld

Verplicht	Veld	Formaat	Lengte	Beschrijving
Verplicht	accounttypedescription	Alpha	Max 20	Het type rekening dat wordt gebruikt om de transactie te verwerken. Geef "POS" op bij het verwerken van POS-transacties.
Verplicht	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.
Verplicht	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.
Verplicht	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 een mobiel apparaat. (Kan alleen worden verzonden als carddataentrymode is ingesteld op "CONTACTLESS") 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)
Verplicht	currencyiso3a	ISO3A	3	De Munt van de transactie. Bekijk de volledige lijst met beschikbare valuta.
Verplicht	requesttypedescriptions	Alpha	Max 20	U moet "AUTH" invoeren, zoals in het verzoekvoorbeeld.
Verplicht	sitereference	Alfanumeriek & underscore	Max 50	Identificeert uw site op het Trust Payments systeem. Zorg er bij het testen AUTH voor dat u uw test sitereference. Dit zorgt ervoor dat transacties worden verwerkt naar onze testbank en er geen geld wordt overgemaakt. Wanneer u live gaat, moet u uw test sitereference voor je live sitereference. Bekijk de testkaartnummers die je kunt indienen in AUTH tijdens het testen. Als u uw site referentie niet weet, neem dan contact op met ons ondersteuningsteam.
Verplicht	terminalcardcapturecapability	Numeriek	1	De volgende waarden worden ondersteund: 0 - Onbekend. 1 - Geen mogelijkheid om kaarten vast te leggen. 2 - Kan kaarten vastleggen.
Verplicht	terminalcardoutputcapability	Alfanumeriek	1	De volgende waarden worden ondersteund: 0 - Onbekend. 1 - Geen. 2 - Magnetische strip schrijven. 3 - ICC. S - Andere
Verplicht	terminalid	Numeriek	8	Identificatie van POS-terminal.
Verplicht	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.
Verplicht	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.
Verplicht	uitvoercapaciteit terminal	Char	1	De volgende waarden worden ondersteund: U - Onbekend. N - Geen. P - Afdrukken. D - Weergeven. B - Afdrukken en weergave.
Verplicht	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.
Conditioneel	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.
Conditioneel	apparaatencryptedpan	Alfanumeriek	N/A	Gecodeerd PAN nummer. Afhankelijk van de betalingsmethode moet je EEN van de volgende velden invullen: apparaatencryptedpan deviceencryptedtrack2data (Aanbevolen) pan track2data
Conditioneel	deviceencryptedpin	Alfanumeriek	N/A	Gecodeerd PIN-blok. Vereist bij het faciliteren van online PIN-functionaliteit.
Conditioneel	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
Conditioneel	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). Dit is verplicht als de velden `deviceencryptedpan` of `deviceencryptedtrack2data` worden ingediend.
Conditioneel	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. Dit is verplicht als de velden `deviceencryptedpan` of `deviceencryptedtrack2data` worden ingediend.
Conditioneel	expirydate	Datum MM/JJJJ	Max. 7	De op de kaart gedrukte vervaldatum. Vereist bij het indienen deviceencryptedpan of pan.
Conditioneel	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.
Conditioneel	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
Conditioneel	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
Optioneel	billingpostcode	Alfanumeriek	Max 25	De Postcode facturatie of postcode. Dit moet een geldige postcode zijn voor de billingcountryiso2a ingediend.
Optioneel	billingpremise	Alfanumeriek, inclusief symbolen	Max 25	Het huisnummer of de eerste regel van het factuuradres van de klant.
Optioneel	billingstreet	Alfanumeriek, inclusief symbolen	Max 127	De straat die is ingevoerd voor het factuuradres van de klant.
Optioneel	kasbasisbedrag	Numeriek	Max 13	Het cashbackbedrag aangevraagd door de klant.
Optioneel	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: + - _ . @ ( )
Optioneel	merchantemail	E-mail	Max 255	Het e-mailadres van de handelaar. Maximale lengte van 255 (maximaal 64 tekens voor het "@"-symbool).
Optioneel	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).
Optioneel	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 nog in afwikkeling is). 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.
Optioneel	parenttransactionreference	Alfanumeriek & koppeltekens	Max 25	Hiermee kunt u de transactionreference van een vorig verzoek. Belangrijke details zijn overgenomen van dit verzoek.
Optioneel	paymenttypedescription	Alpha	Max 20	Betalingsmethode (bijv. "VISA" of "MASTERCARD").
Optioneel	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.
Optioneel	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". Meer informatie over het afwikkeling .

AUTH Reactie

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

{
  "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
Geretourneerd	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.
Geretourneerd	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.
Geretourneerd	currencyiso3a	ISO3A	3	De Munt van de transactie. Bekijk de volledige lijst met beschikbare valuta.
Geretourneerd	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. Volledige lijst van errorcode en berichtwaarden.
Geretourneerd	errormessage	Alfanumeriek	Max 255	Dit geeft een korte uitleg over de oorzaak van de fout. Voor succesvolle transacties wordt dit geretourneerd als "Ok". Volledige lijst van errorcode en berichtwaarden.
Geretourneerd	uitgever	Alfanumeriek	Max 255	De uitgever van de kaart van de klant.
Geretourneerd	issuercountryiso2a	ISO2A	2	Het land voor de uitgever van de kaart van de klant. Dit zal in ISO2A formaat zijn. Bekijk de volledige lijst met landcodes.
Geretourneerd	livestatus	Numeriek	1	0 - Transactie verwerkt met een testrekening. 1 - Transactie verwerkt met een live rekening.
Geretourneerd	maskedpan	Alfanumeriek inclusief "#"	12-19	De maskedpan veld vertegenwoordigt het kaartnummer van de klant. De waarde van maskedpan wordt in het antwoord gemaskeerd. Het grootste deel van het nummer wordt opzettelijk verborgen door “#”-tekens, bijvoorbeeld 411111######0211.
Geretourneerd	merchantnumber	Alfanumeriek	Max 32	Het handelaarsnummer dat werd gebruikt om de transactie te verwerken. Verstrekt door de wervende bank.
Geretourneerd	operatorname	Alfanumeriek	Max 255	De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt.
Geretourneerd	paymenttypedescription	Alpha	Max 20	Betalingsmethode (bijv. "VISA" of "MASTERCARD").
Geretourneerd	requesttypedescription	Alpha	Max 20	"AUTH" wordt in het antwoord teruggezonden.
Geretourneerd	securityresponseaddress	Numeriek	1	Het resultaat van AVS en beveiligingscodecontroles. Meer informatie over AVS en beveiligingscodecontroles.
Geretourneerd	securityresponsepostcode	Numeriek	1	Het resultaat van AVS en beveiligingscodecontroles. Meer informatie over AVS en beveiligingscodecontroles.
Geretourneerd	securityresponsesecuritycode	Numeriek	1	Het resultaat van AVS en beveiligingscodecontroles. Meer informatie over AVS en beveiligingscodecontroles.
Geretourneerd	settleduedate	Datum JJJJ-MM-DD	10	De datum waarop de transactie zal worden afgewikkeld.
Geretourneerd	settlestatus	Numeriek	Max. 3	Een numerieke waarde die wordt gebruikt om de voortgang van afwikkeling met betrekking tot deze transactie aan te geven. Volledige lijst van settlestatus waarden.
Geretourneerd	transactionreference	Alfanumeriek, inclusief koppeltekens	Max 25	Een unieke referentie voor de transactie toegewezen door Trust Payments. U hebt deze referentie nodig om een terugbetaling of de transactie bij te werken.
Geretourneerd	transactionstartedtimestamp	Datum tijd JJJJ-MM-DD hh:mm:ss	19	Het tijdstip waarop de transactie werd verwerkt.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	errordata	Alfanumeriek	Max 255	Aanvullende informatie om te helpen bij het oplossen van de fout. Wordt alleen geretourneerd als er een fout is opgetreden.
Conditioneel	iccdatarespons	EMV tag formaat	Max. 4	ICC-gegevensantwoord teruggestuurd van de kaartuitgever van de klant. Alleen teruggestuurd voor ICC, CONTACTLOOS, ICCUNRELIABLE.
Conditioneel	merchantcategorycode	Alfanumeriek	Max 255	Dit zijn gegevens die verband houden met de account die wordt gebruikt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantcity	Alfanumeriek	Max 127	Dit zijn gegevens die verband houden met de account die wordt gebruikt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantcountryiso2a	ISO2A	2	Dit zijn gegevens die verband houden met de account die wordt gebruikt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantname	Alfanumeriek	Max 255	Dit zijn gegevens die verband houden met de account die wordt gebruikt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantstatecode	Alfanumeriek	Max 127	Dit zijn gegevens die verband houden met de account die wordt gebruikt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantzipcode	Alfanumeriek	Max 10	Dit zijn gegevens die verband houden met de account die wordt gebruikt om de transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	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 nog in afwikkeling is). Dit veld wordt teruggestuurd indien het in het verzoek is ingediend.
Conditioneel	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.
Conditioneel	stan	ISO 8583	Ongedefinieerd	Het STAN System Trace Audit Number) dat aan de transactie is gekoppeld. Dit volgt de ISO 8583-norm. Dit veld wordt teruggegeven indien het beschikbaar is.
Conditioneel	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, is afhankelijk van uw acquirerende bank. Neem contact op met ons ondersteuningsteam 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.

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

Verwerking REFUND

REFUND Aanvraag

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

{
  "alias":"webserv3",
  "version":"1.00",
  "request":[{
    "accounttypedescription":"POS",
    "baseamount":"1000",
    "carddataentrymode":"CONTACTLESS",
    "cardholderauthenticationmethod":"ONLINEPIN",
    "currencyiso3a":"GBP",
    "deviceencryptedpan":"5F9ADEFA3CE08AB0ACD5943FB764E155B29D55A1B98F0C70",
    "deviceencryptedpin":"C9A8FEB60C5B26CD",
    "deviceencryptionkeytype":"AES-256",
    "deviceksn":"1234567822334A0000000001",
    "expirydate":"12/2028",
    "iccdata": "9F02060000000010009F03060000000000009F2608A1B2C3D4E5F6A1B28202A1B29F360200018A02A1B29F3403A1B2C39F2701A18410A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B29F3501A19F6E06A1B2C3D4E5F69F1E10313233343536373831323334353637389F1020A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B29110A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2DF3114A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D49F5B14A1B2C3D4E5F6A1B2A1B2C3D4E5F6A1B2A1B2C3D47166A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1BA1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B7219A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5F6A19F0901019F3303015ABC9F1A0208269505A1B2C3D4E59F5301A15F2A0208269A032212129C01009F370400010001",
    "orderreference":"My_Order_123",
    "requesttypedescriptions":"REFUND",
    "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
Verplicht	requesttypedescriptions	Alpha	Max 20	De vereiste Verzoektype is "REFUND".
Verplicht	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 REFUND site referentie , moet dezelfde zijn als de site referentie voor de verwerking van het bovenliggende AUTH verzoek.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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 een mobiel apparaat. (Kan alleen worden verzonden als carddataentrymode is ingesteld op "CONTACTLESS") 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.
Conditioneel	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.
Conditioneel	currencyiso3a	ISO3A	3	De Munt van de restitutie. Bekijk de volledige lijst met beschikbare valuta. Dit veld is vereist, tenzij de parenttransactionreference is ingediend om gegevens te erven van de transactie die in plaats daarvan wordt terugbetaald.
Conditioneel	apparaatencryptedpan	Alfanumeriek	N/A	Gecodeerd PAN nummer. Als parenttransactionreference opgegeven, worden de gegevens overgenomen van de transactie waarvoor de terugbetaling plaatsvindt. Als dit niet wordt opgegeven, moet u in plaats daarvan ÉÉN van de volgende velden opgeven: apparaatencryptedpan deviceencryptedtrack2data (Aanbevolen) pan track2data
Conditioneel	deviceencryptedpin	Alfanumeriek	N/A	Gecodeerd PIN-blok. Vereist bij het faciliteren van online PIN-functionaliteit.
Conditioneel	apparaatencryptedtrack2data	Alfanumeriek	N/A	Versleutelde track 2-gegevens. Als parenttransactionreference opgegeven, worden de gegevens overgenomen van de transactie waarvoor de terugbetaling plaatsvindt. Als dit niet wordt opgegeven, moet u in plaats daarvan ÉÉN van de volgende velden opgeven: apparaatencryptedpan deviceencryptedtrack2data (Aanbevolen) pan track2data
Conditioneel	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). Dit is verplicht als de velden `deviceencryptedpan` of `deviceencryptedtrack2data` worden ingediend.
Conditioneel	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. Dit is verplicht als de velden `deviceencryptedpan` of `deviceencryptedtrack2data` worden ingediend.
Conditioneel	expirydate	Datum MM/JJJJ	Max. 7	Dit veld wordt gebruikt om een restitutie met een bijgewerkte vervaldatum te verwerken. Vereist bij het indienen deviceencryptedpan.
Conditioneel	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 doorgegeven om gegevens over te nemen van de transactie waarvoor de terugbetaling plaatsvindt.
Conditioneel	pan	Numeriek	12-19	Dit is het lange nummer dat op de voorzijde van de kaart van de klant is gedrukt. Als parenttransactionreference opgegeven, worden de gegevens overgenomen van de transactie waarvoor de terugbetaling plaatsvindt. Als dit niet wordt opgegeven, moet u in plaats daarvan ÉÉN van de volgende velden opgeven: apparaatencryptedpan deviceencryptedtrack2data (Aanbevolen) pan track2data
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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 opgegeven, worden de gegevens overgenomen van de transactie waarvoor de terugbetaling plaatsvindt. Als dit niet wordt opgegeven, moet u in plaats daarvan ÉÉN van de volgende velden opgeven: apparaatencryptedpan deviceencryptedtrack2data (Aanbevolen) pan track2data
Optioneel	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: + - _ . @ ( )
Optioneel	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.
Optioneel	paymenttypedescription	Alpha	Max 20	Betalingsmethode (bijv. "VISA" of "MASTERCARD").

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
Geretourneerd	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.
Geretourneerd	baseamount	Numeriek	Max 13	Het bedrag van de terugbetaling in basiseenheden, zonder komma's of decimalen, dus £10 wordt weergegeven als 1000.
Geretourneerd	currencyiso3a	ISO3A	Max. 3	De Munt van de restitutie. Bekijk de volledige lijst met beschikbare valuta.
Geretourneerd	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. Volledige lijst van errorcode en berichtwaarden.
Geretourneerd	errormessage	Alfanumeriek	Max 255	Dit geeft een korte uitleg over de oorzaak van de fout. Voor succesvolle restituties wordt dit geretourneerd als "Ok". Volledige lijst van errorcode en berichtwaarden.
Geretourneerd	uitgever	Alfanumeriek	Max 255	De uitgever van de kaart van de klant.
Geretourneerd	issuercountryiso2a	ISO2A	2	Het land voor de uitgever van de kaart van de klant. Dit zal in ISO2A formaat zijn. Bekijk de volledige lijst met landcodes.
Geretourneerd	livestatus	Numeriek	1	0 - Restitutie verwerkt met een testaccount. 1 - Restitutie verwerkt met een live account.
Geretourneerd	maskedpan	Alfanumeriek inclusief "#"	12-19	De maskedpan veld vertegenwoordigt het kaartnummer van de klant. De waarde van maskedpan wordt in het antwoord gemaskeerd. Het grootste deel van het nummer wordt opzettelijk verborgen door “#”-tekens, bijvoorbeeld 411111######0211.
Geretourneerd	merchantnumber	Alfanumeriek	Max 32	Het handelaarsnummer dat is gebruikt om de terugbetaling te verwerken. Verstrekt door de acquiring bank.
Geretourneerd	operatorname	Alfanumeriek	Max 255	De waarde van dit veld bevat de naam van de gebruiker die de terugbetaling heeft verwerkt.
Geretourneerd	paymenttypedescription	Alpha	Max 20	Betalingsmethode (bijv. "VISA" of "MASTERCARD").
Geretourneerd	requesttypedescription	Alpha	Max 20	"REFUND" wordt geretourneerd in het antwoord.
Geretourneerd	securityresponseaddress	Numeriek	1	Het resultaat van AVS en beveiligingscodecontroles. Meer informatie over AVS en beveiligingscodecontroles.
Geretourneerd	securityresponsepostcode	Numeriek	1	Het resultaat van AVS en beveiligingscodecontroles. Meer informatie over AVS en beveiligingscodecontroles.
Geretourneerd	securityresponsesecuritycode	Numeriek	1	Het resultaat van AVS en beveiligingscodecontroles. Meer informatie over AVS en beveiligingscodecontroles.
Geretourneerd	settleduedate	Datum JJJJ-MM-DD	10	De datum waarop de restitutie wordt verrekend.
Geretourneerd	settlestatus	Numeriek	Max. 3	Een numerieke waarde die wordt gebruikt om de voortgang van afwikkeling met betrekking tot deze restitutie aan te geven. Volledige lijst van settlestatus waarden.
Geretourneerd	transactionreference	Alfanumeriek, inclusief koppeltekens	Max 25	Een unieke referentie voor de terugbetaling die door Trust Payments is toegekend. U hebt deze referentie nodig om de terugbetaling bij te werken.
Geretourneerd	transactionstartedtimestamp	Datum tijd JJJJ-MM-DD hh:mm:ss	Max. 19	Het tijdstip waarop de restitutie is verwerkt.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	kasbasisbedrag	Numeriek	Max 13	Het cashbackbedrag aangevraagd door de klant. Dit veld wordt teruggegeven indien het beschikbaar is.
Conditioneel	errordata	Alfanumeriek	Max 255	Aanvullende informatie om te helpen bij het oplossen van de fout. Wordt alleen geretourneerd als er een fout is opgetreden.
Conditioneel	merchantcategorycode	Alfanumeriek	Max 255	Dit zijn de gegevens van de rekening die wordt gebruikt voor de terugbetaling. Als u deze velden wilt wijzigen, contact op met ons supportteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantcity	Alfanumeriek	Max 127	Dit zijn de gegevens van de rekening die wordt gebruikt voor de terugbetaling. Als u deze velden wilt wijzigen, contact op met ons supportteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantcountryiso2a	ISO2A	Max. 2	Dit zijn de gegevens van de rekening die wordt gebruikt voor de terugbetaling. Als u deze velden wilt wijzigen, contact op met ons supportteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantname	Alfanumeriek	Max 255	Dit zijn de gegevens van de rekening die wordt gebruikt voor de terugbetaling. Als u deze velden wilt wijzigen, contact op met ons supportteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantstatecode	Alfanumeriek	Max 127	Dit zijn de gegevens van de rekening die wordt gebruikt voor de terugbetaling. Als u deze velden wilt wijzigen, contact op met ons supportteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantzipcode	Alfanumeriek	Max 10	Dit zijn de gegevens van de rekening die wordt gebruikt voor de terugbetaling. Als u deze velden wilt wijzigen, contact op met ons supportteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	orderreference	Alfanumeriek, inclusief symbolen	Max 255	Uw unieke bestelreferentie die in het Trust Payments systeem kan worden opgeslagen. Opmerking: Dit kan later worden bijgewerkt (alleen als de terugbetaling nog in afwikkeling is). Dit veld wordt teruggestuurd indien het in het verzoek is ingediend.
Conditioneel	parenttransactionreference	Alfanumeriek, inclusief koppeltekens	Max 25	De transactionreference van de transactie waarvoor de terugbetaling plaatsvindt, waarvan de belangrijkste gegevens zijn overgenomen. Dit veld wordt teruggestuurd indien het in het verzoek is ingediend.
Conditioneel	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.
Conditioneel	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, is afhankelijk van uw acquirerende bank. Neem contact op met ons ondersteuningsteam 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.

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.
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:

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescriptions":["TRANSACTIONUPDATE"],
    "filter":{
      "sitereference":[{"value":"test_site12345"}],
      "transactionreference":[{"value":"1-2-3"}]
    },
    "updates":{"issuerscriptresults":"8A023030A1"}
  }]
}

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescriptions":["TRANSACTIONUPDATE"],
    "filter":{
      "sitereference":[{"value":"test_site12345"}],
      "transactionreference":[{"value":"1-2-3"}]
    },
    "updates":{"settlestatus":"2"}
  }]
}

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescriptions":["TRANSACTIONUPDATE"],
    "filter":{
      "sitereference":[{"value":"test_site12345"}],
      "transactionreference":[{"value":"1-2-3"}]
    },
    "updates":{"settlestatus":"1"}
  }]
}

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescriptions":["TRANSACTIONUPDATE"],
    "filter":{
      "sitereference":[{"value":"test_site12345"}],
      "transactionreference":[{"value":"1-2-3"}]
    },
    "updates":{"settlestatus":"3"}
  }]
}

{
  "alias":"webservices@example.com",
  "version":"1.00",
  "request":[{
    "requesttypedescriptions":["TRANSACTIONUPDATE"],
    "filter":{
      "sitereference":[{"value":"test_site12345"}],
      "transactionreference":[{"value":"1-2-3"}]
    },
    "updates":{"settlebaseamount":"100"}
  }]
}

Filters veldspecificatie

Verplicht	Veld	Formaat	Lengte	Beschrijving
Verplicht	sitereference	Alfanumeriek inclusief underscore	Max 50	De unieke referentie voor de Trust Payments site die verband houdt met de transactie die u wilt bijwerken.
Verplicht	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
Optioneel	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 opdrachten 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.
Optioneel	orderreference	Alfanumeriek, inclusief symbolen	Max 25	Update de unieke orderreferentie die kan worden opgeslagen op het Trust Payments systeem.
Optioneel	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.
Optioneel	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).
Optioneel	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.

{
  "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
Geretourneerd	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. Volledige lijst van errorcode en berichtwaarden.
Geretourneerd	errormessage	Alfanumeriek	Max 255	Dit geeft een korte uitleg over de oorzaak van de fout. Voor succesvolle transacties wordt dit geretourneerd als "Ok". Volledige lijst van errorcode en berichtwaarden.
Geretourneerd	requesttypedescription	Alpha	Max 20	"TRANSACTIONUPDATE" wordt teruggestuurd in het antwoord.
Geretourneerd	transactionstartedtimestamp	Datum tijd JJJJ-MM-DD hh:mm:ss	19	Het tijdstip waarop de update is verwerkt.
Conditioneel	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.

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.
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.

{
  "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
Conditioneel	accounttypedescription	Alpha	Max 20	Het type rekening dat wordt gebruikt om het verzoek te verwerken. Geef "POS" op om POS-transacties te filteren.
Conditioneel	billingpostcode	Alfanumeriek, inclusief symbolen	Max 25	De Postcode facturatie of postcode. Dit moet een geldige postcode zijn voor de billingcountryiso2a ingediend.
Conditioneel	billingpremise	Alfanumeriek, inclusief symbolen	Max 20	Het nummer of de naam van het gebouw van het factuuradres van de klant.
Conditioneel	billingstreet	Alfanumeriek, inclusief symbolen	Max 20	De straatnaam van het factuuradres van de klant.
Conditioneel	currencyiso3a	ISO3A	3	De transactie Munt. Bekijk de volledige lijst met beschikbare valuta.
Conditioneel	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)
Conditioneel	orderreference	Alfanumeriek, inclusief symbolen	Max 25	Uniek referentienummer dat u opgeeft voor het verzoek.
Conditioneel	pan	Numeriek	12-19	Dit is het kaartnummer dat op de voorkant van de kaart van de klant staat.
Conditioneel	parenttransactionreference	Alfanumeriek, inclusief koppeltekens	Max 25	Unieke referentie van het bovengeschikte verzoek.
Conditioneel	paymenttypedescription	Alpha	Max 20	Het type kaart van de klant (bijv. "VISA" of "MASTERCARD").
Conditioneel	requesttypedescription	Alpha	Max 20	De Verzoektype die bij de transactie hoort. Bijvoorbeeld "AUTH" of "REFUND". Volledige lijst met verzoektypen weergeven.
Conditioneel	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)
Conditioneel	transactionreference	Alfanumeriek, inclusief koppeltekens	Max 25	De unieke referentie in verband met de transactie, toegewezen door Trust Payments.
Optioneel	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"):

{"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 Foutcodes die in het antwoord worden geretourneerd:

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.
Bekijk de volledige lijst met foutcodes die door Trust Payments worden gebruikt.

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
Geretourneerd	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.
Geretourneerd	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.
Geretourneerd	currencyiso3a	ISO3A	3	De Munt van de opgevraagde transactie. Bekijk de volledige lijst met beschikbare valuta.
Geretourneerd	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. Volledige lijst van errorcode en berichtwaarden.
Geretourneerd	errormessage	Alfanumeriek	Max 255	Dit geeft een korte uitleg over de oorzaak van de fout. Voor succesvolle transacties wordt dit geretourneerd als "Ok". Volledige lijst van errorcode en berichtwaarden.
Geretourneerd	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.
Geretourneerd	livestatus	Numeriek	1	0 - De opgevraagde transactie is verwerkt met een testrekening. 1 - De opgevraagde transactie is verwerkt met een live-rekening.
Geretourneerd	maskedpan	Alfanumeriek inclusief "#"	12-19	De maskedpan veld vertegenwoordigt het kaartnummer van de klant. De waarde van maskedpan wordt in het antwoord gemaskeerd. Het grootste deel van het nummer wordt opzettelijk verborgen door “#”-tekens, bijvoorbeeld 411111######0211.
Geretourneerd	operatorname	Alfanumeriek	Max 255	De waarde van dit veld bevat de naam van de gebruiker die het verzoek heeft verwerkt.
Geretourneerd	paymenttypedescription	Alpha	Max 20	Betalingsmethode (bijv. "VISA" of "MASTERCARD").
Geretourneerd	requesttypedescription	Alpha	Max 20	Het type verzoek dat in de record wordt teruggestuurd.
Geretourneerd	settlebaseamount	Numeriek	Max 13	De waarde van het af te rekenen bedrag. Het afgerekende bedrag kan via een TRANSACTIONUPDATE .
Geretourneerd	settleduedate	Datum JJJJ-MM-DD	Max 10	De datum waarop de opgevraagde transactie zal worden afgewikkeld.
Geretourneerd	settlestatus	Numeriek	Max. 3	Een numerieke waarde die wordt gebruikt om de voortgang van afwikkeling met betrekking tot de opgevraagde transactie aan te geven. Volledige lijst van settlestatus waarden.
Geretourneerd	sitereference	Alfanumeriek & underscore	Max 50	De sitereferentie via welke het opgevraagde verzoek is verwerkt.
Geretourneerd	terminalid	Alfanumeriek	8	Identificatie van POS-terminal.
Geretourneerd	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 of de transactie bij te werken.
Geretourneerd	transactionstartedtimestamp	Datum tijd JJJJ-MM-DD hh:mm:ss	Max. 19	Het tijdstip waarop de opgevraagde transactie werd verwerkt.
Conditioneel	acquirerresponsecode	Alfanumeriek	Max 255	Gebruikt door uw verwerver om het resultaat van het opgevraagde verzoek aan te geven. Of deze velden worden geretourneerd, is afhankelijk van uw acquirerende bank. Neem neem contact op met ons ondersteuningsteam als u hulp nodig heeft.
Conditioneel	acquirerresponsemessage	Alfanumeriek	Max 255
Conditioneel	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.
Conditioneel	billingpostcode	Alfanumeriek	Max 25	De postcode die is ingevoerd voor het factuuradres van de klant. Dit veld wordt teruggegeven indien het beschikbaar is.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	errordata	Alfanumeriek	Max 255	Aanvullende informatie om te helpen bij het oplossen van de fout. Wordt alleen geretourneerd als er een fout is opgetreden.
Conditioneel	expirydate	Datum MM/JJJJ	Max. 7	De op de kaart gedrukte vervaldatum. Alleen teruggestuurd voor kaarttransacties.
Conditioneel	fraudrating	Numeriek	Max. 2	Dit veld heeft betrekking op onze interne fraudecontroles, zoals beschreven 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. Alleen teruggestuurd voor kaarttransacties.
Conditioneel	uitgever	Alfanumeriek	Max 255	De uitgever van de kaart van de klant. Alleen teruggestuurd voor kaarttransacties.
Conditioneel	issuercountryiso2a	ISO2A	2	Het land voor de uitgever van de kaart van de klant. Dit zal in ISO2A formaat zijn. Bekijk de volledige lijst met landcodes. Alleen teruggestuurd voor kaarttransacties.
Conditioneel	merchantcategorycode	Alfanumeriek	Max 255	Dit zijn gegevens die verband houden met de rekening die is gebruikt om de opgevraagde transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantcity	Alfanumeriek	Max 127	Dit zijn gegevens die verband houden met de rekening die is gebruikt om de opgevraagde transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantcountryiso2a	ISO2A	2	Dit zijn gegevens die verband houden met de rekening die is gebruikt om de opgevraagde transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantname	Alfanumeriek	Max 255	Dit zijn gegevens die verband houden met de rekening die is gebruikt om de opgevraagde transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantstatecode	Alfanumeriek	Max 127	Dit zijn gegevens die verband houden met de rekening die is gebruikt om de opgevraagde transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	merchantzipcode	Alfanumeriek	Max 10	Dit zijn gegevens die verband houden met de rekening die is gebruikt om de opgevraagde transactie te verwerken. Om deze velden te wijzigen, kunt u contact op met ons ondersteuningsteam. De teruggegeven waarden zijn afhankelijk van uw accountconfiguratie.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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.
Conditioneel	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. Meer informatie over AVS en beveiligingscodecontroles. Deze velden worden teruggegeven indien ze beschikbaar zijn.
Conditioneel	securityresponsepostcode	Numeriek	1
Conditioneel	securityresponsesecuritycode	Numeriek	1
Conditioneel	settledtimestamp	Datum tijd JJJJ-MM-DD hh:mm:ss	Max. 19	De datum en het tijdstip waarop de gevraagde transactie werd afgewikkeld. Wordt alleen geretourneerd als de transactie is afgewikkeld.
Conditioneel	stan	ISO 8583	Ongedefinieerd	Het STAN System Trace Audit Number) dat aan de transactie is gekoppeld. Dit volgt de ISO 8583-norm. Dit veld wordt teruggegeven indien het beschikbaar is.
Conditioneel	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, is afhankelijk van uw acquirerende bank. Neem contact op met ons ondersteuningsteam als u hulp nodig heeft.
Conditioneel	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" - De transactie is bijgewerkt door onze Regelbeheer. "securitypolicy" - De transactie is bijgewerkt volgens het beveiligingsbeleid voor uw account. "settle" - De transactie is bijgewerkt door onze afwikkeling . "duplicaat" - De transactie werd als een duplicaat aangemerkt en door onze controle op duplicaten. Dit veld wordt teruggegeven indien het beschikbaar is.