Identificadores
Se utilizan varios identificadores para conciliar y rastrear las transacciones que se realizan a través de los sistemas de pago. Estos identificadores se utilizan en el informe de liquidación de su adquirente para ayudarle a identificar cada transacción.
Usted proporciona identificadores al enviar solicitudes al Mastercard Gateway. Lo ideal es que se pueda utilizar el mismo identificador en todos los sistemas, es decir, el suyo propio, el del motor de pagos y el de su adquirente. Sin embargo, los diferentes sistemas tienen requisitos diferentes y, a menudo, se necesita una combinación de identificadores. Cada pedido que crees puede tener tres tipos diferentes de identificadores:
Tipos de identificadores
Cada pedido que crees puede tener tres tipos diferentes de identificadores:
- ID de pedido: Este es un identificador obligatorio que debe definir como parte de la primera transacción de cada pedido. El valor se proporciona como el campo orderID en los cuerpos de solicitud y respuesta, o como un
orderIDparámetro de consulta, según la operación. El valor debe ser único en todos los pedidos enviados desde su cuenta de negocio, ya que el motor de pagos lo utiliza para identificar un pedido particular enviado por usted. Para mayor comodidad, utilice una clave natural dentro de su propio sistema como elorder ID, como el ID del carrito de compras o el número de factura. Esto facilita el seguimiento de los pedidos entre su sistema y el motor de pagos. Como el motor de pagos también intenta utilizar el ID del pedido en los mensajes del adquirente cuando sea posible, los tres sistemas, es decir, el suyo, el motor de pagos y su banco, pueden vincularse mediante un identificador común. - Referencia de pedido: en algunas situaciones, los ID de pedido que utiliza en su propio sistema no se pueden utilizar en el motor de pagos, ya que no cumplen con los requisitos del motor de pagos. Por ejemplo, si su sistema rota los ID de pedido, se ajusta cuando se excede un límite superior establecido o agrupa varias transacciones en un solo pedido, el ID de pedido dentro de su sistema no funciona como un identificador único en el motor de pagos. En este caso, debe crear un nuevo
order IDúnico para utilizarlo en el motor de pagos. Además, puede proporcionar un valor opcional,order.reference, que contiene el identificador que utiliza en su propio sistema y le permite realizar un seguimiento de los pedidos entre su sistema y el motor de pagos. - Identificador del adquirente: Como el motor de pagos debe pasar un identificador al adquirente, intenta utilizar su
order ID. Sin embargo, si eso no es adecuado para su adquirente, el motor de pagos transforma el valor en algo que coincida con los requisitos de formato y longitud del campo del adquirente. Si desea controlar el valor que el motor de pagos proporciona al adquirente, puede proporcionar un valor transaction.acquirer.transactionId en la solicitud. Sin embargo, si ese valor no coincide con los requisitos del adquirente, el motor de pagos también lo transforma antes de enviarlo. En cualquier caso, puede encontrar el identificador que el motor de pagos realmente envió al adquirente en el campo transaction.acquirer.transactionId de la respuesta a la solicitud. Si el motor de pagos ha tenido que transformar el identificador, almacene el valor de respuesta para poder hacer coincidir los detalles de pago del adquirente con los pedidos en su sistema.
Transacciones
Para identificar las transacciones individuales dentro de un pedido, el motor de pagos utiliza ID de transacción. El valor se proporciona como el campo transaction.id en los cuerpos de solicitud y respuesta, o como un parámetro de consulta transactionID para operaciones específicas. Si su sistema rastrea las transacciones utilizando un identificador único, utilícelo. En caso contrario, utilice cualquier número secuencial o aleatorio, siempre que sea único para cada transacción dentro del mismo pedido.
Para identificar la transacción en el adquirente de tarjeta, utilice el recibo. Este valor se devuelve en el campo transaction.receipt de la respuesta de la solicitud; sin embargo, este valor puede no ser único.