PreAuth - Trust Payments

De PreAuth transactie verwerkt een standaard autorisatie transactie om geld vast te houden van de kaart van de klant. Volg dit op met een Capture om de transactie te voltooien.

Eindpunt : /preauth

De topuptoken die in het antwoord wordt geretourneerd, kan worden gebruikt om het geautoriseerde bedrag op een later tijdstip te verhogen. Geef de waarde op in het veld topuptoken in een nieuw PreAuth-verzoek en de nieuwe amount gespecificeerd wordt toegevoegd aan het totale vooraf geautoriseerde bedrag. Deze functionaliteit is momenteel alleen beperkt tot sommige Visa/Mastercard emittenten. Als de emittent geen opwaarderingen ondersteunt, wordt de transactie geweigerd.

PreAuth verzoek

{
"amount":"60.00",
"refid":"89045432",
"siteid":"123456",
"terminalserialnumber":"6789654678",
"txndate":"2023-02-01:16:13:20",
"type":"preauth",
"wait":"y"
}

Specificatie van het verzoekveld

	Veld	Formaat	Beschrijving
Verplicht	amount	String bijv. 20,00	Het bedrag dat vooraf moet worden geautoriseerd voor de transactie in hoofdeenheden (bijv. £20 zou worden ingediend als 20,00). Het geld wordt niet van de kaart van de klant afgeschreven totdat een Capture-aanvraag is verwerkt.
Verplicht	refid	String (min lengte: 1) bijv. 1234567890	De unieke identificatiecode voor de transactie die wordt ingediend. (De ingediende waarde moet uniek zijn binnen het bereik van je eigen transacties)
Verplicht	siteid	String (min lengte: 1) bijv. 1234	Unieke identificatiecode verstrekt door Trust Payments.
Verplicht	terminalserialnumber	String (min lengte: 1) bijv. 1234567890	De unieke terminal identifier voor de PIN Entry Device (PED) die de kaartgegevens levert. Dit is het serienummer van de PED.
Verplicht	txndate	String bijv. 2020-03-01:10:20:05	Unieke tijdstempel voor de transactie.
Verplicht	type	String	Je moet "preauth" indienen, zoals in het aanvraagvoorbeeld.
Verplicht	wait	String	De volgende twee waarden kunnen worden ingediend: y - TRU Link wacht op de terminal voordat het een antwoord terugstuurt, meestal met resultcode van "Approved" of "Declined". n - TRU Link stuurt onmiddellijk een antwoord terug met resultcode van "Pending". De status van de transactie kan op een later tijdstip worden gecontroleerd door een statusverzoek in te dienen via TRU Link.
Optioneel	topuptoken	String bijv. 1234567890	Een token dat de vorige autorisatie aan deze verbindt. Hiermee kunnen de gereserveerde fondsen worden verhoogd.

PreAuth Antwoord

{
"amount":"60.00",
"authcode":"abc1234",
"cardtype":"Visa",
"expiry":"2023-02-08:04:13:20",
"finalamount":"60.00",
"last4":"0026",
"merchantreceipt":"Sample output",
"receipt":"Sample output",
"refid":"123456789876543212345",
"resultcode":"Approved",
"siteid":"123456",
"terminalserialnumber":"6789654678",
"topuptoken":"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
}

Specificatie van antwoordvelden

	Veld	Formaat	Beschrijving
Geretourneerd	amount	String bijv. 20,00	Het oorspronkelijke volledige bedrag dat is geautoriseerd voor de transactie in hoofdeenheden (bijv. £20 wordt teruggestuurd als 20,00). Opmerking: De amount kan verschillen van die in de aanvraag als gevolg van wijzigingen door de klant tijdens het afrekenen (bv. toevoeging van een fooi).
Geretourneerd	refid	String bijv. 1234567890	De unieke identifier die is toegewezen aan de ingediende transactie.
Geretourneerd	resultcode	String bijv. Goedgekeurd	Het resultaat van de transactie van de verwerver. Mogelijke waarden zijn: Approved Cancelled Connection Timeout Declined Error Pending Terminal Busy
Geretourneerd	siteid	String bijv. 1234	Unieke code ter identificatie van de Trust Payments site die wordt gebruikt om het verzoek te verwerken.
Geretourneerd	terminalserialnumber	String bijv. 1234567890	De unieke terminal identifier voor de PIN Entry Device (PED) die de kaartgegevens levert.
Conditioneel	authcode	String bijv. 1234567890	De autorisatie code van de transactie. Wordt alleen geretourneerd als de transactie is geautoriseerd.
Conditioneel	cardtype	String bijv. Visa	Bevat de voor deze transactie gebruikte kaartsoort (bijv. "VISA"). Teruggestuurd indien beschikbaar.
Conditioneel	error	String bijv. Ongeldig bedrag	Het veld geeft details van een fout als een verzoek niet succesvol is verwerkt. Info over foutafhandeling. Wordt alleen geretourneerd als er een fout is opgetreden.
Conditioneel	errorcode	Geheel getal bijv. 1006	Deze code helpt je de fout te identificeren als een verzoek niet succesvol is verwerkt. Info over foutafhandeling. Wordt alleen geretourneerd als er een fout is opgetreden.
Conditioneel	expiry	String bijv. 2023-02-08:04:13:20	De vervaldatum en -tijd voor de autorisatie. Na deze tijd is het niet mogelijk om te herladen of vast te leggen. Teruggestuurd indien beschikbaar.
Conditioneel	finalamount	String bijv. 20,00	Het eindbedrag dat is geautoriseerd voor de transactie in hoofdeenheden (bijv. £20 wordt teruggestuurd als 20,00). Opmerking: De finalamount omvat alle wijzigingen die de klant tijdens het afrekenen heeft aangebracht (bv. toevoeging van een fooi). Wordt geretourneerd als het finalamount afwijkt van het oorspronkelijke bedrag.
Conditioneel	last4	String bijv. 6789	De laatste 4 cijfers van de debet-/creditcard van de klant die is gebruikt om de transactie mogelijk te maken. Teruggestuurd indien beschikbaar.
Conditioneel	merchantreceipt	String bijv. Ontvangstbewijs verkoper	Bevat kassabongegevens die kunnen worden gebruikt voor het afdrukken op de ePOS. Teruggestuurd indien beschikbaar.
Conditioneel	message	String bijv. Bericht	Antwoordbericht van de uitgever wanneer de kaart wordt geweigerd. Wordt alleen geretourneerd in een afwijzingsantwoord.
Conditioneel	receipt	String bijv. Ontvangstbewijs klant	Bevat bongegevens van de kaarthouder die kunnen worden gebruikt voor het afdrukken op de ePOS. Teruggestuurd indien beschikbaar.
Conditioneel	topuptoken	String bijv. 1234567890	Een token dat de vorige autorisatie aan deze verbindt. Hiermee kunnen de gereserveerde fondsen worden verhoogd. Teruggestuurd indien beschikbaar.