Using our new version (Starfish) is very easy. Most of the data will remain the same as in V1....
How to add your own payment provider?
Do you want to connect a payment provider that we haven't connected yet? This is quite easy to do, just create a Payment Provider app and start receiving payments.
1. Create an app
Go to the Appstore and create an app. These are the requirements:
- Your app need an webhook with the event patment.request
- The category needs to be payment_provider
- It needs a logo and a description
We will send the user to this url when he/she starts a payment. You can then redirect the user the the right payment page or let them choose a payment method to use and then redirect them to the payment page.
Along with the url we will send the following parameters in the query.
app_id = The id of the app
admin_id = The admin_id of the administration
chain_id = If this admin belong to a chain
reservation_id = (number) unique id for this reservation
reservation_number = (number) the reservation number as communicated to the guest
invoice_id = (number) Unique id for the invoice, this payment belongs to
amount: ( float(2) eg. 10233 = EUR102,33) with a max of 2 decimals, the total amount that has to be charged
currency: EUR (or other currency)
language: nl (en, de, it, fr, es, dk)
If you create your app, you can add this url (without parameters) to the webhook list. With the event payment.request.
Add the payment
Has the payment been completed? Great! Now you can add it to Camping.vare. You can use the payments API to add the payment to our system.
Add payment via the API
https://documenter.getpostman.com/view/9467805/VUjQkj1d#c02a0b22-1ce5-4446-888a-3c9434ed3b58
If you want to store your own reference with the payment. You can add meta data to the payment. With this api:
https://documenter.getpostman.com/view/9467805/VUjQkj1d#7cb7f76b-cda1-48dd-b603-f7bc7557ab27
Redirect the user to their personal guest page. With the reservation_id you are able to retrieve the reservation from the API. Here you will find the hash you need to use to create the url to the guest page.
https://[administration.slug].camping.care/reservation/{reservation.id}/{reservation.meta.hash}