Stripe

Como aceitar pagamentos com cartão através da Stripe

Receba pagamentos com cartão na página de pagamento da própria Stripe.

Países

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

Moedas

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

A Stripe restringe algumas empresas de viagens

Os serviços de reservas de viagens precisam de documentos adicionais, e a Stripe pode recusá-los mesmo assim. Companhias aéreas, cruzeiros e multipropriedades são proibidos. Consulte primeiro a lista da Stripe.

Quer os campos do cartão na sua própria página de reserva?

Use o Stripe Elements em vez disso, ou também: funciona com a mesma conta Stripe.

Criar a sua conta Stripe


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

    Abra as suas chaves de API

    Vá a dashboard.stripe.com/apikeys e mude da sandbox para o modo de produção.

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

Nunca cole uma chave de teste

Uma chave de teste (sk_test_) não dá nenhum erro: as reservas ficam marcadas como pagas com dinheiro de teste que nunca chega ao seu banco.

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

    Selecione os dois eventos

    Marque checkout.session.completed e checkout.session.async_payment_succeeded, e mais nada.

  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 como Endpoint URL e crie o destino.

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

Adicionar Stripe no TourTask


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

    Preencha as suas credenciais de API

    Em Autenticação, o cartão tem um campo para cada uma:
    Chave API
    Segredo do webhook

    Cada campo é guardado quando clica fora dele.

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

Escolha o cartão só com o logótipo da Stripe: o que tem ELEMENTS por baixo do logótipo é o Stripe Elements, outro gateway.

Cole a chave secreta em Chave API e o segredo de assinatura em Segredo do webhook.

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. 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. 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 a Stripe, 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: 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.

Esta página foi útil?