Wil je een betalingsprovider verbinden die we nog niet hebben verbonden? Dit is vrij eenvoudig te doen, maak gewoon een betalingsprovider-app en begin met het ontvangen van betalingen.
1. Maak een app
Ga naar de App Store en maak een app. Dit zijn de vereisten:
- Je app heeft een webhook nodig met het evenement payment.request
- De categorie moet payment_provider zijn
- Het heeft een logo en een beschrijving nodig
Betalingsredirect-URL (Webhook)
We sturen de gebruiker naar deze URL wanneer hij/zij een betaling start. Je kunt de gebruiker dan omleiden naar de juiste betalingspagina of hen een betalingsmethode laten kiezen en hen vervolgens naar de betalingspagina omleiden.
Samen met de URL sturen we de volgende parameters in de query.
app_id = De id van de app
admin_id = De admin_id van de administratie
chain_id = Als deze admin tot een keten behoort
reservation_id = (nummer) unieke id voor deze reservering
reservation_number = (nummer) het reserveringsnummer zoals gecommuniceerd aan de gast
invoice_id = (nummer) Unieke id voor de factuur, waar deze betaling bij hoort
amount: (float(2) bijv. 10233 = EUR102,33) met een maximum van 2 decimalen, het totale bedrag dat in rekening moet worden gebracht
currency: EUR (of andere valuta)
language: nl (en, de, it, fr, es, dk)
Als je je app maakt, kun je deze URL (zonder parameters) aan de webhooklijst toevoegen. Met het evenement payment.request.
Voeg de betaling toe
Is de betaling voltooid? Geweldig! Nu kun je het toevoegen aan Camping.vare. Je kunt de betalings-API gebruiken om de betaling aan ons systeem toe te voegen.
Voeg betaling toe via de API
https://documenter.getpostman.com/view/9467805/VUjQkj1d#c02a0b22-1ce5-4446-888a-3c9434ed3b58
Als je je eigen referentie bij de betaling wilt opslaan. Je kunt metadata aan de betaling toevoegen. Met deze API:
https://documenter.getpostman.com/view/9467805/VUjQkj1d#7cb7f76b-cda1-48dd-b603-f7bc7557ab27
Stuur de gebruiker door naar hun persoonlijke gastenpagina. Met de reservation_id kun je de reservering ophalen uit de API. Hier vind je de hash die je nodig hebt om de url naar de gastenpagina te maken.
https://[administration.slug].camping.care/reservation/{reservation.id}/{reservation.meta.hash}