Vous souhaitez vous connecter à un fournisseur de paiement que nous n'avons pas encore connecté ? C'est assez simple à faire, il suffit de créer une application de fournisseur de paiement et de commencer à recevoir des paiements.
1. Créer une application
Accédez à l'Appstore et créez une application. Voici les prérequis :
- Votre application a besoin d'un webhook avec l'événement patchment.request
- La catégorie doit être payment_provider
- Il faut un logo et une description
URL de redirection de paiement (Webhook)
Nous enverrons l'utilisateur vers cette URL lorsqu'il/elle commencera un paiement. Vous pouvez ensuite rediriger l'utilisateur vers la bonne page de paiement ou lui laisser 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'admin_id de l'administration
chain_id = Si cet administrateur appartient à une chaîne
reservation_id = (numéro) identifiant unique pour cette réservation
reservation_number = (numéro) le numéro de réservation tel que communiqué au client
facture_id = (numéro) Identifiant unique de la facture, ce paiement appartient à
montant : ( float(2) par exemple 10233 = 102,33 EUR) avec un maximum de 2 décimales, le montant total qui doit être facturé
devise : 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é effectué ? Super ! Vous pouvez maintenant l'ajouter à Camping.vare. Vous pouvez utiliser l'API de paiement 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
Rediriger l'utilisateur vers sa page d'invité personnelle. Avec le reservation_id, vous pouvez récupérer la réservation depuis l'API. Vous trouverez ici le hachage que vous devez utiliser pour créer l'URL vers la page d'invité.
https://[administration.slug].camping.care/réservation/{réservation.id}/{réservation.meta.hash}