Gebruik deze transactie om een eerder geautoriseerde transactie vast te leggen.
Eindpunt : /capture
Vereisten
- De vastlegging kan tot 100% van de oorspronkelijke vergunning bedragen.
- De vastlegging kan maar één keer worden verwerkt voor een PreAuth.
- De transactie kan worden vastgelegd op een andere terminal dan de oorspronkelijke transactie. Indien geen terminalserialnumber wordt ontvangen, zal het systeem de terminalserialnumber gebruikt in de PreAuth.
Aanvraag vastleggen
{
"amount":"40.00",
"refid":"123456789876543212345",
"siteid":"123456",
"txndate":"2023-02-01:16:13:20",
"type":"capture"
}
Specificatie van het verzoekveld
| Veld | Formaat | Beschrijving | |
| Verplicht | amount | String bijv. 20,00 |
Het bedrag dat moet worden vastgelegd in hoofdeenheden (bijv. £20 wordt opgegeven als 20,00). Het ingevoerde bedrag kan niet hoger zijn dan de oorspronkelijke PreAuth. Resterende gereserveerde bedragen worden uiteindelijk teruggegeven aan de klant, tenzij ze worden vastgelegd. |
| 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 | txndate | String bijv. 2020-03-01:10:20:05 |
Unieke tijdstempel voor de transactie. |
| Verplicht | type | String |
Je moet "capture" (vastleggen) indienen, zoals te zien is in het aanvraagvoorbeeld. |
| Optioneel | 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. |
Reactie vastleggen
{
"finalamount":"40.00",
"merchantreceipt":"Sample output",
"receipt":"Sample output",
"refid":"123456789876543212345",
"resultcode":"Approved",
"siteid":"123456"
}
Specificatie van antwoordvelden
| Veld | Formaat | Beschrijving | |
| 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:
|
| Geretourneerd | siteid | String bijv. 1234 |
Unieke code ter identificatie van de Trust Payments site die wordt gebruikt om het verzoek te verwerken. |
| 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 | 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 | merchantreceipt | String bijv. Ontvangstbewijs verkoper |
Bevat kassabongegevens die kunnen worden gebruikt voor het afdrukken op de ePOS. Teruggestuurd indien beschikbaar. |
| Conditioneel | receipt | String bijv. Ontvangstbewijs klant |
Bevat bongegevens van de kaarthouder die kunnen worden gebruikt voor het afdrukken op de ePOS. Teruggestuurd indien beschikbaar. |
