Partner API · v1

Integrá tu sistema con MOBU

La API REST de MOBU te permite leer y escribir contactos, operaciones de cambio, facturas y recibir eventos por webhook del ERP financiero multimoneda.

Ver referencia de la API → Empezar (5 min)
🔑

Autenticación

Bearer con Firebase ID token del proyecto financiera-idp.

👥

Contactos

Alta, edición y estado de cuenta multimoneda de clientes y proveedores.

💱

Operaciones

Creá y consultá operaciones de cambio, con resúmenes por moneda.

🧾

Facturas

Emisión, confirmación (CAE ARCA/AFIP) y cobro de comprobantes.

Quickstart

Toda la API vive bajo /api. Empezá siempre en Sandbox.

EntornoBase URLUso
Sandboxhttps://api-staging.mobu.marketPruebas de integración
Producciónhttps://api.mobu.marketDatos reales

1 · Obtené un token

Autenticá al usuario habilitado con el SDK de Firebase (proyecto financiera-idp) y pedí un ID token:

const token = await firebase.auth().currentUser.getIdToken();

2 · Llamá a la API

# Listar contactos de un negocio (desk)
curl https://api-staging.mobu.market/api/contacts/by-store/{storeId} \
  -H "Authorization: Bearer $TOKEN"

3 · Creá un recurso

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" }'
📄
La paginación usa ?page / ?size y devuelve los headers X-Total-Count y Link (RFC 5988).
⚠️
Un negocio con facturas vencidas pasa a modo solo-lectura: las escrituras devuelven 402 Payment Required hasta regularizar el pago.

Autenticación

Cada request lleva Authorization: Bearer <token>.

MétodoHeaderEstado
Firebase ID tokenAuthorization: Bearer …Disponible

La identidad y los permisos los da el ID token de Firebase (proyecto financiera-idp, el mismo de la app). No se emiten API keys.

Webhooks Fase 2

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.