Pedidos y transacciones

Un pedido es el concepto que el Mastercard Payment Gateway usa para vincular todas las transacciones que se relacionan con una instancia de una venta entre usted y el pagador. Grosso modo, pretende representar el concepto clásico de 'pedido' de papel, en que usted le vende una lista de mercancías a sus clientes. Como tal, tiene todos los datos de un pedido clásico — los elementos lineales para las mercancías que se compraron, quién pago por ellos y cómo, adónde se deben enviar y, lo más importante, la cantidad pagada.

Un pedido puede contener una o más transacciones. Algunos pedidos solamente tienen una transacción, una 'compra' donde las mercancías se pagan en su totalidad y se despachan de inmediato. Otros tienen dos transacciones, una 'autorización' donde puede verificar que la cuenta bancaria del pagador tenga suficiente dinero y reservarlo, y luego una 'captura', donde pasa el dinero de su cuenta a la suya. El modelo de autorización/captura generalmente se usa cuando no puede garantizar que las mercancías se puedan despachar al momento en que el pagador las solicitó. Habrá veces en que deberá reembolsar parte o la totalidad del dinero del pedido, o quizás entregar las mercancías en varias entregas parciales. Todos esos movimientos de dinero representan transacciones contra el primero pedido.

Cuando usa el Mastercard Payment Gateway, por lo general, proporciona toda la información acerca del pedido en la transacción inicial — la facturación, el envío, los detalles de pago, la cantidad total, etc. Luego en transacciones posteriores, por ejemplo, captura, Reembolso o Anulación, no necesita repetir estos datos, solo hacer referencia al pedido original. Por ejemplo, si desea hacer un reembolso, entonces simplemente proporcione el identificador del pedido y la cantidad que desea reembolsar, y la puerta de enlace proporcionará todos los detalles que el banco necesite para mover el dinero.

Desde API v15 en adelante, si la transacción inicial para un pedido falla, usted puede enviar otra transacción inicial para este pedido sin tener que crear un nuevo pedido. Esto es útil en escenarios donde al pagador desearía reintentar una transacción fallida con detalles de pago diferentes, por ejemplo: una tarjeta de crédito diferente o un método de pago alternativo (PayPal).
Identificador de pedido

La Mastercard Payment Gateway tiene un solo identificador único que usa para identificar un pedido determinado enviado por usted. Debe asignar ese identificador como parte de la primera transacción en el pedido. Este identificador se denomina order.id (proporcionado como orderID en la URL para REST). Se recomienda que suministre la clave natural para el pedido (ID del carro de compras, número de factura) dentro de su sistema a la puerta de enlace. Esto facilita hacer un seguimiento entre su sistema y la puerta de enlace. La puerta de enlace también intenta usar el order.id en los mensajes de la entidad gestora. De esa manera, los tres sistemas —el suyo, la puerta de enlace y el banco— estarán vinculados por el identificador común. Sin embargo, esta situación ideal podría no ser posible debido a limitaciones de los diversos sistemas.

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

Referencia de Pedido

Es posible que el identificador de pedido no sea adecuado como referencia en su sistema. Por ejemplo, si su sistema trabaja con identificadores de pedidos o agrupa varias ofertas bajo un pedido, entonces el identificador de pedido no será adecuado. En este caso, puede proporcionar un valor adicional, el order.reference, para rastrear entre su sistema y la Mastercard Payment Gateway.

Referencia de API de Referencia de Pedido[REST][NVP]

Identificador de pedido para la entidad gestora

La puerta de enlace debe pasar un identificador a la entidad gestora. Tratará de usar su identificador de pedido, posiblemente en combinación con su identificador de transacción (ver a continuación). Sin embargo, si eso no es adecuado para su entidad gestora, la puerta de enlace los transformará en un valor adecuado. En todos los casos, la puerta de enlace devuelve el identificador que se usó, en el campo transaction.acquirer.transactionId.

Sin embargo, si desea controlar el valor que la puerta de enlace proporciona a la entidad gestora, entonces puede proporcionar un valor transaction.acquirer.transactionId en la solicitud.

Sin embargo, si desea controlar el valor que la puerta de enlace proporciona a la entidad gestora, entonces puede proporcionar un valor en transaction.acquirer.transactionId.

Póngase en contacto con su proveedor de servicios de pago para ver si su entidad gestora lo admite.

Referencia API de identificador de pedido de entidad gestora[REST][NVP]

Puede proporcionar la order.id y la order.reference y transaction.acquirer.transactionId para obtener un buen control de la identidad en cada sistema.
Identificador de transacción

La Mastercard Payment Gateway tiene un identificador único que usa para identificar cada transacción determinada dentro del pedido. Este identificador se denomina transaction.id (proporcionado como transactionID en la URL para REST). Normalmente, no tendrá una clave natural para esto, pero si la tiene, entonces no se recomienda que lo use. Si no es así, un número secuencial o aleatorio es adecuado.

Referencia de API de identificador de transacción[REST][NVP]

Derechos de autor © 2020 Mastercard