Você quer conectar um provedor de pagamento que ainda não conectamos? Isso é bem fácil de fazer, basta criar um aplicativo de Provedor de Pagamento e começar a receber pagamentos.
1. Crie um aplicativo
Vá para a App Store e crie um aplicativo. Estes são os requisitos:
- Seu aplicativo precisa de um webhook com o evento payment.request
- A categoria precisa ser payment_provider
- Precisa de um logo e uma descrição
URL de Redirecionamento de Pagamento (Webhook)
Nós enviaremos o usuário para esta URL quando ele/ela iniciar um pagamento. Você pode então redirecionar o usuário para a página de pagamento correta ou deixá-los escolher um método de pagamento a usar e depois redirecioná-los para a página de pagamento.
Juntamente com a URL, enviaremos os seguintes parâmetros na consulta.
app_id = O id do aplicativo
admin_id = O admin_id da administração
chain_id = Se este admin pertence a uma cadeia
reservation_id = (número) id único para esta reserva
reservation_number = (número) o número da reserva conforme comunicado ao hóspede
invoice_id = (número) id único para a fatura, a qual este pagamento pertence
amount: (float(2) ex. 10233 = EUR102,33) com um máximo de 2 casas decimais, o valor total que deve ser cobrado
currency: EUR (ou outra moeda)
language: nl (en, de, it, fr, es, dk)
Se você criar seu aplicativo, pode adicionar esta URL (sem parâmetros) à lista de webhooks. Com o evento payment.request.
Adicionar o pagamento
O pagamento foi concluído? Ótimo! Agora você pode adicioná-lo ao Camping.vare. Você pode usar a API de pagamentos para adicionar o pagamento ao nosso sistema.
Adicionar pagamento via API
https://documenter.getpostman.com/view/9467805/VUjQkj1d#c02a0b22-1ce5-4446-888a-3c9434ed3b58
Se você quiser armazenar sua própria referência com o pagamento. Você pode adicionar metadados ao pagamento. Com esta API:
https://documenter.getpostman.com/view/9467805/VUjQkj1d#7cb7f76b-cda1-48dd-b603-f7bc7557ab27
Redirecione o usuário para sua página pessoal de hóspede. Com o reservation_id você pode recuperar a reserva da API. Aqui você encontrará o hash que precisa usar para criar a URL para a página do hóspede.
https://[administration.slug].camping.care/reservation/{reservation.id}/{reservation.meta.hash}