Integration Types
Otras características
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
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 Mastercard Gateway contra esa transacción.
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.
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.
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
order.item[n].unitPrice
, order.item[n].unitTaxAmount
, o bien 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.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
.
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]
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 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]
Consulte Datos de Nivel II y Nivel III.
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]
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 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 del negocio [REST][NVP]
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 financiamiento (CRÉDITO, DÉBITO o CARGO). Cuando el motor de pagos no pueda determinar el método de financiamiento para una transacción de pago de deuda, la transacción se rechazará.
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, con lo que se reducen 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:
order.purchaseType
: establezca este campo en DEBT_REPAYMENT. 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.
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.
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.
La Mastercard 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 rechazará.
Se pueden enviar datos de atención de salud en transacciones Authorize, Pay, Capture y Refund.
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.
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.
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]
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
cruise.company.address.*
cruise.company.contact.customerServicePhone
cruise.company.contact.companyPhone
cruise.travelAgentCode
cruise.travelAgentName
cruise.travelPackageItems
cruise.departureDate
cruise.returnDate
cruise.shipName
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.
Si usted es un negocio que envía transacciones que implican la compra de criptomonedas o valores de alto riesgo, debe informar al emisor proporcionando ciertos indicadores en su solicitud de transacción al motor de pagos.
Además de los campos estándar para una transacción Verify, Authorize, Pay, proporcione el campo order.purchaseType
para indicar una transacción con valores de alto riesgo o criptomoneda. Puede configurar el campo en cualquiera de los siguientes valores:
CRYPTOCURRENCY
: si usted es un negocio con MCC 6051 (Cuasi efectivo: negocio o instituciones no financieras – moneda extranjera, moneda no fiduciaria) y esta transacción es para la compra de criptomoneda.HIGH_RISK_SECURITIES
: si el suyo es un negocio con MCC 6211 (Valores: agentes/corredores) y esta transacción es para la compra de valores de alto riesgo.Referencia de API de Datos de indicadores de valores de alto riesgo y criptomonedas[REST][NVP]
Las transacciones que implican debitar dinero de una cuenta para abonarlo en otra cuenta se denominan transacciones de financiamiento de cuentas en terminología de Mastercard Gateway. El destinatario puede ser la misma persona, otra persona o una organización. Si su Organización de servicios de negocios (MSO) lo habilita para esta funcionalidad, usted puede facilitar los siguientes tipos de transacciones de financiamiento de cuentas para sus clientes:
Los datos de transacciones de financiamiento de cuentas (AFT) incluyen información sobre el tipo de remitente, el tipo de destinatario, el tipo de cuenta del destinatario, el método de financiamiento de la cuenta y la finalidad de su financiamiento. También puede incluir otros detalles del destinatario. Cuando se le solicite que envíe datos de transacciones de financiamiento de cuentas, según el tipo de transacción que envíe, debe proporcionar toda la información siguiente, o parte de ella, sobre la transacción.
accountFunding.senderType:
este campo puede adoptar valores como PERSON, COMMERCIAL_ORGANIZATION, NON_PROFIT_ORGANIZATION y GOVERNMENT.accountFunding.senderIsRecipient:
define si el remitente y el destinatario en la transacción de financiamiento de cuentas son la misma persona o no. Si no se proporciona ningún valor, este campo adopta el valor predeterminado FALSE.accountFunding.recipient.account.fundingMethod:
este campo puede adoptar valores como CHARGE, CREDIT y DEBIT. Si no se proporciona ningún valor, este campo adopta el valor predeterminado, UNKNOWN.accountFunding.recipient.stateProvinceCode:
El código de estado o provincia del destinatario. El valor debe coincidir con la segunda parte del código ISO 3166-2. Por ejemplo:
accountFunding.recipient.account:
detalles sobre la cuenta del destinatario que posteriormente recibirá los fondos que se cargan al remitente en esta transacción.accountFunding.purpose:
este campo puede adoptar valores como CRYPTOCURRENCY_PURCHASE, MERCHANT_SETTLEMENT y PAYROLL. Si no se proporciona ningún valor, adopta el valor predeterminado, OTHER.accountFunding.recipient:
detalles sobre el destinatario que recibirá los fondos.accountFunding.recipient.account.identifierType:
este campo puede adoptar valores como CARD_NUMBER, BANK_ACCOUNT_NATIONAL, BANK_ACCOUNT_BIC, BANK_ACCOUNT_IBAN, EMAIL_ADDRESS, PHONE_NUMBER, SOCIAL_NETWORK_PROFILE_ID y STAGED_WALLET_USER_ID. Si no se proporciona ningún valor, adopta el valor predeterminado, OTHER.accountFunding.recipient.account.identifier:
el identificador de la cuenta del destinatario del pago, por ejemplo, número de tarjeta o número de cuenta bancaria.accountFunding.recipient.firstName:
nombre del destinatario del pago.accountFunding.recipient.lastName:
apellido del destinatario del pago.accountFunding.recipient.country:
país del destinatario del pago.accountFunding.recipient.postCodeZip:
código postal del destinatario del pago.accountFunding.recipient.dateOfBirth:
fecha de nacimiento del destinatario del pago en formato aaaa-mm-dd.accountFunding.reference:
referencia para la transacción de financiamiento de cuentas. Esta referencia la genera Mastercard Payment Gateway.Los datos de las transacciones de financiamiento de cuentas se pueden enviar en las operaciones Authorize, Authenticate_Payer, Capture, Create_Checkout_Session, Pay, Refund, Standalone Capture, Standalone Refund, Update Session y Verify. Los datos enviados se devuelven en la respuesta de la transacción.
Referencia de API de datos de transacciones de financiamiento de cuentas[REST][NVP]
Seleccione el MCC correspondiente para el Indicador de tipo de transacción si la institución de origen está registrada para el servicio Mastercard MoneySend y envía el mensaje de solicitud Authorization para transacciones de fondos y reembolsos de transacciones de fondos. Para obtener más información, consulte el Folleto de referencia rápida en MC Connect > Centro de recursos técnicos (TRC) o comuníquese con su banco adquirente para obtener los MCC recomendados para diferentes tipos de transacciones.
Integración de transacciones de financiamiento de cuentasEnvíe el indicador de tipo de transacción correcto mientras se integra con transacciones de financiamiento de cuenta al garantizar el MCC correspondiente y el campo de solicitud correcto en la API. La MSO lo habilitó para enviar transacciones de fondos de cuenta y configuró qué tipos de transacciones de financiamiento de cuentas puede enviar. Para obtener más información sobre el MCC, los campos de solicitud y la configuración de la MSO, consulte la documentación de integración de MPGS o comuníquese con Soporte de MPGS para solicitar ayuda adicional.
Esta tabla describe los MCC para transacciones de financiamiento iniciadas por los clientes.
Identificador de tipo de transacción
|
MCC 4829 - Transferencia de dinero
|
MCC 6540 - Transacciones de financiamiento
|
MCC 6538 - Transacciones de financiamiento para MoneySend
|
Transferencia general de persona a persona |
Válido para F07 |
Válido para F07 |
Válido para C07 |
Transferencia de persona a persona a la cuenta de la tarjeta |
Válido para F08 |
Válido para F08 |
- |
Esta tabla describe los MCC para transferencias iniciadas por clientes u organizaciones.
Identificador de tipo de transacción |
MCC 4829 - Transferencia de dinero |
MCC 6540 - Transacciones de financiamiento |
MCC 6538 - Transacciones de financiamiento para MoneySend |
Transferencia a la propia cuenta de débito o prepago |
Válido para F64 |
Válido para F64 |
- |
Pago de factura de tarjeta de crédito propia |
Válido para F54 |
Válido para F54 |
Válido para C54 |
Transferencia a la propia cuenta de billetera digital escalonada |
Válido para F61 |
Válido para F61 |
- |
Transferencia general a la propia cuenta |
Válido para F52 |
Válido para F52 |
Válido para C52 |
Transferencia general a la propia cuenta iniciada por organizaciones |
Válido para F52 |
Válido para F52 |
Válido para C52 |
Transferencia a la propia cuenta de billetera digital escalonada iniciada por organizaciones |
Válido para F61 |
Válido para F61 |
- |
Transferencia a la propia cuenta de tarjeta de débito o prepago iniciada por organizaciones |
Válido para F64 |
Válido para F64 |
- |
Pago de factura de tarjeta de crédito propia iniciado por organizaciones |
Válido para F54 |
Válido para F54 |
- |
Desembolso comercial |
Válido para F55 |
Válido para F55 |
Válido para C55 |
Desembolso gubernamental/sin fines de lucro |
- |
- |
Válido para C56 |
Liquidación rápida de negocios |
- |
- |
Válido para C57 |
Transferencia general de empresa a empresa |
Válido para F65 |
Válido para F65 |
Válido para C65 |