Stripe Elements

Como aceitar pagamentos com cartão através do Stripe Elements

Receba pagamentos com cartão na sua página de reserva com o Stripe Elements.

Países

  • Alemanha
  • Austrália
  • Áustria
  • Bélgica
  • Brasil

Moedas

  • AED
  • AFN
  • ALL
  • AMD
  • ANG
  • AOA
  • ARS
DocumentaçãoContacto
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. 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. 2

    Copie a chave publicável

    Em Standard keys, copie a Publishable key. Começa por pk_live_.

  3. 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 webhook marca as reservas como pagas

Sem ele, os viajantes são cobrados e as reservas ficam por confirmar.

O seu endereço de webhook do TourTask para o Stripe Elements

https://api.tourtask.com/v1/payments/stripe-elements/notifications/booking
  1. 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. 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. 3

    Selecione o evento

    Selecione payment_intent.succeeded e nenhum outro evento.

  4. 4

    Escolha um endpoint de webhook

    Clique em Continue e selecione Webhook endpoint como tipo de destino.

  5. 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. 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_.

Um endpoint para cada gateway

Já tem um endpoint para o gateway Stripe? Adicione um novo na mesma: cada gateway precisa do seu.

Adicionar Stripe Elements no TourTask


  1. 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. 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. 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 webhook

    Cada campo é guardado quando clica fora dele.

  4. 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.

Chave API: a sua chave secreta sk_live_…
Chave publicável: a sua chave pk_live_…
Segredo do webhook: o seu segredo de assinatura whsec_…

Mostre-o aberto por predefinição (opcional)

Clique em Aberto por predefinição no cartão do gateway para mostrar o formulário de cartão aberto no topo da sua página de reserva.

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. 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. 2

    Cancele a reserva de teste

    Abra a reserva no TourTask e clique em Cancelar reserva.

  3. 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. 4

    Verifique o webhook

    Na Stripe, abra o separador Event deliveries do destino: payment_intent.succeeded aparece como Delivered.

Cobrado, mas não pago no TourTask?

Verifique o webhook na Stripe: modo de produção, formato Snapshot, o evento payment_intent.succeeded e o endereço exato. No TourTask, o Segredo do webhook tem de ter o segredo de assinatura deste endpoint. O separador Event deliveries do destino, na Stripe, mostra cada tentativa falhada.

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/booking

Google Pay

https://api.tourtask.com/v1/payments/google-pay/notifications/booking
Registe os seus endereços web na Stripe

Ao contrário do formulário de cartão, os botões das carteiras digitais só aparecem nos endereços registados na Stripe em Settings → Payment method domains. Registe todos os endereços em que os viajantes reservam: o seu próprio site, suaempresa.tourtask.com e o seu site do TourTask (suaempresa.tourtask.site ou o respetivo domínio próprio). example.com e www.example.com são duas entradas.

Perguntas 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.

Esta página foi útil?