El Mastercard Payment Gateway ofrece soporte para que su proveedor de servicios le facilite información sobre financiamiento y tarifas. La responsabilidad de la exactitud de esta información recae en el proveedor del servicio.
La información sobre financiamiento y tarifas se refiere al movimiento real de fondos del proveedor de servicios hacia su cuenta bancaria. El financiamiento puede ser positivo (financiamiento de una transacción Payment o Capture) o negativo (financiamiento de una transacción Refund). Las tarifas siempre son negativas. Es decir, se debitan de su cuenta bancaria.
La información sobre financiamiento y tarifas solo está disponible en los pedidos y transacciones sobre los cuales su proveedor de servicios facilitó la información al Mastercard Payment Gateway.
Si su proveedor de servicios facilita información sobre financiamiento y tarifas, puede recuperar esta información desde el Mastercard Payment Gateway mediante:
RETRIEVE_ORDER
o RETRIEVE_TRANSACTION
También puede suscribirse a las Notificaciones de Webhook para obtener información sobre las actualizaciones.
La información sobre el financiamiento de una transacción se registra contra la transacción, incluyendo el monto del financiamiento y la moneda, en los siguientes campos API:
transaction.funding.amount
transaction.funding.currency
Financiamiento para:
Según la información de financiamiento de una transacción, el estado del financiamiento de la transacción se actualiza del siguiente modo:
Campo API | Estado | Descripción |
---|---|---|
transaction.funding.status |
NOT_SUPPORTED |
La transacción se liquidó con una institución que no envía información de financiamiento al Mastercard Payment Gateway. |
NON_FUNDED |
La transacción no puede resultar en la transferencia de dinero a su cuenta o desde ella. Esto se aplica a las transacciones VERIFICATION o AUTHORIZATION . |
|
IN_PROGRESS |
La transacción puede resultar en la transferencia de dinero a su cuenta o desde ella, pero aún no se ha realizado. Este suele ser un estado transitorio. | |
FUNDING_ASSURED |
Se garantiza que la transacción se liquidará, pero aún no se ha realizado. | |
FUNDED |
La transacción ya ingresó el dinero en su cuenta. | |
FUNDING_ON_HOLD |
La transacción podría resultar en la transferencia de dinero hacia su cuenta o desde ella; sin embargo, el proveedor financiero no puede completar la transferencia de fondos. Este puede ser un estado transitorio. | |
FUNDING_FAILED |
La transacción podría dar lugar a la transferencia de dinero a su cuenta o desde ella, pero el proveedor de servicios aún no ha recibido fondos del pagador. En caso de un reembolso, el proveedor de servicios no pudo transferir los fondos al pagador. | |
FUNDING_ADJUSTED |
Un monto previamente financiado para el pedido se ajustó. El ajuste pudo ser un crédito o un débito a su cuenta. |
El Mastercard Payment Gateway facilitará, por lo menos, una de las siguientes fechas sobre la ejecución pasada o futura del financiamiento:
Campo API | Descripción |
---|---|
transaction.funding.date |
La fecha en que los fondos llegan a su cuenta bancaria. Se completa solo cuando es un hecho seguro. |
transaction.funding.initiatedDate |
La fecha en que el adquirente inició la transferencia de fondos a su cuenta bancaria. Solo se completa si no están disponibles ni la fecha de inicio ni la fecha de financiamiento real. |
transaction.funding.estimatedDate |
La fecha en que el adquirente estima que los fondos se depositarán en su cuenta bancaria. Solo se completa cuando se sabe con certeza la fecha, pero la fecha en que los fondos se liquidarán en su cuenta (transaction.funding.date ) se desconoce. |
Las fechas que se facilitan dependen de la información que el adquirente facilite. Sin embargo:
transaction.acquirer.timeZone
).El Mastercard Payment Gateway actualizará el estado de financiamiento de un pedido cuando reciba información del adquirente con respecto a la ejecución del financiamiento de una transacción.
Un estado de financiamiento de transacción de FUNDING_ASSURED
o FUNDED
indica que es seguro enviar las mercancías al pagador.
Si el financiamiento para una transacción Payment o Capture falló, el adquirente puede retirar los fondos. Es decir, debitarlos de su cuenta. En este caso, se crea una transacción con el tipo FUNDING
sobre el pedido de la transacción, cuyo financiamiento falló. Esta transacción tendrá un monto de transacción de cero y la misma moneda que utilizó para el financiamiento (moneda de liquidación). El monto del financiamiento será negativo.
Si el financiamiento para una transacción Refund falló, el adquirente puede devolverle los fondos. Por ejemplo, cuando los fondos no se pueden devolver al pagador debido al cierre de la cuenta del mismo. En este caso, se crea una transacción con el tipo FUNDING
sobre el pedido de la transacción, cuyo financiamiento falló. Esta transacción tendrá un monto de transacción de cero y la misma moneda que utilizó para el financiamiento (moneda de liquidación). El monto del financiamiento será positivo.
El estado de financiamiento refleja el estado actual del financiamiento para el dinero que se puede esperar razonablemente para este pedido. Refleja el dinero que entra y que sale de su cuenta bancaria. Es decir, tanto ventas como reembolsos.
El estado de financiamiento del pedido (order.fundingStatus
) se deriva del estado de financiamiento de la transacción (transaction.funding.status
) de las transacciones asignadas al pedido.
Al considerar el estado de financiamiento, el Mastercard Payment Gateway solo examina las transacciones que pueden mover fondos. Por ejemplo, pasa por alto las autorizaciones y las capturas rechazadas. Esto se debe a que el Estado de financiamiento del pedido refleja el movimiento del dinero para la transacción comercial, no refleja el movimiento de dinero para las tarifas asociadas con la transacción.
Campo API | Estado | Descripción |
---|---|---|
order.fundingStatus |
NOT_SUPPORTED |
Todas las transacciones del pedido se liquidaron a un proveedor de pagos que no envía información de financiamiento al Mastercard Payment Gateway. |
NON_FUNDED |
No hay transacciones en el pedido que puedan producir una transferencia de dinero a su cuenta o desde ella. | |
IN_PROGRESS |
Hay transacciones en el pedido que pueden producir la transferencia de dinero a su cuenta o desde ella, pero algunas aún no lo han hecho. Este suele ser un estado transitorio. | |
FUNDING_ASSURED |
Está garantizado que todas las transacciones que pueden transferir dinero a su cuenta o desde ella se liquidarán, pero aún no lo han hecho. Es posible que en este estado no se conozca el monto exacto de los fondos a transferir. | |
FUNDED |
Todas las transacciones que pueden transferir dinero a su cuenta o desde ella se están aclarando y se liquidarán. | |
FUNDING_FAILED |
Hay transacciones en el pedido que pueden producir la transferencia de dinero a su cuenta o desde ella, pero el proveedor de servicios no puede completar la transferencia de fondos debido a algún problema con su cuenta. Este puede ser un estado transitorio. | |
FUNDING_ON_HOLD |
Hay transacciones en el pedido que pueden producir la transferencia de dinero a su cuenta o desde ella, pero el proveedor de servicios aún no ha recibido fondos del pagador. En caso de un pedido con un reembolso, el proveedor de servicios no pudo devolver los fondos al pagador. Es posible que deba contactar al pagador para desbloquear esta condición. |
El monto de financiamiento del pedido (order.funding.amount
) refleja el monto total de dinero financiado a su cuenta bancaria o desde ella para este pedido (tal como su adquirente notifica al Mastercard Payment Gateway). Esto incluye las ventas (créditos a su cuenta) y los reembolsos (débitos).
Consulte el estado de financiamiento del pedido (order.funding.status
) para determinar la certeza de este valor.
La moneda de financiamiento del pedido (order.funding.currency
) está configurada como el mismo valor de la moneda de financiamiento de la transacción (transaction.funding.currency
) de la primera transacción financiada para un pedido.
Para las transacciones procesadas a través de un adquirente para las que no se proporcionó información de financiamiento en el Mastercard Payment Gateway, el estado de financiamiento de la transacción se configura en NOT_SUPPORTED
.
Existen tres tipos de tarifas del adquirente:
La información sobre las tarifas aplicables para una transacción se proporciona con respecto a la transacción, en los siguientes campos API:
transaction.funding.fee[n].feeType
transaction.funding.fee[n].acquirerFeeName
transaction.funding.fee[n].amount
transaction.funding.fee[n].rate
El adquirente debita de la cuenta de usted los montos de las tarifas, pero son montos positivos en la API.
La información sobre las tarifas aplicables a un negocio o evento se proporciona con respecto a un pedido de financiamiento independiente.
Un pedido de financiamiento independiente tiene los siguientes detalles del pedido:
Campo del pedido | Descripción |
---|---|
order.id |
ID emitida por el Mastercard Payment Gateway. |
order.amount |
0 |
order.currency |
Se establece en la moneda de liquidación del negocio o la tarifa del evento registrada. |
order.status |
Configure en FUNDING_ONLY . |
order.fundingStatus |
Configure en NON_FUNDED . |
sourceOfFunds.type |
Configure en NONE . |
order.description |
Contiene una cadena que explica que este pedido solo contiene información sobre tarifas. |
Un pedido de financiamiento independiente también tiene los siguientes detalles de la transacción:
Campo de la transacción | Descripción |
---|---|
transaction.id |
ID emitida por el Mastercard Payment Gateway. |
transaction.amount |
0 |
transaction.type |
Configure en FUNDING . |
Grupo de parámetros de transaction.funding.fee[n] |
Información de tarifas. |
Si el adquirente proporciona tarifas de negocios o de eventos para un determinado negocio con un ID de adquirente asociado con más de un negocio en el Mastercard Payment Gateway, la información solo se registra una vez (en un único perfil de negocio).
transaction.acquirer.id
).El monto de la tarifa de la transacción (transaction.funding.feeAmount
) se proporciona en la moneda de liquidación (transaction.funding.feeCurrency
) y refleja el monto total de las tarifas debitadas de su cuenta bancaria para esta transacción (tal como su adquirente notifica al Mastercard Payment Gateway).
Los montos de las tarifas se pueden ingresar con hasta 4 decimales (independientemente del exponente de la moneda). Por lo tanto, es posible que el monto total de la tarifa de la transacción no coincida con la suma de todos los montos de tarifas debidas al redondeo.