Además del ambiente productivo, MACH ofrece un ambiente de alta disponibilidad, réplica del ambiente productivo para realización y certificación de pruebas durante el período de integración (denominado Sandbox). Este ambiente habilita pruebas que no afecten los flujos productivos de tu comercio, a usuarios de MACH o a otros clientes. Esta plataforma no cuenta con una aplicación móvil con la cual dar completitud de los pagos; sin embargo, cuenta con operaciones básicas mediante botones web para simular la completación o fallo de los pagos.

A nivel de Portal para comercios, el modo Sandbox se activa por defecto al realizar la inscripción en el Portal, y el modo Producción se libera una vez se completen los datos legales (dirección, sociedad de la empresa). Ambos ambientes pueden ser alternados con el switch ubicado en la parte inferior de la barra lateral izquierda del Portal.

Para realizar llamadas en modo Sandbox se debe llamar a https://biz-sandbox.soymach.com, y en modo Producción se debe llamar a https://biz.soymach.com

Se debe adjuntar un token de autenticación en cada una de las requests. Este token se puede generar a través del Portal Mach para comercios, en Configuraciones > Para Desarrolladores > API Keys. Cada ambiente (Sandbox, Producción) maneja su autenticación de forma diferenciada, por lo que se deben generar llaves independientes para pruebas y para producción.

Tras generar una llave, la misma no se podrá recuperar, ya que no es guardada en sistema y no se puede volver a obtener; sin embargo, se pueden desactivar y generar tokens de reemplazo, de ser necesario.

E.g: "Authorization": "Bearer eyJhbGciOiwdgtrhsiere..."

Las llamadas a continuación tienen documentado el método de autenticación como BearerAuth.

Información relacionada a los pagos realizados mediante MACH. El documento de pago guarda toda la información relevante de este mismo, como el monto, identificador del pago, identificador del comercio, etc.

Proceso de pago

Si tienes locales físicos, la confirmación manual de tus transacciones podría ser la mejor opción para tu integración. Obtén más información en el siguiente enlace.

Información relacionada a las compensaciones realizadas a los comercios asociados a MACH.

Información relacionada a las cuentas bancarias para recepción de compensaciones MACH.

Información relacionada a las devoluciones realizadas por los comercios asociados a MACH.

Proceso de devolución

Si tu comercio lo necesita, puedes solicitar la modificación de los tiempos automatizados vinculados a los cambios de estado de tus transacciones. Realiza esta solicitud a través de tu ejecutivo MACH.

Información relacionada a las sucursales de los comercios asociados a MACH.

Información relacionada a los reportes de los comercios asociados a MACH.

Información relacionada a las cajas de los comercios asociados a MACH.

Información relacionada a los enrolamientos de usuarios en los comercios asociados a MACH. Para utilizar esta funcionalidad, ponte en contacto con nosotros mediante el Centro de Ayuda Empresas.

MACH permite configurar webhook endpoints para notificar a una URL acerca de eventos que ocurren en su cuenta MACH Business. Para configurar un webhook, se debe ingresar a la plataforma de MACH, en Configuraciones > Para Desarrolladores > Webhooks. Esta configuración, al igual que los tokens de autenticación, es dependiente del ambiente en que se crean (Sandbox y Producción)

Cuando (por ejemplo) un usuario autoriza una compra en su sitio, creada a través de la Business API, MACH puede notificarle a una URL registrada la ocurrencia del evento, con su información correspondiente. MACH enviará un objeto a través de una solicitud HTTP POST, ante lo cual su endpoint debería retornar un estado HTTP 2xx. Toda otra respuesta notifica a MACH que la URL registrada no recibió el webhook correctamente, y respuestas con estado 5XX son re-intentadas 2 veces más en intervalos de tiempo de 25 y 125 segundos respectivamente, para luego ser marcadas como fallidas.
Un ejemplo del objeto que envía MACH al completarse un pago (y que se encuentra en el body de la solicitud) es el siguiente:

{
  "event_name": "business-payment-completed",
  "event_resource_id": "12685e38-ef64-4cff-b51a-8a4fe649e3b6",
  "event_upstream_id": "upstream_id"
}

En este payload de ejemplo, el campo event_resource_id es un string que identifica al BusinessPayment que fue completado con el evento (equivalente al campo business_payment_id), y el campo upstream_id hace referencia al identificador externo que entregó el comercio al crear el pago. Use ese valor para llamar al endpoint Obtener un BusinessPayment descrito anteriormente, que retornará toda la información del pago recién completado.

Otra opción disponible al configurar un webhook en Configuraciones > Para Desarrolladores > Webhooks es la de, opcionalmente, agregar una llave de autenticación (token) el cual permitirá el envío de webhooks de manera mas segura, dicha llave será enviada junto con la petición del webhook en el header de la request en el campo Authorization, este campo es opcional, la gran ventaja de utilizar esta característica es poder disfutar de una mayor seguridad ya que al enviar el webhook, nosotros enviaremos este token en la solicitud el cual podrás verificarlo contra tu sistema.

si optas por utilizar esta funcionalidad, el header de la petición se enviará de esta manera:

{
  "header": {
    "authorization": "Bearer eydjhsoqp5654a...",
  }
}

Eventos

*En el caso de que exista algún error, el webhook hará 2 intentos de reenvío más.