- Credenciais de API
- Chave API
- Segredo do webhook
Configure a Stripe para que os viajantes paguem com cartão na página de pagamento da própria Stripe e regressem com a reserva paga. Precisa de uma conta bancária num dos países indicados acima.
Criar a sua conta Stripe
- 1
Registe-se na Stripe
Crie a conta em dashboard.stripe.com/register. Escolha com cuidado o país da empresa: a Stripe não o pode alterar depois de a conta estar ativa.
- 2
Verifique a sua empresa
Preencha o pedido em dashboard.stripe.com/account/onboarding: a sua empresa, as pessoas por trás dela e a conta bancária que recebe os seus pagamentos. Os pagamentos reais ficam disponíveis depois de a Stripe o verificar.
Copiar a chave secreta da Stripe
- 1
Abra as suas chaves de API
Vá a dashboard.stripe.com/apikeys e mude da sandbox para o modo de produção.
- 2
Copie a chave secreta
Em Standard keys, clique em Reveal live key e copie a Secret key: começa por sk_live_. Mantenha-a privada: quem a tiver pode receber e reembolsar pagamentos em seu nome.
Adicionar o webhook do TourTask na Stripe
O webhook informa o TourTask de cada pagamento, mesmo quando o dinheiro só é compensado dias depois ou o viajante nunca regressa.
O seu endereço de webhook do TourTask para a Stripe
https://api.tourtask.com/v1/payments/stripe/notifications/booking- 1
Crie um destino de eventos
Vá a dashboard.stripe.com/webhooks no modo de produção e clique em Create an event destination.
- 2
Escolha a sua conta e Snapshot
Selecione Your account e o formato de payload Snapshot: o TourTask não consegue ler os eventos Thin que a Stripe recomenda. Deixe a versão da API como está.
- 3
Selecione os dois eventos
Marque checkout.session.completed e checkout.session.async_payment_succeeded, e mais nada.
- 4
Escolha um endpoint de webhook
Clique em Continue e selecione Webhook endpoint como tipo de destino.
- 5
Introduza o endereço do TourTask
Clique em Continue, cole o endereço do TourTask acima como Endpoint URL e crie o destino.
- 6
Copie o segredo de assinatura
Na página do destino, clique em Reveal secret e copie o segredo de assinatura: começa por whsec_.
Adicionar Stripe no TourTask
- 1
Abra o cartão Stripe
Vá a Configuração → Opções de pagamento e clique no cartão Stripe em Pagamentos online → Gateways de pagamento. Não aparece? Escolha Mostrar todos os gateways por baixo dos cartões.
- 2
Escolha o país e a moeda
Em País, escolha o país da sua conta Stripe e da respetiva conta bancária e, em Moeda, a moeda em que os viajantes pagam. Clique em Adicionar. Para alterar qualquer um deles mais tarde, remova Stripe com Remover e adicione-o de novo.
- 3
Preencha as suas credenciais de API
Em Autenticação, o cartão tem um campo para cada uma:
Chave API
Segredo do webhookCada campo é guardado quando clica fora dele.
- 4
Ative Stripe
Clique em Ativar quando todos os campos estiverem preenchidos. O cartão passa a Ativo e os viajantes podem pagar com Stripe na sua página de reserva. Cada pagamento entra diretamente na sua própria conta Stripe: o TourTask nunca retém o seu dinheiro.
Para acrescentar uma sobretaxa ou reordenar os seus métodos de pagamento, veja pagamentos online.
Verificar se a Stripe funciona
O TourTask não tem modo de teste para a Stripe, e os termos da Stripe proíbem pagamentos de teste com cartões reais.
- 1
Abra a página de pagamento da Stripe
Na sua própria página de reserva, reserve um passeio e escolha a Stripe. Abre-se a página de pagamento da Stripe: feche-a sem pagar.
- 2
Cancele a reserva de teste
Abra a reserva no TourTask e clique em Cancelar reserva.
- 3
Verifique o seu primeiro pagamento
Quando um viajante pagar com a Stripe, a reserva aparece como paga e o pagamento surge no seu Stripe Dashboard.
- 4
Verifique o webhook
Na Stripe, abra o separador Event deliveries do destino: checkout.session.completed aparece como Delivered. Se falhou, verifique o URL do endpoint, o formato Snapshot e o Segredo do webhook.
Perguntas frequentes
Os que estiverem ativados nas definições de métodos de pagamento do seu Stripe Dashboard. Um método que só é compensado mais tarde, como um débito bancário, só marca a reserva como paga quando o dinheiro chega.
Não. O TourTask converte o total da reserva para a moeda que escolheu para o gateway.
Não. Os pagamentos entram na sua própria conta Stripe, e a Stripe transfere-os para o seu banco.