Dit gedeelte gaat ervan uit dat u onze Aan de slag-documentatie voor de door u gekozen integratiemethode al hebt gelezen en begrijpt hoe u een basisverzoek bij ons indient.
Bij ontvangst van ons antwoord moet uw systeem de volgende controles uitvoeren op de geretourneerde waarden (indien van toepassing) om er zeker van te zijn dat het verzoek met succes is verwerkt.
Foutcode
De foutcode (errorcode) is een fundamenteel belangrijk veld omdat het het resultaat van het ingediende verzoek weergeeft. Het wordt teruggestuurd in elk antwoord van Trust Payments.
Als de errorcode "0" is, betekent dit dat het verzoek met succes is verwerkt.
U moet absoluut een proces hebben om de uiteindelijke status van het verwerkte verzoek te controleren, door te kijken naar de waarden van de andere geretourneerde velden.
Indien de errorcode "30000" is, wijst dit op een veldfout.
Als u kijkt naar het errordata veld bekijkt, bevat dit meestal de naam van het veld dat ongeldig werd geacht. U moet de aanvraag opnieuw proberen, en ervoor zorgen dat alle verplichte velden zijn ingediend, en dat alle ingediende veldwaarden voldoen aan onze specificatie.
Als de errorcode "70000" is, betekent dit dat een betaling door uw bank is geweigerd.
Wij raden u aan de klant een foutmelding te geven en hem de mogelijkheid te bieden een andere betaalwijze te proberen.
Als de errorcode "71000" is, betekent dit dat er een zachte afwijzing is teruggestuurd door de kaartuitgever.
Dit is gebeurd omdat de kaartuitgever de aanvraag heeft geweigerd wegens het ontbreken van Strong Customer Authentication (SCA). U moet de transactie opnieuw indienen met de nodige EMV 3DS-authenticatie. Klik hier voor de volledige instructies.
Indien de errorcode "60010", "60034" of "99999" is, is er een probleem geweest met de verwerking van het verzoek en is de definitieve status niet bekend.
Dit kan het gevolg zijn van een communicatieprobleem met een bank of een derde partij. In dergelijke gevallen adviseren wij de klant te informeren over het probleem en contact met u op te nemen om het probleem op te lossen. U moet dan contact opnemen met ons Support Team, met een kopie van het gehele ingediende verzoek en het teruggestuurde antwoord, en wij zullen contact opnemen met de relevante partijen om de status van het verzoek vast te stellen. Zorg er in het belang van de veiligheid voor dat u gevoelige veldwaarden, zoals kaartgegevens, weglaat of maskeert.
Als de foutcode (errorcode) hierboven niet wordt vermeld, raadpleeg dan onze volledige lijst met foutcodes voor hulp. Als u meer hulp nodig heeft, neem dan contact op met ons Support Team.
Status betaling (settlestatus)
Het is belangrijk om de waarde van de status betaling (settlestatus) bij het verwerken van een AUTH of REFUND verzoek, omdat dit aangeeft of er verrekening zal plaatsvinden. Dit zijn de basisbeginselen:
Indien de settlestatus "0", "1" of "10" is, hoeft u geen verdere actie te ondernemen.
De afwikkeling van de transactie is momenteel gepland.
Als de settlestatus "100" is, is de transactie afgewikkeld.
U kunt de transactie niet meer bijwerken.
Indien settlestatus "2" is, is de transactie opgeschort.
Geld wordt niet verrekend zonder uw tussenkomst. Raadpleeg onze afwikkeling documentatie voor meer informatie.
Indien settlestatus "3" is, is de transactie geannuleerd.
De middelen worden niet verrekend en u moet het probleem onderzoeken en het opnieuw proberen. In dit scenario is het nuttig te kijken naar de begeleidende foutcode (errorcode) omdat dit u vaak zal informeren over de reden waarom de transactie is mislukt.
Als u dat nog niet hebt gedaan, raden wij u aan onze afwikkeling documentatie te lezen voor meer informatie over hoe afwikkeling wordt uitgevoerd.
Beveiligingsantwoord
Als de AVS en Beveiligingscodecontroles worden uitgevoerd als onderdeel van het verzoek (zoals het geval is voor de meeste AUTH en ACCOUNTCHECKs), moet u de drie geretourneerde beveiligingsantwoordvelden controleren, die als volgt zijn gedefinieerd:
- securityresponseaddress - Komt de eerste regel van het door de klant ingevoerde factuuradres overeen met het adres op zijn bankrekening?
- securityresponsepostcode - Komt de door de klant ingevoerde Postcode facturatie overeen met die op zijn bankrekening?
- securityresponsesecuritycode - Komt de door de klant ingevoerde beveiligingscode overeen met de waarde op de achterzijde van zijn kaart?
Als de waarde "2" is, heeft de klant de juiste gegevens ingevoerd.
Als alle waarden "2" zijn, is er geen reden om de afwikkeling van de transactie te verhinderen.
Als de waarde "1" is, kon de bank de gegevens van de klant niet controleren.
Dit kan komen doordat de klant een kaart heeft die door een ander land is uitgegeven, en uw bank daarom het adres niet kon controleren. U kunt overwegen om transacties die in deze categorie vallen op te schorten, zodat u een onderzoek kunt instellen voordat u verdergaat met de betaling.
Als de waarde "0" is, zijn de gegevens van de klant niet naar de bank gestuurd.
Dit komt doordat de klant helemaal geen gegevens heeft ingevoerd, of dat deze gegevens niet bij uw verzoek zijn ingediend. U kunt overwegen transacties die in deze categorie vallen op te schorten, zodat u een onderzoek kunt instellen voordat u verder gaat met de betaling.
Als de waarde "4" is, heeft de klant onjuiste gegevens ingevoerd.
Standaard zullen wij transacties opschorten wanneer de door de klant ingevoerde beveiligingscode niet overeenkomt met de waarde op zijn kaart. Afhankelijk van uw voorkeuren kunt u er ook de voorkeur aan geven om transacties op te schorten wanneer de adresgegevens niet overeenkomen (standaard uitgeschakeld).
U kunt verzoeken dat Trust Payments transacties automatisch annuleert wanneer de veiligheidsresponsvelden een bepaalde waarde hebben. Zoals hierboven vermeld, schorten we alle transacties op wanneer de door de klant ingevoerde beveiligingscode niet overeenkomt met de waarde op hun kaart. U kunt de omstandigheden waaronder transacties worden opgeschort, aanpassen aan uw eigen voorkeuren (u kunt dergelijke controles zelfs volledig uitschakelen). Dit doet u door uw Veiligheidsbeleid aan te passen. Om wijzigingen in het beveiligingsbeleid van uw account te bespreken, kunt u contact opnemen met ons Support Team.
Verzoektype
Elk antwoord bevat een requesttypedescription. De waarde van dit veld in het antwoord moet altijd overeenkomen met de waarde in het verzoek.
Als u bijvoorbeeld een "AUTH" verzoek verzendt, zorg er dan voor dat het requesttypedescription teruggestuurd wordt als "AUTH".
Als u requesttypedescription met de waarde "ERROR" ontvangt, is het verzoek misschien niet met succes verwerkt en moet u het onderzoeken.
Live status
Controleer of de teruggestuurde live status waarde "0" is tijdens het testen en "1" bij het verwerken van live betalingen.
Bedrag & Munt
Wanneer u een bedrag en Munt indient, controleert u of in het antwoord dezelfde waarden worden teruggezonden.
Reactie site beveiliging
Als u transacties verwerkt via onze Payment Pages interface, en u hebt geconfigureerd URL-kennisgevingen of redirects die worden geactiveerd bij het voltooien van een transactie, moet u de hash van de sitebeveiliging opnieuw berekenen aan de hand van de geretourneerde velden en controleren of deze overeenkomt met de overeenkomstige hash van Trust Payments. Dit is om ervoor te zorgen dat de geretourneerde inhoud niet door een onbevoegde partij is gewijzigd. Klik hier voor meer informatie.
