- Pautas de integración
- Características soportadas
- Pagos de tarifas de transporte totalizados
Pagos de tarifas de transporte totalizados
Los pagos de tarifas de transporte totalizados se refieren a las transacciones sin contacto que los negocios de transporte envían para englobar las tarifas de transacciones del pagador en varios viajes durante un período de tiempo determinado y hasta un monto determinado.
Para enviar un pago de tarifa de transporte total, su Código de categoría de negocio (MCC) debe ser uno de los siguientes:
- 4111 (Transporte: pasajero suburbano y pasajero local, incluidos los transbordadores)
- 4131 (líneas de autobús)
- 4784 (tarifas de puente y carretera, peajes)
- 7523 (Estacionamiento de automóviles y garajes)
Los pagos de tarifas de transporte totales solo se admiten en tarjetas Mastercard (excepto tarjetas Maestro), Visa y American Express.
Pagos de tarifas de transporte totalizados
-
Envíe una solicitud de autorización nominal al emisor, con los siguientes detalles:
order.amount: ingrese $1 o el monto mínimo de la tarifa.transaction.transit.fareCollection=AGGREGATION_ACROSS_TRIPS
Si se proporciona este campo y este valor, la autorización se marca como una autorización diferida. Para obtener más información, consulte Aplazamientos de autorizaciones.
transaction.transit.transportationMode: ingrese el medio de transporte que el pagador utilizó para el primer viaje.sourceOfFunds.provided.card.emvRequest: ingrese las etiquetas EMV como se leyeron del chip sin contacto, y que sean compatibles con el motor de pagos. Consulte Campos de transacción EMV.
Solicitud de ejemploAquí hay un ejemplo (en REST) para una autorización nominal para totalizar tarifas de transporte.
URL https://afs.gateway.mastercard.com/api/rest/version/72/merchant/{merchantId}/order/{orderid}/transaction/{transactionid} Método HTTP PUT { "sourceOfFunds": { "type": "CARD", "provided": { "card": { "emvRequest": { "9F02": "123456738012", "5F2A": "125", "9F1A":"321", "9F27":"e1", "95": "123a567e90", "9A": "654321", "9F36": "1e34", "9C": "21", "9F26": "0123456789abcdef", "82": "12f4", "9F37": "F123f986" }, } } }, "apiOperation": "AUTHORIZE", "order": { "currency": "AUD", "amount": "1" }, "posTerminal": { "cardholderActivated": "NOT_CARDHOLDER_ACTIVATED", "inputCapability": "CONTACTLESS_CHIP", "panEntryMode" : "CONTACTLESS", "pinEntryCapability" : "PIN_NOT_SUPPORTED", "location": "MERCHANT_TERMINAL_OFF_PREMISES", "lane": "test", "attended": "UNATTENDED" }, "transaction": { "transit": { "fareCollection": "AGGREGATION_ACROSS_TRIPS", "transportationMode": "TRAIN" }, "source": "CARD_PRESENT", "frequency": "SINGLE" } } -
Si la transacción de autorización se realizó correctamente, puede enviar una transacción Capture contra este pedido para totalizar tarifas de viaje posteriores para esta tarjeta al final del período de facturación, por ejemplo, un día.
Integración de EMV de sin contactoorder.id: el identificador de pedido de la transacción de autorización realizada correctamente.transaction.id: el identificador de transacción para la transacción Capture.transaction.amount: el monto total en todos los viajes dentro de un período determinado.transaction.currency
No es necesario volver a enviar los detalles de pago en la transacción Capture ya que el motor de pagos los almacenará contra el pedido.
Integración móvil sin contactosourceOfFunds.provided.card.number: el FPAN completo asociado con el DPAN, según lo que devuelve el esquema de tarjeta en la respuesta de autorización, donde el mapeo del FPAN se realizó correctamente y donde el adquirente lo proporcionó.sourceOfFunds.provided.card.expiry: la fecha de vencimiento del FPAN.order.id: el identificador de pedido de la transacción de autorización realizada correctamente.transaction.id: el identificador de transacción para la transacción Capture.transaction.amount: el monto total en todos los viajes dentro de un período determinado.transaction.currency
Cuando la asignación de DPAN a FPAN se realiza correctamente, se devuelve el DPAN en el campo
sourceOfFunds.provided.card.deviceSpecificNumberen la respuesta de autorización para que pueda identificar la transacción como una transacción móvil sin contacto. Si está configurado para recibir PAN sin enmascarar en la respuesta de transacción, el motor de pagos devolverá un DPAN sin enmascarar.
Recuperación de deuda para pagos de tarifas de transporte totalizados
Si la autorización para un pago de tarifa de transporte totalizado falla, puede intentar un pago de recuperación de deuda para borrar cualquier deuda pendiente incurrida por el pagador y permitir que el pagador reanude el viaje.
Envíe una solicitud de transacción Authorize en el pedido con la autorización fallida o en un nuevo pedido con:
transaction.transitFareCollection=DEBT_RECOVERYtransaction.transit.transportationMode=<el medio de transporte que el pagador utilizó para el primer viaje>order.amount=<fare for single trip only>- detalles de pago, incluido el número de tarjeta, la fecha de vencimiento, etc.
Si desea tokenizar los detalles de pago (número de tarjeta, fecha de vencimiento, etc.) al enviar la autorización inicial para el pago de la tarifa de transporte total, utilice el token de la autorización para el pago de recuperación de deuda, en lugar de los detalles del pago.
sourceOfFunds.provided.card.number: el FPAN completo asociado con el DPAN, según lo que devuelve el esquema de tarjeta en la respuesta de autorización, donde el mapeo del FPAN se realizó correctamente y donde el adquirente lo proporcionó.sourceOfFunds.provided.card.expiry: la fecha de vencimiento del FPAN.transaction.transitFareCollection=DEBT_RECOVERYtransaction.transit.transportationMode: el medio de transporte que el pagador utilizó para el primer viaje.order.amount: tarifa para un solo viaje únicamente.
Cuando la asignación de DPAN a FPAN se realiza correctamente, se devuelve el DPAN en sourceOfFunds.provided.card.deviceSpecificNumber para que pueda identificar la transacción como una transacción móvil sin contacto. Si solicita que se devuelva un PAN sin enmascarar en la respuesta de transacción, el motor de pagos devolverá un DPAN sin enmascarar.