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.
-
De merchant moet een applicatie (APK) ontwikkelen en implementeren en deze installeren op het POS-apparaat.
-
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:
- Transactiestatus opvragen
- Terugdraaien > Voor situaties waarin de transactie is voltooid maar nog niet is verrekend.
- Terugbetaling
