- Pautas de integración
- Características soportadas (métodos de pago)
- Pagos móviles sin contacto
Pagos móviles sin contacto
Los pagos móviles sin contacto hacen referencia a transacciones autenticadas utilizando un dispositivo móvil (p. ej., smartphone, tableta, smartwatch) en un terminal sin contacto. El terminal lee los datos de la tarjeta desde un chip sin contacto que hay dentro del dispositivo móvil.
Una tarjeta de débito/crédito agregada a una cuenta del dispositivo móvil del pagador se tokeniza y se asigna al dispositivo un identificador específico del dispositivo que se conoce como DPAN (PAN del dispositivo). El procesador de pagos convierte el DPAN en el FPAN (PAN de financiamiento) correspondiente.
El FPAN es el número de cuenta principal (PAN) de la tarjeta del pagador. Este es el número de tarjeta real que se registra contra el DPAN y se utiliza para procesar la transacción. Un FPAN puede estar asociado con varios DPAN.
Un terminal sin contacto inicia un pago móvil sin contacto y lo envía al motor de pagos como una transacción Capture, Authorize, Pay o Refund. Por ejemplo, las transacciones que están autorizadas sin conexión mediante el chip del dispositivo móvil se enviarán solo como Capture, mientras que las transacciones que requieren autorización del emisor utilizarán una transacción Authorize en línea y, a continuación, una transacción Capture.
Prerrequisitos
- Your payment service provider y su adquirente deben habilitarlo para las transacciones con titular de la tarjeta presente.
- Se debe disponer de un terminal habilitado para los pagos sin contacto.
Campos comunes utilizados para las transacciones móviles sin contacto
Los siguientes campos de API son pertinentes para los pagos móviles sin contacto por medio del motor de pagos.
transaction.source=CARD_PRESENT
: si no proporciona este campo, se utilizará la fuente de transacción predeterminada que your payment service provider configuró en su vínculo de adquirente. [REST][NVP]sourceOfFunds.provided.card.emvRequest
: Proporcione las etiquetas EMV leídas desde el chip y que sean compatibles con el motor de pagos. Consulte Campos de transacción EMV.
La etiqueta 9F1C (identificador del terminal) se debe proporcionar en este campo.
Asegúrese de que los valores de los siguientes campos de terminal de punto de venta se configuren correctamente, según cómo el terminal generó los datos de la tarjeta para la transacción. Si los datos de estos campos están disponibles, siempre proporciónelos. El motor de pagos pasará los datos al adquirente, según sea necesario. Si el adquirente requiere un campo y no está presente, la transacción no se podrá realizar.
posTerminal.address
posTerminal.attended
: si no proporciona este campo, el motor de pagos estableceUNKNOWN_OR_UNSPECIFIED
como valor predeterminado.posTerminal.authorizationMethod
posTerminal.cardHolderActivated
: si no proporciona este campo, el motor de pagos estableceNOT_CARDHOLDER_ACTIVATED
como valor predeterminado.posTerminal.inputCapability
: este campo es obligatorio para las transacciones EMV.posTerminal.location
: este campo es obligatorio para las transacciones EMV.posTerminal.panEntryMode
posTerminal.pinEntryCapability
posTerminal.onlineReasonCode
: este campo es obligatorio para las transacciones de chip y alternativa de chip (incluyendo reversiones) para todas las transacciones en línea.posTerminal.serialNumber
order.gratuityAmount
: proporcione este campo si el pago incluye una cantidad de propina.
[REST][NVP]order.cashbackAmount
: proporcione este campo si el pago incluye un monto de devolución.
[REST][NVP]order.cashAdvance
: proporcione este campo si el pago incluye un monto de anticipo en efectivo.
[REST][NVP]
Referencia de API de Terminal de punto de venta [REST][NVP]
Respuesta de la transacción
Si la asignación de DPAN a FPAN es correcta, la respuesta RETRIEVE_TRANSACTION para un pago móvil sin contacto devolverá lo siguiente:
- FPAN enmascarado de 6.4, cuando esté disponible del adquirente, en el campo
sourceOfFunds.provided.card.number
. Para los negocios de transporte, es posible que se devuelva un FPAN completo. Consulte Pagos de tarifas de transporte totalizados. - Vencimiento de FPAN, cuando esté disponible del adquirente, en el campo
sourceOfFunds.provided.card.expiry
. - DPAN enmascarado en el campo
sourceOfFunds.provided.card.deviceSpecificNumber
Si está configurado para recibir PAN sin enmascarar en la respuesta de la transacción, el motor de pagos devolverá un DPAN y un FPAN sin enmascarar (ya sea 6.4 enmascarado o sin enmascarar, dependiendo del soporte del adquirente).