Documentatie/API-referentie

API REFERENCE

Integratie in de app

Geldt voor betalingen op een fysieke POS-terminal

Deze API start een betaalproces in de eigen applicatie (app) van de merchant. Via app-naar-app-integratie wordt de betaalapp gestart om een autorisatie of een eenmalige betaling uit te voeren.

  1. De merchant moet een applicatie (APK) ontwikkelen en implementeren en deze installeren op het POS-apparaat.

  2. Wanneer een transactie wordt gestart, roept de merchantapp via app-naar-app-integratie de betaalapp aan om het betaalproces te voltooien.

Tip

Autorisatietransacties die via een POS-terminal worden gestart, zijn 5 dagen geldig. Autorisatieorders verlopen automatisch na 5 dagen.

Overzicht van de integratie

In dit gedeelte worden de belangrijkste interacties en de basisworkflow tussen de door de merchant ontwikkelde applicatie (Merchant App) en de betaalapplicatie (Payment App) beschreven.

Via app-naar-app-integratie kan de merchantapp de betaalapp op het POS-apparaat rechtstreeks starten om betalingen uit te voeren.


1. Apparaten opvragen

Haal de lijst met POS-apparaten van de merchant en de statusgegevens op, zoals apparaatnummers en serienummers.

Voordat u een transactie start, moet u de apparaten opvragen om de doelterminal te identificeren.


2. Een transactie starten

Gebruik de merchantapp om via app-naar-app-integratie de betaalapp Switchio Pay te starten en een autorisatie of een eenmalige betaling uit te voeren.


3. Online transacties koppelen met trade_id

Nadat u Get trade_id hebt aangeroepen en de trade_id van de transactie hebt opgehaald, kan de cloudservice van de merchant deze trade_id gebruiken om de transactie aan het eigen ordersysteem te koppelen en vervolgoproepen naar cloud-API's uit te voeren, zoals autorisatie verhogen of verlagen, opvragen, terugdraaien of terugbetalen.


Autorisatieworkflow

Voor bewerkingen na autorisatie, zoals aanpassingen van het bedrag en de definitieve opname, raden we sterk aan de API's te gebruiken in plaats van deze rechtstreeks op de POS-terminal uit te voeren.

Dit verbetert de consistentie, beheersing en traceerbaarheid van transacties.

De volgende API's zijn beschikbaar:


Terugbetalingen en annulering van betalingen

Raadpleeg voor terugbetalingen (inclusief gedeeltelijke terugbetalingen) en het annuleren van betalingen de volgende API-documentatie: