Recuperación de la tarjeta de crédito

Recibe una alerta cuando una tarjeta de pago de viajero no sea válida

Información general

La función Recaptura de tarjeta de crédito está diseñada para ayudar a tu organización a sustituir la información de tarjeta de crédito no válida utilizada para pagar una reserva por información de tarjeta de crédito válida. Esto reduce los fallos en las reservas y las cancelaciones de proveedores por problemas de pago.

Esta función te permite

Recibe una notificación en cuanto la tarjeta aparezca como no válida después de pre-authorization.
Actualiza los datos de las tarjetas de crédito (excluidas las tarjetas de crédito virtuales).
Integrarse perfectamente con los flujos de reservas existentes.

Nota: Esta función sólo se ofrece actualmente para la API de Alojamiento Rápido.

Lo que necesitará

Para añadir la función de Recaptura de Tarjeta de Crédito, sigue estos pasos:

Paso 1. Adopta la API de notificación , si aún no la utilizas. Esto es una recomendación, la posibilidad de ajustar la información de la tarjeta de crédito forma parte de la API de Gestión de Reservas, pero sin este servicio activado no se te notificará cuando sea necesario un cambio.

Paso 2. Suscribirse y consumir el nuevo evento de notificación itinerary.payment_verification.failure.

Paso 3. Utiliza el punto final payment_changepara enviar los datos actualizados del instrumento de pago.

Funcionamiento

Cuando una reserva es apta para un cambio de pago (cuando se utiliza una tarjeta de crédito no válida), aparecerá el enlace payment_changeen la respuesta Retrieve API . Puedes utilizar tú mismo el enlace de actualización o incrustarlo en tu flujo de reservas para que el viajero pueda hacer sus propios cambios.

Paso 1. Cuando se crea una reserva de hotel a cobro revertido con una tarjeta de crédito, realizaremos una comprobación en pre-authorization de la tarjeta de crédito utilizada para hacer la reserva.

Nota:

En las reservas de Expedia Collect, sólo se comparte la tarjeta Expedia con el proveedor. Un Expedia Virtual Card no necesita pre-authorization, y tampoco las tarjetas VCC que proporcionan los afiliados en los hoteles por cobrar.

Paso 2. Si la tarjeta utilizada no es válida, recibirás una notificación como ésta:

Ejemplo

{ 
 "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." 
}

Paso 3. Una vez que recibas la notificación, podrás recuperar los detalles de la reserva, que incluirán el enlace de cambio de pago. Ese enlace tendrá un aspecto parecido al siguiente

Ejemplo

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

Paso 4. A continuación, se habilita el enlace de cambio de pago para proporcionar los nuevos datos de la tarjeta de crédito. Mientras se realiza el cambio, el proveedor no podrá cancelar la reserva.

Ejemplo

{ 
 "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" 
       } 
     } 
   } 
 ] 
}

Si los nuevos datos de la tarjeta facilitados tampoco son válidos, el proceso se repetirá hasta que se haya facilitado un instrumento de pago válido.

El enlace de cambio de pago permanecerá activo durante un tiempo variable, dependiendo de la reserva: Para las fechas de check-in en las que falten más de 48 horas, el enlace estará activo durante 24 horas. Si check-in se encuentra en un plazo de 48 horas, el enlace estará activo durante 12 horas. Para facilitar las reservas en last-minute de 10 o más noches, el enlace de cambio de pago estará activo durante 2 horas después de la reserva. Si no se facilitan nuevos datos de pago en un plazo de 24 horas, el proveedor podrá cancelar la reserva.