Sale
Gebruik deze transactie om een standaard verkoop te verwerken.
Eindpunt : /sale
{
"siteid":"123456",
"txndate":"2023-02-01:16:13:20",
"terminalserialnumber":"6789654678",
"type":"sale",
"amount":"20.00",
"refid":"12345678987654321",
"wait":"y"
}
{
"siteid":"123456",
"terminalserialnumber":"6789654678",
"resultcode":"Approved",
"amount":"20.00",
"authcode":"abc1234",
"refid":"12345678987654321",
"cardtype":"Visa",
"last4":"0026",
"receipt":"Sample output",
"merchantreceipt":"Sample output",
"finalamount":"20.00"
}
- De transactie wordt aan het eind van de dag automatisch afgewikkeld.
- Voor DCC zal de PED in de kaart Munt worden verwerkt indien daarom wordt verzocht.
Void
Gebruik deze transactie om een eerder ingediende transactie te annuleren.
Eindpunt : /void
{
"siteid":"123456",
"txndate":"2023-02-01:16:13:20",
"terminalserialnumber":"6789654678",
"type":"void",
"refid":"12345678987654321"
}
{
"siteid":"123456",
"resultcode":"Approved",
"refid":"12345678987654321234"
}
De refid verwijst naar de oorspronkelijke transactie refid.
Terugbetaling
Gebruik deze transactie om terug te storten op een kaart.
Eindpunt : /refund
{
"siteid":"123456",
"txndate":"2023-02-01:16:13:20",
"terminalserialnumber":"6789654678",
"type":"refund",
"amount":"20.00",
"refid":"12345678987654321234"
}
{
"siteid":"123456",
"terminalserialnumber":"6789654678",
"resultcode":"Approved",
"refid":"12345678987654321234",
"amount":"20.00",
"receipt":"Sample output",
"merchantreceipt":"Sample output"
}
- De refid verwijst naar het origineel.
- De terugbetaling kan maximaal het bedrag van de oorspronkelijke transactie zijn.
- Voor CNP transacties moet het kaartnummer in de terminal worden ingevoerd.
- Stel linked naar "n" om een niet-gekoppelde terugbetaling te verwerken. Standaard zijn alle teruggaven gekoppeld.
PreAuth
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
{
"siteid":"123456",
"txndate":"2023-02-01:16:13:20",
"terminalserialnumber":"6789654678",
"type":"preauth",
"amount":"60.00",
"refid":"89045432",
"wait":"y"
}
{
"siteid":"123456",
"terminalserialnumber":"6789654678",
"resultcode":"Approved",
"amount":"60.00",
"authcode":"abc1234",
"refid":"123456789876543212345",
"topuptoken":"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
"expiry":"2023-02-08:04:13:20",
"cardtype":"Visa",
"last4":"0026",
"receipt":"Sample output",
"finalamount":"60.00",
"merchantreceipt":"Sample output"
}
- Dit transactietype behandelt PreAuth CP en CNP. Voor CNP transacties kan het kaartnummer worden ingevoerd op de PED.
- 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.
Capure
Gebruik deze transactie om een eerder geautoriseerde transactie vast te leggen.
Eindpunt : /capture
{
"siteid":"123456",
"txndate":"2023-02-01:16:13:20",
"type":"capture",
"amount":"40.00",
"refid":"123456789876543212345"
}
{
"siteid":"123456",
"resultcode":"Approved",
"refid":"123456789876543212345",
"receipt":"Sample output",
"finalamount":"40.00",
"merchantreceipt":"Sample output"
}
- Gebruik de refid om de oorspronkelijke machtiging te identificeren.
- De vastlegging kan tot 100% van de oorspronkelijke vergunning bedragen.
- De vangst kan slechts eenmaal worden uitgevoerd 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.
Status
Gebruik deze transactie om de status van een eerder ingediende transactie op te vragen. Dit kan worden gebruikt in gevallen als communicatie- of hardwarestoringen.
Eindpunt : /status
{
"siteid":"123456",
"txndate":"2023-02-01:16:13:20",
"refid":"123456789876543212345"
}
{
"siteid":"123456",
"resultcode":"Approved",
"authcode":"abc1234",
"refid":"123456789876543212",
"type":"sale",
"error":"",
"errorcode":"",
"topuptoken":"",
"cardtype":"Visa",
"last4":"0026",
"finalamount":"20.00"
}
Gebruik de refid om de oorspronkelijke machtiging te identificeren.
