Pagos con OXXO

OXXO es un método de pago que se utiliza en México, que permite a los pagadores comprar productos en línea. Cuando el pagador selecciona OXXO en la página de pago, los detalles de pago se muestran en la pantalla y se pueden imprimir. Luego, el pagador puede pagar el monto requerido para la compra en un local de OXXO. Una vez que se realice el pago, recibirá una notificación y los bienes se podrán entregar para ser enviados al pagador.

OXXO es un método de pago mediante explorador compatible en el Mastercard Payment Gateway. Esta página describe los detalles de la integración específicos de OXXO. Se recomienda que lea las pautas de integración para los pagos mediante explorador, antes de crear una integración de OXXO.

Los pagos mediante explorador de OXXO solo se admiten para transacciones en moneda MXN (de API v56 en adelante).

Prerrequisitos

Para ofrecer OXXO como un método de pago mediante el Mastercard Payment Gateway:

Usted debe estar registrado con su proveedor de servicios de pago mediante explorador.
Su perfil de negocio en el motor de pagos se debe configurar usando los detalles de su cuenta con el proveedor de servicios de pago mediante explorador.
Debe tener una cuenta bancaria en una de las monedas soportadas registrada en su cuenta de negocio en su proveedor de servicios de pago mediante explorador.

Integración de OXXO

OXXO mediante Hosted Checkout

Pronto estará disponible OXXO mediante Hosted Checkout. Póngase en contacto con your payment service provider para obtener más información.

OXXO mediante Direct Payment

La integración de Direct Payment le permite ofrecer el método de pago de OXXO en su propia página de pago.

OXXO es compatible con API versión 56 en adelante.

Además de los campos estándar necesarios en una solicitud de pago mediante explorador, proporcione los siguientes campos en la solicitud Initiate Browser Payment:

Campos comunes

sourceOfFunds.type = OXXO
browserPayment.operation = PAY (OXXO no admite la operación Authorize)
customer.email: la dirección de correo electrónico del pagador.
sourceOfFunds.provided.oxxo.bankAccountHolder: el nombre del titular de la cuenta bancaria para la cuenta bancaria del pagador.

Para transacciones en moneda MXN (OXXO nacional) ÚNICAMENTE, proporcione los siguientes campos adicionales:

sourceOfFunds.provided.oxxo.dueDate: La fecha en que el pagador debe realizar el pago. Si no proporciona un valor, la fecha predeterminada será la fecha en curso más 3 días.

Idioma preferido

Para configurar el idioma que prefiere que OXXO utilice para las páginas que se muestran al pagador, complete el campo browserPayment.preferredLanguage en la solicitud de Initiate Browser Payment. Sin embargo, el idioma se usará solo si OXXO lo admite.

Código de muestra para iniciar el pago OXXO para transacciones nacionales

{
   "apiOperation":"INITIATE_BROWSER_PAYMENT",
   "browserPayment":{
      "operation":"PAY",
      "returnUrl":"https://<return_url>"
   },
   "customer":{
      "email":"john.smith@example.com"
   },
   "order":{
      "amount":"10.00",
      "currency":"MXN"
   },
   "sourceOfFunds":{
      "type":"OXXO",
      "provided":{
         "oxxo":{
            "bankAccountHolder":"John Smith",
            "dueDate":"2021-04-01"
         }
      }
   }
}

Cómo interpretar el resultado de la transacción

La tabla siguiente muestra los códigos de respuesta de transacción para los posibles escenarios que puede encontrar después de iniciar un pago con OXXO.

Respuesta de Initiate Browser Payment	Qué significa esto...
`response.gatewayCode=SUBMITTED` `result=SUCCESS`	Redirigir al pagador utilizando la URL proporcionada en la respuesta.
Respuesta de Retrieve Transaction/Retrieve Order	Qué significa esto...
`response.gatewayCode=APPROVED` `result=SUCCESS`	El pago se realizó correctamente.
`response.gatewayCode=PENDING` `result=PENDING`	Mastercard Payment Gateway está esperando una notificación del adquirente sobre el resultado del pago. Pruebe `RETRIEVE_TRANSACTION` nuevamente más tarde o escuche las notificaciones de Mastercard Payment Gateway.
`response.gatewayCode=CANCELLED` `result=FAILURE`	El pagador canceló la interacción para este pago. Ofrezca al pagador la opción de probar otro método de pago.
`response.gatewayCode=DECLINED` o `ACQUIRER_SYSTEM_ERROR` `result=FAILURE`	El pago fue rechazado. Ofrezca al pagador la opción de probar otro método de pago. En caso de un `ACQUIRER_SYSTEM_ERROR`, puede consultar con el adquirente el motivo del error del pago, o bien puede intentar `RETRIEVE_TRANSACTION` de nuevo.
`response.gatewayCode=TIMED_OUT` `result=FAILURE`	Trate esto como un pago rechazado. El Mastercard Payment Gateway hará lo posible para asegurarse de que la transacción no se puede realizar o revertirá la transacción.

Prueba de su integración

El Mastercard Payment Gateway proporciona un emulador de pagos mediante explorador que le permite probar su integración con OXXO.