Max Pay API
Bienvenido a la documentación de la API pública de Max Pay, plataforma de pagos regulada por el BCRA como PSPCP (Proveedor de Servicios de Pago con Función de Cuenta de Pago).
Sobre esta API
Esta API está orientada a la integración de sistemas ERP, contables y de tesorería con la plataforma de recaudación de Max Pay. Permite:
- Sincronizar la estructura comercial del integrador (clientes, sucursales, asociados).
- Registrar deuda y sus modificaciones (comprobantes: facturas, notas de crédito, devoluciones, ajustes) sobre cuentas recaudadoras con CVU.
- Consultar movimientos, saldos, liquidaciones y reportes operativos.
- Transferir fondos desde las cuentas corrientes del customer, con agenda de destinatarios.
- Recibir notificaciones de eventos vía webhooks.
Por dónde empezar
- ¿Recién empezás? → Cómo empezar — un flujo completo en 10 minutos: autenticar, crear cliente, cuenta recaudadora, emitir un comprobante y cobrar.
- ¿Querés entender el modelo antes de integrar? → Conceptos generales — visión general, patrones de cuenta, cómo se relacionan comprobantes, movements y liquidaciones.
- ¿Buscás un endpoint puntual? → Recursos disponibles más abajo.
Recursos disponibles
| Recurso | Descripción |
|---|---|
| Autenticación | Cómo obtener un token y autenticar requests. |
| Clientes | Gestión de los clientes a los que el customer factura. |
| Asociados | Gestión de los asociados que operan en nombre del customer (choferes, tutores, etc.). |
| Cuentas recaudadoras | Cuentas con CVU dedicado donde los clientes transfieren para pagar. |
| Cuentas corrientes | Cuentas donde se acreditan las liquidaciones del customer. |
| Transferencias | Envío de fondos desde las cuentas corrientes del customer, salientes a terceros o internas entre cuentas propias. |
| Destinatarios | Agenda de destinatarios frecuentes para reutilizar en transferencias. |
| Comprobantes | Documentos que registran deuda o sus modificaciones (facturas, notas de crédito, devoluciones, ajustes). |
| Liquidaciones | Movimientos periódicos de fondos desde las cuentas recaudadoras a la cuenta del customer. |
| Rendiciones por hoja de ruta | Resumen de comprobantes registrados por un asociado durante una jornada. |
| Webhooks | Notificación de eventos al sistema del customer en tiempo real. |
Convenciones globales
- Requests y responses en JSON (
Content-Type: application/json). - Errores en
application/problem+json(RFC 7807). - Timestamps en ISO 8601 con offset. Ej:
2026-05-14T10:30:00-03:00. - Fechas (sin hora) en formato
YYYY-MM-DD. - Códigos de moneda en ISO 4217. Hoy solo
ARS. - IDs de recursos: identificadores numéricos (
int64). - Identificación fiscal (
taxId): siempre 11 dígitos sin guiones. Ejemplo:30999999999. - Paginación: query params
page(1-indexed) ycount(default 20, máximo 200). Total en headerX-Total-Count. - Versionado:
/v1/en todo path. Cambios aditivos no rompen compatibilidad; cambios disruptivos van a futuras versiones de la API.
Ambientes
| Ambiente | Base URL |
|---|---|
| Sandbox | https://api-sandbox.maxpay.com.ar/v1 |
| Producción | https://api.maxpay.com.ar/v1 |
Cambios en esta versión
Ver Changelog.