Demo ao vivo

Pagamentos para reservas de viagens

Integração de gateways de pagamento para viagens que mantém cada pagamento ligado à sua reserva

Conecte o seu site de reservas ou portal B2B aos provedores de pagamento que os seus clientes usam. O checkout acontece dentro do fluxo de reserva, o 3D Secure corre quando o cartão o exige, e cada autorização, captura, reembolso e webhook fica guardado contra a referência de reserva com que a sua equipa trabalha.

  • Checkout dentro do fluxo de reserva
  • Multimoeda quando o seu provedor permite
  • 3D Secure e cartões tokenizados
  • Anulações, reembolsos e reconciliação

Checkout de viagens seguro

Integração de gateways de pagamento para viagens dentro do seu fluxo de reserva

Os clientes pagam voos, hotéis, tours e transfers na sua própria página de checkout, não através de um link de pagamento desligado. O sistema de reservas envia o valor, a moeda e a referência da reserva; o gateway devolve um resultado sobre o qual a reserva pode agir.

O mesmo fluxo serve Software de reserva de voos, Motor de reservas de hotel e Software para operadoras de turismo: a reserva fica retida, o pagamento é cobrado e a confirmação do fornecedor só segue quando o pagamento tem sucesso.

  • Multimoeda

    Apresente e liquide nas moedas que o seu provedor e a sua conta de comerciante suportam.

  • Autenticação segura

    Cartões tokenizados, 3D Secure e as verificações de risco do próprio provedor.

  • Registos rastreáveis

    Transações, reservas, reembolsos e referências de liquidação permanecem ligados.

Pagamento da reservaReservaPT-48213
  1. Dados
  2. Pagamento
  3. 3D Secure
  4. Confirmada
Pagar em
  • Voo, 2 adultos$612.00
  • Hotel, 3 noites$438.00
  • Taxa de reserva$15.00
Total a pagar$1,065.00 USD
  • Voo, 2 adultos€566.00
  • Hotel, 3 noites€405.00
  • Taxa de reserva€14.00
Total a pagar€985.00 EUR
  • Voo, 2 adultos£486.00
  • Hotel, 3 noites£348.00
  • Taxa de reserva£12.00
Total a pagar£846.00 GBP

Os dados do cartão vão diretamente para o seu gateway

Valores de exemplo. Moedas, métodos e taxas dependem do seu gateway e da sua conta de comerciante.

Ciclo de vida da transação

Como o estado do pagamento e o estado da reserva avançam juntos

Um pagamento de viagem não termina quando o cartão é aprovado. Escolha um cenário para ver o que o gateway reporta e o que a reserva faz em cada passo.

Paga e confirmada

CapturadoConfirmada
  1. 0100:00A reserva envia valor, moeda e referência ao gatewayPagamentoPendenteReservaEm espera
  2. 0200:04O gateway aprova o cartão e retém os fundosPagamentoAutorizadoReservaEm espera
  3. 0300:09O fornecedor confirma a reservaPagamentoAutorizadoReservaConfirmada
  4. 0400:10Os fundos retidos são capturadosPagamentoCapturadoReservaConfirmada
  5. 0500:11Webhook assinado guardado contra a reservaPagamentoCapturadoReservaConfirmada

Capturar depois de o fornecedor confirmar significa que o cliente nunca é cobrado por uma reserva que não existe.

Desafio 3D Secure

CapturadoConfirmada
  1. 0100:00A reserva envia valor, moeda e referência ao gatewayPagamentoPendenteReservaEm espera
  2. 0200:03O banco solicita um desafio 3D SecurePagamentoAção necessáriaReservaEm espera
  3. 0300:41O cliente conclui a verificação e o pagamento é autorizadoPagamentoAutorizadoReservaEm espera
  4. 0400:46O fornecedor confirma a reservaPagamentoAutorizadoReservaConfirmada
  5. 0500:47Os fundos retidos são capturadosPagamentoCapturadoReservaConfirmada

A reserva fica em espera enquanto o cliente verifica. Se o desafio falhar ou expirar, a retenção é libertada e nada é cobrado.

Preço alterado

CapturadoConfirmada
  1. 0100:00Preço revalidado com o fornecedor antes da cobrançaPagamentoNão iniciadoReservaEm espera
  2. 0200:02Novo preço mostrado ao cliente para aprovaçãoPagamentoNão iniciadoReservaPreço atualizado
  3. 0300:30O cliente aceita e é criado um pagamento com o novo valorPagamentoPendenteReservaPreço atualizado
  4. 0400:34O gateway aprova o cartão e retém os fundosPagamentoAutorizadoReservaPreço atualizado
  5. 0500:39O fornecedor confirma a reservaPagamentoAutorizadoReservaConfirmada
  6. 0600:40Os fundos retidos são capturadosPagamentoCapturadoReservaConfirmada

Revalidar antes do pagamento evita que a agência absorva um aumento de tarifa que nunca viu.

Fornecedor falhou após o pagamento

AnuladoFalhada
  1. 0100:00A reserva envia valor, moeda e referência ao gatewayPagamentoPendenteReservaEm espera
  2. 0200:04O gateway aprova o cartão e retém os fundosPagamentoAutorizadoReservaEm espera
  3. 0300:12O fornecedor rejeita a reservaPagamentoAutorizadoReservaFalhada
  4. 0400:13Autorização anulada antes da captura, sem cobrançaPagamentoAnuladoReservaFalhada
  5. 0500:14Cliente e equipa de operações notificados com ambas as referênciasPagamentoAnuladoReservaFalhada

Como os fundos estavam apenas autorizados, são libertados com uma anulação em vez de um reembolso. Quando o provedor captura de imediato, o mesmo passo torna-se um reembolso.

Sequência ilustrativa. Se os fundos são autorizados primeiro ou capturados de imediato depende do gateway e das suas definições.

Por dentro

Pedidos, webhooks e reembolsos que levam a referência da reserva

Cada chamada ao gateway leva a referência da reserva e uma chave de idempotência, e cada evento vindo do gateway é verificado antes de alterar uma reserva.

  1. 1A referência da reserva viaja como metadados, por isso o painel do provedor e o seu painel de administração mostram a mesma reserva.
  2. 2Uma chave de idempotência impede que um duplo clique ou uma nova tentativa de rede cobre duas vezes.
  3. 3Os valores são enviados em unidades menores com um código de moeda explícito.
  1. 1A assinatura é verificada contra o seu segredo de webhook antes de qualquer alteração.
  2. 2O tipo de evento decide a ação na reserva: confirmar, libertar ou sinalizar para revisão.
  3. 3Entregas repetidas do mesmo evento são reconhecidas e ignoradas.
  1. 1Valores parciais cobrem taxas de cancelamento retidas pela agência ou pelo fornecedor.
  2. 2O reembolso aponta para o pagamento original e para a reserva cancelada.
  3. 3Um código de motivo vai para o provedor e para os seus registos, para suporte e disputas.

Provedores ainda não ligados são tratados como uma Integração de API personalizada. Gateways populares têm as suas próprias páginas: Pagamentos com Stripe e Pagamentos com PayPal.

POST /v1/paymentsIdempotency-Key: bk_PT-48213_a1{  "amount": 106500,  "currency": "USD",  "capture": "after_confirmation",  "metadata": {    "booking": "PT-48213",    "pnr": "X7K2LM"  }}
POST /webhooks/paymentsSignature: t=1791012345,v1=5f3ac1…{  "id": "evt_8841",  "type": "payment.captured",  "payment": "pay_3QK19",  "metadata": { "booking": "PT-48213" }}→ 200 OK  booking=PT-48213 status=confirmed
POST /v1/refundsIdempotency-Key: rf_PT-48213_1{  "payment": "pay_3QK19",  "amount": 41800,  "currency": "USD",  "reason": "cancelled_by_customer",  "metadata": {    "booking": "PT-48213",    "retained_fee": 2000  }}

Exemplo genérico. Os nomes dos campos seguem a API do gateway que escolher.

Operações específicas de viagens

Controlos de pagamento para o que corre mal nas viagens

Os preços mudam, os fornecedores falham e os clientes cancelam. Cada controlo responde a uma situação que as equipas de operações enfrentam regularmente.

  • Situação01

    A tarifa do hotel subiu entre a pesquisa e o pagamento.

    Controlo

    Revalidação de preço

    O preço mais recente do fornecedor é confirmado antes de cobrar o cliente, e qualquer alteração é mostrada para aprovação.

  • Situação02

    O cliente carregou duas vezes em Pagar numa ligação lenta.

    Controlo

    Fluxo de reserva idempotente

    Pedidos repetidos devolvem o primeiro resultado em vez de criar uma segunda cobrança ou uma segunda reserva.

  • Situação03

    O cliente paga em euros e o fornecedor fatura em dólares.

    Controlo

    Regras de moeda e margem

    Moeda do checkout, valor da reserva, margem e valor de liquidação são registados separadamente.

  • Situação04

    Duas noites de uma estadia de cinco são canceladas.

    Controlo

    Anulações e reembolsos parciais

    Reversões totais ou parciais ficam ligadas ao cancelamento ou alteração que as originou.

  • Situação05

    Um titular contesta uma cobrança meses depois da viagem.

    Controlo

    Disputas e chargebacks

    Eventos do provedor, resultados de autenticação e documentos da reserva são guardados em conjunto como prova.

  • Situação06

    Chega um webhook para uma reserva já cancelada.

    Controlo

    Webhooks e alertas

    Eventos verificados atualizam reservas; o que não encaixa é sinalizado para revisão por uma pessoa.

Cobertura de provedores

Escolha um gateway para o seu mercado e os seus clientes

A disponibilidade depende da aprovação do comerciante, da cobertura por país, das moedas e dos métodos de pagamento. Muitas agências combinam um gateway de cartões global com um provedor regional e uma opção de liquidação B2B.

  • A

    Gateways de cartões globais

    Aceitação de cartões, tokenização, 3D Secure, reembolsos e checkout multimercado.

  • B

    Provedores regionais

    Moedas locais, redes de pagamento nacionais e métodos específicos do mercado.

  • C

    Carteiras digitais

    Checkout mais rápido para clientes que preferem uma conta de carteira aprovada.

  • D

    Fluxos de pagamento B2B

    Crédito de agente, registos de pagamento manual e fluxos de pagamento controlados.

O que cada tipo costuma cobrir
NecessidadeAGateways de cartões globaisBProvedores regionaisCCarteiras digitaisDFluxos de pagamento B2B
Cartões internacionaisNormalmente cobertoNormalmente cobertoDepende do provedorNão é o encaixe habitual
Métodos locais e redes bancáriasDepende do provedorNormalmente cobertoDepende do provedorNão é o encaixe habitual
3D SecureNormalmente cobertoDepende do provedorDepende do provedorNão é o encaixe habitual
Reembolsos e anulaçõesNormalmente cobertoDepende do provedorDepende do provedorNormalmente coberto
Várias moedasNormalmente cobertoDepende do provedorDepende do provedorDepende do provedor
Crédito de agente e depósitosNão é o encaixe habitualNão é o encaixe habitualNão é o encaixe habitualNormalmente coberto
  • Normalmente coberto
  • Depende do provedor
  • Não é o encaixe habitual

Gateways no diretório de integrações

Estes nomes vêm do Todas as integrações ao vivo. Contas de comerciante e taxas de transação são acordadas com a empresa de pagamentos que escolher.

Liquidação sem gateway

  • Saldo da carteira
  • Transferência bancária
  • Pagar depois

Para agentes e vendas offline, as reservas também podem ser liquidadas a partir da Carteira de agentes B2B, por transferência bancária ou como pagamento posterior, com cada pagamento registado pela sua equipa.

Âmbito do projeto

O que precisamos para definir a sua integração de pagamentos

Uma conta de provedor clara e um fluxo de transações definido permitem-nos fixar com precisão o âmbito, os testes e a entrega. Assinale o que já tem.

0/5pronto

Lista de âmbito

Caminho para a produção

  1. 01

    Chaves de sandbox

    A plataforma corre contra o ambiente de testes do provedor.

  2. 02

    Casos de teste

    Aprovação, recusa, 3D Secure, anulação e reembolso, cada um contra uma reserva de teste.

  3. 03

    Endpoint de webhooks

    Assinaturas verificadas e cada tipo de evento mapeado para uma ação de reserva.

  4. 04

    Chaves de produção

    Credenciais ao vivo ativadas, com monitorização dos pagamentos falhados.

Planeie o seu checkout

O trabalho no gateway é definido em conjunto com a sua plataforma de reservas. O PHPTRAVELS é uma licença de pagamento único desde 2499 $ com código-fonte incluído, alojada no seu próprio servidor; veja Preços para saber o que cada plano cobre.

Experimentar a demoFale connosco

Os pagamentos ligam-se a

Perguntas de compradores

FAQ sobre integração de gateways de pagamento

O que as agências perguntam antes de adicionar pagamentos online à sua plataforma de reservas.

Fale com vendas

Liga um site ou portal de reservas de viagens a um provedor de pagamentos, para que os clientes paguem durante o checkout e o sistema de reservas acompanhe com segurança a autorização, a captura, os reembolsos e o estado do pagamento de cada reserva.

O PHPTRAVELS suporta uma variedade de gateways globais e regionais, listados no diretório de integrações. A opção certa depende do seu país, da aprovação do comerciante, das moedas, dos métodos de pagamento e da API do provedor disponível para a sua conta.

Sim, quando o gateway escolhido e a conta de comerciante suportam as moedas de apresentação e liquidação de que precisa. A conversão de moeda, a margem e as regras de liquidação são confirmadas durante a definição do âmbito.

O 3D Secure é incluído quando o provedor o suporta e está ativado para a sua conta de comerciante. A integração trata os resultados de autenticação, os redirecionamentos ou desafios incorporados e o estado final do pagamento.

Sim, se a API do provedor os suportar. Reembolsos totais ou parciais, anulações e taxas de cancelamento ficam ligados às referências de reserva e transação relevantes.

A empresa de pagamentos. Você abre a conta de comerciante com o provedor que escolher e acorda as taxas diretamente com ele. O PHPTRAVELS liga a sua plataforma a essa conta com as credenciais que fornecer.

Continue a explorar

Mais sobre a plataforma