Recuperação de cartão de crédito

Receba um alerta quando o cartão de pagamento do viajante for inválido.

Visão geral

O recurso de Recuperação de Cartão de Crédito foi desenvolvido 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 para reservas de hotel com pagamento na entrega. Isso reduz as falhas de reserva e os cancelamentos por parte dos fornecedores devido a problemas de pagamento.

Esta funcionalidade permite-lhe:

• Receba uma notificação assim que o cartão for considerado inválido após pre-authorization.
• Atualize os dados dos seus cartões de crédito (exceto cartões de crédito virtuais).
• Integre-se perfeitamente aos fluxos de reserva existentes.

Nota: Este recurso está disponível apenas para a API Rapid Lodging.

Do que você vai precisar

Para adicionar a funcionalidade de Recaptura de Cartão de Crédito, siga estes passos:

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

Etapa 2. Inscreva-se e receba as novas notificações itinerary.payment_verification.failure.

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

Como funciona

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

Etapa 1. Quando uma reserva de hotel com pagamento na entrega é criada com cartão de crédito, realizamos 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. Assim que receber a notificação, você poderá recuperar os detalhes da reserva, que incluirão o link para alteração do pagamento. Esse link terá uma aparência semelhante a esta:

Exemplo

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

Passo 4. O link para alteração de pagamento é então disponibilizado para que você forneça os novos dados 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" 
       } 
     } 
   } 
 ] 
}

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

O link para pagamento de troco permanecerá ativo por períodos variáveis, dependendo da reserva: Para datas check-in com mais de 48 horas de antecedência, o link ficará ativo por 24 horas. Se a hashtag check-in for acessada em até 48 horas, o link ficará ativo por 12 horas. Para atender às reservas do last-minute de 10 noites ou mais, um link para alteração de pagamento ficará ativo por 2 horas após a reserva. Caso as novas informações de pagamento não sejam fornecidas em até 24 horas, a reserva poderá ser cancelada pelo provedor.