Obtén una clave
- En la app Money Tracker, abre Perfil y elige Claves de API.
- Toca Crear clave, ponle un nombre y marca lo que puede hacer.
- Copia la API_KEY y el API_SECRET. El secreto solo se muestra una vez.
Cada cuenta puede tener una clave activa. Para cambiarla, revócala en la misma pantalla y crea una nueva. Una clave revocada deja de funcionar al instante.
Autenticación
Envía ambos valores como cabeceras en cada solicitud. Nunca pongas el secreto en una URL, una página web o una app que otras personas puedan abrir.
- X-Api-Key
- Tu API_KEY. Empieza por mtu_.
- X-Api-Secret
- Tu API_SECRET, 40 letras y números.
curl "https://moneytracker.arizu.id/api/v1/transactions?month=2026-11&type=income" \
-H "X-Api-Key: mtu_YOUR_API_KEY" \
-H "X-Api-Secret: YOUR_API_SECRET"Permisos
Una clave solo tiene los permisos que marques. Un permiso de escritura incluye el de lectura.
- transactions:read
- Leer transacciones
- transactions:write
- Registrar, cambiar y eliminar transacciones
- categories:read
- Leer categorías
- categories:write
- Añadir y eliminar categorías
- money_sources:read
- Leer fuentes de dinero y sus saldos
- money_sources:write
- Añadir, cambiar y eliminar fuentes de dinero
- profile:read
- Leer el nombre, el correo, la moneda, el idioma y el plan de la cuenta
Endpoints
Las rutas son relativas a la URL base. Los importes están en la moneda de la cuenta.
Cuenta
-
GET
/api/v1/auth/meprofile:readEl perfil de la cuenta.
Transacciones
-
GET
/api/v1/transactionstransactions:readTransacciones, de la más reciente a la más antigua. Filtros: month (2026-11), type (income o expense), source_id, page, per_page (hasta 100).
-
GET
/api/v1/transactions/{id}transactions:readUna transacción.
-
POST
/api/v1/transactionstransactions:writeRegistra una transacción. Obligatorios: type, amount, occurred_on (2026-11-02). Opcionales: category_id, payment_source_id, note (hasta 255 caracteres), client_ref.
-
PUT
/api/v1/transactions/{id}transactions:writeCambia una transacción. Envía los mismos campos que al registrarla, sin client_ref.
-
DELETE
/api/v1/transactions/{id}transactions:writeElimina una transacción.
Categorías
-
GET
/api/v1/categoriescategories:readCategorías de ingresos y gastos.
-
POST
/api/v1/categoriescategories:writeAñade una categoría. Obligatorios: type, name. Opcionales: icon, color (#RRGGBB), client_ref.
-
DELETE
/api/v1/categories/{id}categories:writeElimina una categoría.
Fuentes de dinero
-
GET
/api/v1/payment-sourcesmoney_sources:readFuentes de dinero con sus saldos.
-
POST
/api/v1/payment-sourcesmoney_sources:writeAñade una fuente de dinero. Obligatorios: type (bank, card, ewallet o cash), holder_name. Opcionales: bank_name, provider_name, card_type, card_last4, opening_balance, client_ref.
-
PUT
/api/v1/payment-sources/{id}money_sources:writeCambia una fuente de dinero.
-
DELETE
/api/v1/payment-sources/{id}money_sources:writeElimina una fuente de dinero.
Cualquier otra ruta responde 403 a una clave de API, aunque la propia app la use.
Ejemplo: registrar una venta
Un punto de venta puede registrar cada venta como ingreso. Da a cada venta su propio client_ref, para que un reintento tras un error de red no registre la venta dos veces.
curl -X POST "https://moneytracker.arizu.id/api/v1/transactions" \
-H "X-Api-Key: mtu_YOUR_API_KEY" \
-H "X-Api-Secret: YOUR_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"type": "income",
"amount": 125000,
"occurred_on": "2026-11-02",
"note": "Sale 1042",
"client_ref": "pos-sale-1042"
}'La respuesta tiene el estado 201 y el id de la nueva transacción en data.id.
{
"data": {
"id": 58213,
"amount": "125000.00",
"currency": "IDR",
"original_amount": null,
"original_currency": null,
"fx_rate": null,
"fx_date": null
}
}client_ref tiene de 8 a 64 letras, números o guiones. Si la cuenta ya tiene una transacción con el mismo client_ref, la API devuelve esa transacción en lugar de registrar una nueva.
Respuestas y errores
Una respuesta correcta pone el resultado en data. Una respuesta fallida trae un mensaje en error, en el idioma de la cuenta, y a menudo un code que es igual en todos los idiomas.
{
"error": "This API key does not have the permission for this request",
"code": "api_key_scope_missing",
"scope": "transactions:write"
}- 401
- Falta la clave o el secreto, o es incorrecto, o la clave fue revocada o ha caducado.
- 403
- La clave no tiene permiso para esta solicitud, la ruta está cerrada a las claves de API o la cuenta está bloqueada.
- 404
- El elemento no existe en esta cuenta.
- 422
- Falta un campo o no es válido. Si aparece fields, indica qué corregir.
- 429
- Demasiadas solicitudes. Espera los segundos que indica la cabecera Retry-After.
Límites
Cada clave puede hacer hasta 60 solicitudes por minuto. Los límites de tu plan siguen aplicándose, igual que en la app. En el plan Free, eso significa hasta 30 transacciones nuevas al día.
Mantén tus claves seguras
- Guarda el secreto en un solo lugar, como los ajustes de tu punto de venta, y no lo compartas por chat ni por correo.
- Marca solo los permisos que el sistema necesita.
- Si un secreto se filtra, revoca la clave en la app y crea una nueva.
- La app muestra cuándo se usó tu clave por última vez. Si no coincide con tus propios sistemas, revoca la clave.
¿Preguntas sobre la API? Escribe a ariefzufar@arizu.id / arizu.team@gmail.com.