Voulez-vous connecter un fournisseur de paiement que nous n'avons pas encore connecté ? C'est assez facile à faire, il suffit de créer une application de fournisseur de paiement et de commencer à recevoir des paiements.
1. Créer une application
Allez dans l'App Store et créez une application. Voici les exigences :
- Votre application a besoin d'un webhook avec l'événement payment.request
- La catégorie doit être payment_provider
- Elle a besoin d'un logo et d'une description
URL de redirection de paiement (Webhook)
Nous enverrons l'utilisateur à cette URL lorsqu'il/elle commencera un paiement. Vous pouvez ensuite rediriger l'utilisateur vers la bonne page de paiement ou lui permettre de choisir un mode de paiement à utiliser, puis le rediriger vers la page de paiement.
Avec l'URL, nous enverrons les paramètres suivants dans la requête.
app_id = L'identifiant de l'application
admin_id = L'identifiant de l'administration
chain_id = Si cet administrateur appartient à une chaîne
reservation_id = (nombre) identifiant unique pour cette réservation
reservation_number = (nombre) le numéro de réservation tel que communiqué au client
invoice_id = (nombre) Identifiant unique pour la facture à laquelle ce paiement appartient
amount: (float(2) ex. 10233 = EUR102,33) avec un maximum de 2 décimales, le montant total à facturer
currency: EUR (ou autre devise)
langue : nl (en, de, it, fr, es, dk)
Si vous créez votre application, vous pouvez ajouter cette URL (sans paramètres) à la liste des webhooks. Avec l'événement payment.request.
Ajouter le paiement
Le paiement a-t-il été complété ? Super ! Maintenant, vous pouvez l'ajouter à Camping.vare. Vous pouvez utiliser l'API des paiements pour ajouter le paiement à notre système.
Ajouter un paiement via l'API
https://documenter.getpostman.com/view/9467805/VUjQkj1d#c02a0b22-1ce5-4446-888a-3c9434ed3b58
Si vous souhaitez stocker votre propre référence avec le paiement. Vous pouvez ajouter des métadonnées au paiement. Avec cette API :
https://documenter.getpostman.com/view/9467805/VUjQkj1d#7cb7f76b-cda1-48dd-b603-f7bc7557ab27
Redirigez l'utilisateur vers sa page d'invité personnelle. Avec le reservation_id, vous pouvez récupérer la réservation depuis l'API. Ici, vous trouverez le hash que vous devez utiliser pour créer l'URL vers la page d'invité.
https://[administration.slug].camping.care/reservation/{reservation.id}/{reservation.meta.hash}
