Recuperação de Cartão de Crédito

Receba um alerta quando um cartão de pagamento de viagem for inválido

Visão geral

O recurso Recaptura de Cartão de Crédito foi criado para ajudar sua organização a substituir informações inválidas de cartão de crédito usadas para pagar uma reserva por informações válidas de cartão de crédito. Isso reduz falhas de reserva e cancelamentos de fornecedores devido a problemas de pagamento.

Este recurso permite que você:

• Receba uma notificação assim que o cartão for exibido como inválido após pre-authorization.
• Atualizar detalhes de cartões de crédito (excluindo cartões de crédito virtuais).
• Integre-se perfeitamente aos fluxos de reservas existentes.

Observação: Este recurso atualmente é oferecido apenas para a API de hospedagem rápida.

Do que você vai precisar

Para adicionar o recurso de recuperação de cartão de crédito, siga estas etapas:

Etapa 1. Adote a API de Notificação, caso ainda não a esteja usando. Esta é uma recomendação, a capacidade de ajustar as informações do cartão de crédito faz parte da API Gerenciar Reservas, mas sem esse serviço ativado você não será notificado quando uma alteração for necessária.

Etapa 2. Assine e consuma o novo evento de notificação itinerary.payment_verification.failure.

Etapa 3. Use o ponto de extremidade payment_changepara enviar os detalhes atualizados do instrumento de pagamento.

Como funciona

Quando uma reserva for elegível para uma alteração de pagamento (quando um cartão de crédito inválido for usado), o link payment_changeaparecerá na resposta Recuperar API . Você pode usar o link de atualização ou incorporá-lo ao seu fluxo de reserva para que o viajante possa fazer suas próprias alterações.

Etapa 1. Quando uma reserva de retirada em hotel é criada com um cartão de crédito, executaremos uma verificação pre-authorization no cartão de crédito usado para fazer a reserva.

Etapa 2. Se o cartão utilizado for inválido, você receberá uma notificação como esta:

Exemplo

{ 
 "affiliate_reference_id": "123abc", 
 "email": "test@test.com", 
 "event_id": "86e91a86-ca04-4928-b177-f410879b99a1", 
 "event_time": "2025-06-11T21:56:40.242Z", 
 "event_type": "itinerary.payment_verification.failure", 
 "itinerary_id": "980339849842", 
 "message": "Payment validation has failed during Supplier initiated validation." 
}

Etapa 3. Depois de receber uma notificação, você poderá recuperar os detalhes da reserva, que incluirão o link de alteração do pagamento. Esse link será parecido com este:

Exemplo

{ 
    “links”: { 
        “payment_change”: { 
            “method”: “PUT”, 
            “href”: “/v3/itineraries/7090158334868/payment?token=REhZAQsABQsHQhEDTVtVC0w6WA1UXF98IiF8ZmF7KH0oFwtWR1oMAloQZgtSOUFTWgpHAFllMS5hfDBga0BVR0dCWF5TQW9GUhFHDFtaPl9cDHFwczYkdnwhb2RwazZ3fjdzFUQEQBBRWwo-XVwPAA9XB1MDVghIC1MGVBlSBlABGwlXVQMeAQMAUAdQUwlQXwcMFxJKDkgERxVLaw8HDw0EBVBWBVQAEwZUCFFBVUYEVG4WC1sHXgMEUFAcBQsUAwE2BlQTCnlQBxwAdVQGFwEIVQEKBwBTBW4WB11BC0cXG20HCgFVXCR6RVRVFVgHBQQeFFZKWQZaEmoXA0YTURcBUAkXQEAGERZQFEBXAEc-QRNXA15aXWhbAV5XBwxcBVMRDlVAWwdBCFZeawZbUQ9fVltZVRVXFFIDS25QAQkGQl1ZAwpcDQlfDVYRVQQAGlILEQlWHFBXCR97CgFTCktED18KDlFWBQEGVwxQ” 
        }

Passo 4. O link de alteração de pagamento é então disponibilizado para fornecer os novos detalhes do cartão de crédito. Enquanto a alteração estiver sendo feita, o provedor não poderá cancelar a reserva.

Exemplo

{ 
 "change_reference_id": "JohnCCTest", 
 "payments": [ 
   { 
     "type": "customer_card", 
     "number": "4111111111111111", 
     "security_code": "123", 
     "expiration_month": "08", 
     "expiration_year": "2029", 
     "billing_contact": { 
       "given_name": "JohnUPDATE", 
       "family_name": "SmithUPDATE", 
       "address": { 
         "line_1": "555 1st St", 
         "line_2": "10th Floor", 
         "line_3": "Unit 12", 
         "city": "Seattle", 
         "state_province_code": "WA", 
         "postal_code": "98121", 
         "country_code": "US" 
       } 
     } 
   } 
 ] 
}

Se os novos dados do cartão fornecidos também forem inválidos, o processo será repetido até que um instrumento de pagamento válido seja fornecido.

O link de pagamento de troco permanecerá ativo por períodos variados, dependendo da reserva: para datas check-in com mais de 48 horas de distância, o link ficará ativo por 24 horas. Se check-in estiver dentro de 48 horas, o link ficará ativo por 12 horas. Para reservas de last-minute para 10 ou mais noites, um link de pagamento de troco ficará ativo por 2 horas após a reserva. Se novas informações de pagamento não forem fornecidas dentro de 24 horas, a reserva poderá ser cancelada pelo provedor.