Wilt u een betalingsprovider koppelen die wij nog niet gekoppeld hebben? Dat is vrij eenvoudig te doen, maak gewoon een Payment Provider-app en begin met het ontvangen van betalingen.
1. Maak een app
Ga naar de Appstore en maak een app. Dit zijn de vereisten:
- Uw app heeft een webhook nodig met de gebeurtenis patment.request
- De categorie moet payment_provider zijn
- Er is een logo en een beschrijving nodig
Betalingsredirect-URL (Webhook)
We sturen de gebruiker naar deze url wanneer hij/zij een betaling start. U kunt de gebruiker dan doorverwijzen naar de juiste betaalpagina of ze een betaalmethode laten kiezen om te gebruiken en ze vervolgens doorverwijzen naar de betaalpagina.
Samen met de url sturen we de volgende parameters mee in de query.
app_id = De id van de app
admin_id = De admin_id van de administratie
chain_id = Als deze beheerder 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, deze betaling behoort toe
bedrag: (float(2) bv. 10233 = EUR102,33) met maximaal 2 decimalen, het totale bedrag dat in rekening moet worden gebracht
valuta: EUR (of andere valuta)
taal: nl (en, de, it, fr, es, dk)
Als u uw app maakt, kunt u deze url (zonder parameters) toevoegen aan de webhooklijst. Met de gebeurtenis payment.request.
Voeg de betaling toe
Is de betaling voltooid? Geweldig! Nu kunt u deze toevoegen aan Camping.vare. U kunt de betalingen-API gebruiken om de betaling toe te voegen aan ons systeem.
Betaling toevoegen via de API
https://documenter.getpostman.com/view/9467805/VUjQkj1d#c02a0b22-1ce5-4446-888a-3c9434ed3b58
Als u uw eigen referentie bij de betaling wilt opslaan. U kunt metagegevens aan de betaling toevoegen. Met deze api:
https://documenter.getpostman.com/view/9467805/VUjQkj1d#7cb7f76b-cda1-48dd-b603-f7bc7557ab27
Stuur de gebruiker door naar zijn/haar persoonlijke gastpagina. Met de reservation_id kunt u de reservering ophalen uit de API. Hier vindt u de hash die u moet gebruiken om de url naar de gastpagina te maken.
https://[administratie.slug].camping.care/reservering/{reservering.id}/{reservering.meta.hash}