Vuoi connettere un fornitore di pagamento che non abbiamo ancora collegato? È abbastanza facile da fare, basta creare un'app per il fornitore di pagamento e iniziare a ricevere pagamenti.
1. Crea un'app
Vai all'App Store e crea un'app. Questi sono i requisiti:
- La tua app ha bisogno di un webhook con l'evento payment.request
- La categoria deve essere payment_provider
- Ha bisogno di un logo e di una descrizione
URL di reindirizzamento del pagamento (Webhook)
Invieremo l'utente a questo URL quando inizia un pagamento. Puoi quindi reindirizzare l'utente alla pagina di pagamento corretta o lasciarlo scegliere un metodo di pagamento da utilizzare e poi reindirizzarlo alla pagina di pagamento.
Insieme all'URL invieremo i seguenti parametri nella query.
app_id = L'id dell'app
admin_id = L'admin_id dell'amministrazione
chain_id = Se questo admin appartiene a una catena
reservation_id = (numero) id unico per questa prenotazione
reservation_number = (numero) il numero di prenotazione comunicato all'ospite
invoice_id = (numero) id unico per la fattura a cui appartiene questo pagamento
amount: (float(2) es. 10233 = EUR102,33) con un massimo di 2 decimali, l'importo totale che deve essere addebitato
currency: EUR (o altra valuta)
language: nl (en, de, it, fr, es, dk)
Se crei la tua app, puoi aggiungere questo URL (senza parametri) all'elenco dei webhook. Con l'evento payment.request.
Aggiungi il pagamento
Il pagamento è stato completato? Ottimo! Ora puoi aggiungerlo a Camping.vare. Puoi utilizzare l'API dei pagamenti per aggiungere il pagamento al nostro sistema.
Aggiungi pagamento tramite l'API
https://documenter.getpostman.com/view/9467805/VUjQkj1d#c02a0b22-1ce5-4446-888a-3c9434ed3b58
Se desideri memorizzare il tuo riferimento con il pagamento. Puoi aggiungere metadati al pagamento. Con questa API:
https://documenter.getpostman.com/view/9467805/VUjQkj1d#7cb7f76b-cda1-48dd-b603-f7bc7557ab27
Reindirizza l'utente alla propria pagina personale degli ospiti. Con il reservation_id puoi recuperare la prenotazione dall'API. Qui troverai l'hash che devi utilizzare per creare l'url per la pagina degli ospiti.
https://[administration.slug].camping.care/reservation/{reservation.id}/{reservation.meta.hash}