Datos adicionales

API le permite pasar datos adicionales en transacciones. Puede incluir datos industriales relacionados con aerolíneas, atención de salud o bien datos relacionados con la transacción (Internet, pedido o incluso datos personalizados). Los datos adicionales que usted pasa en una transacción se almacenan en el Mastercard Payment Gateway contra esa transacción.

Póngase en contacto con su proveedor de servicios de pago para ver si su adquirente admite la entrega de tales datos. Las operaciones de transacción que admiten los datos y los campos de datos obligatorios necesarios para procesar la transacción dependen del adquirente.
Datos de líneas aéreas

Los datos de líneas aéreas incluyen detalles acerca de (un conjunto de) vuelos, referencia de reservas, itinerario, detalles de pasajero, detalles del boleto, etc.

Puede especificar detalles sobre varios pasajeros y varios tramos de viaje asociados con el boleto. La numeración para datos de pasajeros y datos de tramos de viaje comienzan con 0. Por ejemplo, airline.itinerary.leg[0].<fieldname>. Debe usar números consecutivos para los tramos y los datos de pasajeros y no debe omitir ni repetir números.

Los datos de líneas aéreas son aplicables a las operaciones Authorize, Pay, Capture y Refund. Si envía datos de una aerolínea en una transacción inicial y los mismos datos de la aerolínea se aplican a las transacciones posteriores para el pedido, debe enviar los mismos datos de la aerolínea en cada transacción posterior.

Referencia de API de datos de líneas aéreas [REST][NVP]

Datos de Internet del cliente

Los datos de Internet incluyen información sobre la fuente de transacción para transacciones de comercio electrónico. Por ejemplo, el correo electrónico del cliente, la dirección IP, el nombre de host, etc. Esto ayuda al proceso de autorización para transacciones Sin tarjeta física, ya que el emisor puede usarlos para evaluar el riesgo de la transacción.

Los datos de Internet son aplicables solo a las operaciones Authorize y Pay.

Referencia de API de Datos de Internet [REST][NVP]

Datos del pedido y de artículos de línea

Los datos del pedido y de productos de línea incluyen información acerca del pedido y los artículos contenidos en el pedido, lo cual puede proporcionar en la solicitud y elegir su visualización para el pagador (a través de Hosted Checkout o pagos mediante explorador) antes de confirmar el pago. Ciertos datos de pedido y de artículo de línea, cuando se proporcionan en una transacción, pueden calificar la transacción para obtener mejores tasas de intercambio con los titulares de tarjetas corporativas, de negocios o de compra. Para obtener más información, consulte Datos de Nivel II y Nivel III.

  • order.item[n].brand
  • order.item[n].category
  • order.item[n].description
  • order.item[n].name
  • order.item[n].quantity
    Cuando una cantidad decimal se multiplica por cantidades (order.item[n].unitPrice, order.item[n].unitTaxAmount o order.item[n].unitDiscountAmount), y si los decimales del valor calculado exceden las unidades menores de la moneda del pagador; el motor de pagos redondeará el total usando el algoritmo "redondear la mitad al par". Por ejemplo, si 2.555 (cantidad) multiplicado por 3 (precio unitario) da un total de 7.665, y si la moneda del pagador (USD) tiene 2 unidades menores, entonces el monto del artículo redondeado será igual a 7.66.
    Asegúrese de aplicar este redondeo cuando proporcione estos campos de monto en la solicitud.
  • order.item[n].sku
  • order.item[n].unitPrice

    Este monto se multiplica por order.item[n].quantity para calcular el monto total de artículos para el artículo de línea. Si se proporciona order.itemAmount, entonces la suma del monto total de artículos para todos los artículos de línea DEBE igualar el valor de order.itemAmount.

  • order.item[n].unitTaxAmount

    Este monto se multiplica por order.item[n].quantity para calcular el monto total del impuesto para el artículo de línea. Si se proporciona order.taxAmount, entonces la suma del monto total del impuesto para todos los artículos de línea DEBE igualar el valor de order.taxAmount.

  • order.item[n].unitDiscountAmount

    Este monto se multiplica por order.item[n].quantity para calcular el monto total del descuento para el artículo de línea. Si se proporciona order.discount.amount, entonces la suma del monto total de descuento para todos los artículos de línea DEBE igualar el valor de order.discount.amount.

Todos los datos de artículo de línea son opcionales; sin embargo, si proporciona cualquier dato de artículo de línea en una solicitud, entonces DEBE proporcionar al menos los campos order.item[n].name, order.item[n].quantity y order.item[n].unitPrice para dicho artículo.
  • order.currency (obligatorio)
  • order.id
  • order.description
  • order.shippingAndHandlingAmount
  • order.amount (obligatorio)

    Si no proporciona este campo, pero proporciona cualquiera de los montos subtotales (order.itemAmount, order.shippingAndHandlingAmount, order.taxAmount, order.gratuityAmount, order.cashbackAmount) y order.discount.amount, entonces este monto se calcula como la suma de los montos subtotales menos el monto del descuento. Si proporciona tanto este campo como cualquier monto de subtotal, entonces el valor en este campo DEBE igualar el valor calculado.

  • order.itemAmount

    Si no proporciona este campo, pero proporciona cualquier dato de artículo de línea, entonces este monto se calcula como la suma de los montos totales de artículos (order.item[n].unitPrice x order.item[n].quantity) para todos los artículos de línea. Si proporciona tanto este campo como cualquier dato de artículo de línea, entonces el valor en este campo DEBE igualar el valor calculado.

  • order.taxAmount

    Si no proporciona este campo, pero proporciona cualquier dato de artículo de línea, entonces este monto se calcula como la suma del monto total de impuesto (order.item[n].unitTaxAmount x order.item[n].quantity) para todos los artículos de línea. Si proporciona tanto este campo como cualquier dato de artículo de línea, entonces el valor en este campo DEBE igualar el valor calculado.

  • order.discount.amount

    Si no proporciona este campo, pero proporciona cualquier dato de artículo de línea, entonces este monto se calcula como la suma del monto total de descuento (order.item[n].unitDiscountAmount x order.item[n].quantity) para todos los artículos de línea. Si proporciona tanto este campo como cualquier dato de artículo de línea, entonces el valor en este campo DEBE igualar el valor calculado.

  • order.gratuityAmount: el monto que el pagador ha elegido proporcionar como propina, además del monto que está pagando por los bienes o servicios que le está comprando a usted. El monto de la propina está incluido en el monto total del pedido que usted proporciona en order.amount.
  • order.cashbackAmount: el monto que el pagador ha elegido recibir como efectivo, además del monto que está pagando por los bienes o servicios que le está comprando a usted. El monto de la devolución está incluido en el monto total del pedido que usted proporciona en order.amount.

Los datos del pedido y de productos de línea se aplican a Authorize, Pay, Initiate Browser Payment, Confirm Browser Payment, Open Wallet y solicitudes de Hosted Checkout.

order.cashbackAmount y order.gratuityAmount solo se pueden aplicar a las solicitudes Authorize y Pay.

Referencia de API de Datos de pedido [REST][NVP]

Referencia de API de Datos de productos de línea [REST][NVP]

Datos personalizados del adquirente

Los datos personalizados del adquirente incluyen cualquier información adicional solicitada por el adquirente, los cuales no se pueden pasar mediante otros campos de datos disponibles. Los datos personalizados se almacenan en la base de datos, la cual puede usarse para crear reportes externos al Mastercard Payment Gateway. Este campo no debe contener datos confidenciales.

Los datos personalizados del adquirente son aplicables a las operaciones Authorize, Capture, Pay, Refund y Void.

Referencia de API de Datos personalizados del adquirente [REST][NVP]

Datos de Nivel II y Nivel III
Datos personalizados de riesgo

Los datos personalizados de riesgo incluyen cualquier información adicional solicitada por los proveedores de evaluación de riesgos de terceros, los cuales no se pueden pasar mediante otros campos de datos disponibles. Los nombres de los campos personalizados de riesgo se deben ingresar según lo acordado con el proveedor de evaluación de riesgos de terceros. Los campos de datos personalizados de riesgo se devuelven en la respuesta y se pueden usar para reportes y análisis, según se requiera. Los datos confidenciales no se deben incluir en ninguno de los campos de datos personalizados de riesgo.

Los datos personalizados de riesgo son aplicables a las operaciones Authorize, Capture, Pay y Verify.

Referencia de API de Datos personalizados del adquirente [REST][NVP]

Datos personalizados de negocio

Los datos personalizados de negocio incluyen cualquier información adicional de interés para usted, los cuales no se pueden pasar mediante otros campos de datos disponibles. Por ejemplo, puede pasar los datos personalizados de negocio relacionados con una región de ventas usando order.custom.salesRegion, donde 'salesRegion' puede ser cualquier campo definido por usted. Los campos de datos personalizados se devuelven en la respuesta y se pueden usar para reportes y análisis, según se requiera.

Estos datos no son requeridos por el Mastercard Payment Gateway o el adquirente para procesar la transacción y debe incluir datos confidenciales en cualquiera de los campos de datos personalizados de negocio.

Los datos personalizados del negocio son aplicables para las operaciones Authorize, Capture, Pay, Refund, Void, Verify, Referral, Update Authorization, Initiate Browser Payment, Confirm Browser Payment y Hosted Checkout.

Referencia de API de Datos personalizados de negocio [REST][NVP]

Datos de pago de la deuda

Puede enviar transacciones de deuda al motor de pagos si su proveedor de servicios de pago lo ha habilitado para el pago de deudas al menos para un método de financiación (CRÉDITO, DÉBITO o CARGO). Cuando el motor de pagos no pueda determinar el método de financiación para una transacción de pago de deuda, la transacción se rechazará.

Los datos de pago de deudas solo se aplican a los negocios con el código de categoría de negocio 6012 (Instituciones financieras - Mercancías y servicios) o 6051 (Instituciones no financieras - Moneda extranjera, moneda no fiduciaria) que procesan transacciones con tarjeta Visa. Debe proporcionar estos datos para cumplir con las regulaciones para negocios de Visa.

Al enviar una transacción de pago de deuda al motor de pagos, se debe proporcionar un indicador de deuda y es posible que se tenga que proporcionar información adicional sobre el destinatario del pago. Los datos del destinatario de pago incluyen información adicional acerca de la persona que recibe los fondos. Estos datos se pueden enviar al adquirente y se usan para evaluar el riesgo de pago y, de allí, reducir las transacciones fraudulentas.

Además de los campos estándar para una transacción Verify, Authorize o Pay, proporcione los siguientes campos para iniciar una transacción de pago de deuda:

  • debtRepayment.indicator: Indique "verdadero" o "falso". Este campo es obligatorio.
  • debtRepayment.paymentRecipient.accountIdentifier
  • debtRepayment.paymentRecipient.dateOfBirth
  • debtRepayment.paymentRecipient.lastName
  • debtRepayment.paymentRecipient.postcodeZip

Los datos enviados se devuelven en la respuesta de la transacción — la fecha de nacimiento y el identificador de cuenta se enmascararán.

Referencia de API del indicador de pago de deuda[REST][NVP]

Datos de atención de salud

Puede proporcionar datos de atención de salud como datos de artículo de línea para un pedido. Los datos de atención de salud incluyen detalles de artículo para compras de atención de salud como atención visual, dental, prescripción u otro (compras relacionadas con clínicas). Debe proporcionar estos datos solo si le corresponde y si su adquirente lo acepta.

Los datos de atención de salud son compatibles con la versión 36 de la API.
Las compras de atención de salud deben realizarse mediante la tarjeta de beneficios de salud del pagador. Actualmente, la Mastercard Payment Gateway solo procesa datos de atención de salud de Estados Unidos mediante el IIAS (Sistema de aprobación de información de inventario). Según su adquirente, es posible que deba configurarse un código de categoría de negocio (MCC) específico de atención de salud en el vínculo de adquirente del negocio con el Mastercard Payment Gateway. Para obtener más detalles, póngase en contacto con su proveedor de servicios de pago.

Si se le pide que envíe datos de atención de salud, debe proporcionar toda la información siguiente acerca del artículo de atención de salud en la transacción.

  • Categoría de industria. Las categorías industriales admitidas son: HEALTHCARE_VISION, HEALTHCARE_DENTAL, HEALTHCARE_PRESCRIPTION o HEALTHCARE_OTHER.
  • Categoría (opcional): La subcategoría para la categoría de industria. Por ejemplos, gafas con prescripción para HEALTHCARE_VISION
  • Nombre del artículo
  • Precio unitario del artículo
  • Cantidad del artículo
  • Monto del impuesto del artículo

La Mastercard Payment Gateway envía la suma de los montos para todos los artículos de línea que tienen la misma categoría de industria al adquirente. El monto de un artículo de línea es: (Item Unit Price + Item Unit Tax Amount) * Item Quantity. Solo se enviará un registro para cada categoría de industria al adquirente.

La suma de todos los valores de categoría de industria se enviará como el monto de artículo para el pedido. Si el monto del pedido difiere del monto del artículo, la transacción se declinará. La Mastercard Payment Gateway actualmente no admite aprobaciones por un monto parcial para compras de atención de salud.

Se pueden enviar datos de atención de salud en transacciones Authorize, Pay, Capture y Refund.

Referencia de API de Datos de atención de salud[REST][NVP]

Datos del descriptor de declaración

Los datos del descriptor de declaración (también conocidos como datos del descriptor dinámico) incluyen información de contacto proporcionada por usted para imprimirse en estados de cuenta del pagador. Estos datos se envían al adquirente y anula los datos del descriptor registrados en el adquirente. Si proporciona datos del descriptor de declaración parcial en una transacción, el adquirente completará los datos de la declaración mediante los datos del descriptor según se registra en el adquirente.

Como prerrequisito, su perfil del negocio en la Mastercard Payment Gateway debe estar habilitado para el privilegio "Descriptor de declaración".

Si se le pide que envíe datos del descriptor de declaración, puede proporcionar la siguiente información de contacto acerca de su negocio en la transacción.

  • Dirección de negocio
  • Nombre del negocio
  • Número de teléfono del negocio

Los datos enviados se devuelven en la respuesta de la transacción.

Se pueden enviar datos del descriptor de declaración solo en operaciones Authorize, Pay, Capture, Refund, Verify, Update Session y Pay with Session.

Referencia de API de Datos del descriptor de declaración[REST][NVP]

Datos de crucero

Los datos de crucero incluyen información acerca del crucero y los pasajeros que van a bordo, además de datos relacionados con otras industrias, como el alquiler de aerolínea o vehículo, si se adquirieron como parte del paquete del crucero.

Si se le pide que envíe datos de crucero, puede proporcionar la siguiente información acerca del crucero en la transacción.

  • cruise.bookingReference
  • Campos de cruise.company.address.*
  • cruise.company.contact.customerServicePhone
  • cruise.company.contact.companyPhone
  • cruise.travelAgentCode
  • cruise.travelAgentName
  • cruise.travelPackageItems
  • cruise.departureDate
  • cruise.returnDate
  • cruise.shipName
  • Campos de cruise.passenger[n].*

Se pueden enviar datos de crucero en operaciones Authorize, Pay, Capture, Refund, Create Checkout Session y Update Session.

Los datos enviados se devuelven en la respuesta de la transacción.

Referencia de API de Datos de crucero[REST][NVP]

Derechos de autor © 2020 Mastercard