Esta guía describe cómo integrar y probar los flujos principales de Sandbox MX usando las APIs disponibles para merchants.

El objetivo es que un equipo externo pueda:

  1. Crear una cuenta de prueba.
  2. Consultar, actualizar o eliminar esa cuenta.
  3. Simular un depósito sobre la cuenta creada.
  4. Validar el comportamiento de su integración en un ambiente seguro antes de pasar a producción.

🚧 Ambiente sandbox

Los endpoints descritos en esta guía están diseñados para pruebas en ambientes no productivos.

No deben utilizarse para operaciones reales, datos productivos ni procesamiento con dinero real.

Base URL

{{base_url}}

El valor de {{base_url}} será proporcionado por el equipo de integración.

Ejemplo de uso:

POST {{base_url}}/useraccount

🔐 Nota de seguridad

La URL de sandbox, credenciales y tokens deben compartirse únicamente por canales autorizados.

No publiques credenciales, tokens o información sensible en tickets, screenshots, chats o documentación pública.

Autenticación

Los endpoints para merchant requieren autenticación mediante headers.

merchant_code: {{merchant_code}}
merchant_api_token: {{merchant_api_token}}
Content-Type: application/json
Header Descripción
merchant_code Código del merchant asignado para el ambiente sandbox.
merchant_api_token Token de autenticación del merchant.
Content-Type Debe enviarse como application/json.

Si las credenciales no son válidas, el API responderá con un error de autenticación.