La API REST de MOBU te permite leer y escribir contactos, operaciones de cambio, facturas y recibir eventos por webhook del ERP financiero multimoneda.
Bearer con Firebase ID token hoy. API keys por integrador en el roadmap.
Alta, edición y estado de cuenta multimoneda de clientes y proveedores.
Creá y consultá operaciones de cambio, con resúmenes por moneda.
Emisión, confirmación (CAE ARCA/AFIP) y cobro de comprobantes.
Toda la API vive bajo /api. Empezá siempre en Sandbox.
| Entorno | Base URL | Uso |
|---|---|---|
| Sandbox | https://api-staging.mobu.market | Pruebas de integración |
| Producción | https://api.mobu.market | Datos reales |
Autenticá al usuario habilitado con el SDK de Firebase (proyecto financiera-idp)
y pedí un ID token:
const token = await firebase.auth().currentUser.getIdToken();
# Listar contactos de un negocio (desk) curl https://api-staging.mobu.market/api/contacts/by-store/{storeId} \ -H "Authorization: Bearer $TOKEN"
curl -X POST https://api-staging.mobu.market/api/contacts \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "alias": "ACME S.A.", "storeId": "{storeId}", "email": "pagos@acme.com" }'
?page / ?size y devuelve los
headers X-Total-Count y Link (RFC 5988).402 Payment Required hasta regularizar el pago.Cada request lleva Authorization: Bearer <token>.
| Método | Header | Estado |
|---|---|---|
| Firebase ID token | Authorization: Bearer … | Disponible |
| API key por integrador | X-MOBU-Api-Key: … | Fase 2 |
El esquema de API keys (server-to-server, con scopes y rate-limit emitidas desde el backoffice) está en el roadmap. Mientras tanto usá el ID token de Firebase.
Vas a poder suscribir una URL HTTPS para recibir eventos
(contact.created, operation.confirmed,
invoice.paid…), firmados con HMAC-SHA256 en
X-MOBU-Signature. Ver el detalle en la
referencia.