- Credenciais de API
- Chave API
- Chave publicável
- Segredo do webhook
O Stripe Elements coloca os campos de cartão da Stripe na sua página de reserva, para que os viajantes paguem com cartão sem sair dela. Precisa de uma conta Stripe que aceite pagamentos reais: o guia da Stripe mostra como abrir uma.
Copiar as suas chaves da Stripe
- 1
Abra as suas chaves de API no modo de produção
Abra dashboard.stripe.com/apikeys e confirme que está no modo de produção, não numa sandbox. Uma chave de teste não falha: marca as reservas como pagas com dinheiro que não existe.
- 2
Copie a chave publicável
Em Standard keys, copie a Publishable key. Começa por pk_live_.
- 3
Copie a chave secreta
Copie a Secret key (clique em Reveal live key se estiver oculta). Começa por sk_live_. Mantenha-a privada: permite cobrar cartões em seu nome.
Adicionar o webhook na Stripe
O seu endereço de webhook do TourTask para o Stripe Elements
https://api.tourtask.com/v1/payments/stripe-elements/notifications/booking- 1
Crie um destino de eventos
Abra dashboard.stripe.com/webhooks, ainda 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.
- 3
Selecione o evento
Selecione payment_intent.succeeded e nenhum outro evento.
- 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 em Endpoint URL e clique em Create destination.
- 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 Elements no TourTask
- 1
Abra o cartão Stripe Elements
Vá a Configuração → Opções de pagamento e clique no cartão Stripe Elements 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 Elements 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 Elements 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
Chave publicável
Segredo do webhookCada campo é guardado quando clica fora dele.
- 4
Ative Stripe Elements
Clique em Ativar quando todos os campos estiverem preenchidos. O cartão passa a Ativo e os viajantes podem pagar com Stripe Elements na sua página de reserva. Cada pagamento entra diretamente na sua própria conta Stripe Elements: o TourTask nunca retém o seu dinheiro.
Verificar se a Stripe Elements funciona
O TourTask não tem modo de teste para a Stripe Elements, e os termos da Stripe proíbem pagamentos de teste com cartões reais.
- 1
Abra o formulário do cartão
Na sua própria página de reserva, reserve um passeio e escolha pagar com cartão: aparece o formulário de cartão da Stripe. Feche a página 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 cartão, 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: payment_intent.succeeded aparece como Delivered.
Adicionar o Apple Pay e o Google Pay
O Apple Pay e o Google Pay são gateways próprios, configurados como o Stripe Elements e com as mesmas duas chaves. Cada um precisa do seu próprio endpoint de webhook no seu próprio endereço, e o segredo de assinatura desse endpoint vai para o respetivo Segredo do webhook.
Apple Pay
https://api.tourtask.com/v1/payments/apple-pay/notifications/bookingGoogle Pay
https://api.tourtask.com/v1/payments/google-pay/notifications/bookingPerguntas frequentes
Não. O cartão vai diretamente do navegador do viajante para a Stripe.
O Stripe Elements mantém os viajantes na sua página de reserva; a Stripe envia-os para a página da própria Stripe e de volta. Pode usar os dois.
Os que estiverem ativados nas definições de métodos de pagamento do seu Stripe Dashboard. Os cartões estão ativados por predefinição.
Não. O TourTask converte o total da reserva para a moeda que escolheu para o gateway.