Recuperación de importes de tarjetas de crédito

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

Información general

La función «Recuperación de datos de tarjeta de crédito» está pensada para ayudar a tu organización a sustituir los datos de tarjeta de crédito no válidos que se han usado para Pagar una reserva por datos válidos, en el caso de las reservas con cargo al hotel. Esto reduce los fallos en las reservas y Las cancelaciones de los 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 (excepto las tarjetas de crédito virtuales).
Se integra a la perfección con los procesos de reserva que ya tienes.

Nota:. Por ahora, esta función solo está disponible para la API de Rapid Lodging.

Lo que necesitará

Para añadir la función de recuperación de datos de tarjetas de crédito, sigue estos pasos:

Paso 1. Adopta la API de notificaciones, si aún no la estás usando. Esto es solo una recomendación: la posibilidad de modificar los datos de la tarjeta de crédito forma parte de la API de gestión de reservas, pero si no tienes este servicio activado, no recibirás ninguna notificación cuando sea necesario realizar un cambio.

>> Más información sobre la API de notificaciones

Paso 2. Suscríbete al nuevo evento de notificación y utilízalo itinerary.payment_verification.failure.

Paso 3. Usa el punto final « payment_change » para enviar los datos actualizados del instrumento de pago.

Funcionamiento

Cuando una reserva cumple los requisitos para un cambio de forma de pago (por ejemplo, si se ha utilizado una tarjeta de crédito no válida), aparecerá el enlace « payment_change » en la sección «Recuperar» de la respuesta de «Gestionar reserva». Puedes usar el enlace de actualización tú mismo o integrarlo en tu proceso de reserva para que el viajero pueda hacer sus propios cambios.

Paso 1. Cuando se crea una reserva con pago en el hotel mediante tarjeta de crédito, comprobamos que la tarjeta utilizada para hacer la reserva no esté en la lista de « pre-authorization ».

Nota:

En el caso de las reservas de « Expedia », solo se comparte con el proveedor la tarjeta « Expedia ». Una tarjeta « Expedia Virtual Card » no necesita « pre-authorization, », y tampoco las tarjetas VCC que te dan los afiliados a través del servicio «hotel collect».

Paso 2. Si la tarjeta que usas no es válida, te aparecerá una notificación como esta:

Ejemplo

{ 
 "affiliate_reference_id": "123abc", 
 "email": "test@test.com", 
 "event_id": "86e91a86-ca04-4928-b177-f410879b99a1", 
 "event_time": "2027-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. En cuanto recibas una notificación, podrás consultar los detalles de la reserva, donde encontrarás el enlace para modificar el pago. Ese enlace tendrá un aspecto más o menos así:

Ejemplo

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

Paso 4. A continuación, aparece el enlace para modificar el método de pago, donde puedes introducir 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 datos de la nueva tarjeta que nos facilites tampoco son válidos, el proceso se repetirá hasta que nos facilites un medio de pago válido.

El enlace para pagar el cambio estará activo durante un tiempo que varía según la reserva: para las fechas de « check-in » que estén a más de 48 horas, el enlace estará activo durante 24 horas. Si « check-in » se celebra en las próximas 48 horas, el enlace estará activo durante 12 horas. Para las reservas de « last-minute » de 10 noches o más, habrá un enlace para pagar el cambio que estará activo durante 2 horas después de hacer la reserva. Si no se facilitan los nuevos datos de pago en un plazo de 24 horas, el proveedor podrá cancelar la reserva.