Saltar al contenido principal
Migo Docs

Solicitudes de Proceso

API RESTRINGIDA

Requiere autorización de partner / operador. Consulta CMS → Inicio.

Una solicitud de proceso es una solicitud de recarga de saldo (incremento de saldo) del partner. Un operador envía el monto solicitado junto con un archivo de evidencia (PDF o imagen); luego otro operador la aprueba o la rechaza. Una vez aprobada, se acredita el saldo disponible del partner.

Todas las rutas usan el identificador de partner/cliente en la URL. Cada llamada requiere ambos headers de autenticación (Authorization: Bearer <app-access-token> y x-user-token: Bearer <cms-user-token>).

Crear una solicitud de proceso de saldo​

multipart/form-data con un único archivo evidence (PDF, JPEG, PNG o WEBP, máx. 10 MB). El OTP es requerido cuando el operador está sujeto a elevación por OTP.

curl -X POST "https://api.ali.app/cms/rest/app/partners/{partnerId}/process-request" \
  -H "Authorization: Bearer <token>" \
  -H "x-user-token: Bearer <cms-user-token>" \
  -F "evidence=@deposit-receipt.pdf" \
  -F "requestedAmount=10000" \
  -F "observations=Wire transfer received on 2026-03-01" \
  -F "otp=123456"

Campos del cuerpo:

  • requestedAmount (número, requerido) — monto del incremento de saldo.
  • observations (cadena) — notas que describen la solicitud.
  • otp (cadena, opcional) — código de 6 dígitos, requerido solo cuando el operador está sujeto a OTP.
  • evidence (archivo, requerido) — el documento de respaldo.

Obtener el saldo disponible del partner​

curl "https://api.ali.app/cms/rest/app/partners/{clientId}/balance" \
  -H "Authorization: Bearer <token>" \
  -H "x-user-token: Bearer <cms-user-token>"

Devuelve { id, clientId, available, currency, updatedAt, createdAt }.

Listar solicitudes de proceso (paginado)​

curl "https://api.ali.app/cms/rest/app/partners/{clientId}/process-requests?page=1&limit=10" \
  -H "Authorization: Bearer <token>" \
  -H "x-user-token: Bearer <cms-user-token>"

Parámetros de consulta: page (por defecto 1), limit (por defecto 10).

También está disponible un listado no paginado:

curl "https://api.ali.app/cms/rest/app/partners/{clientId}/process-request" \
  -H "Authorization: Bearer <token>" \
  -H "x-user-token: Bearer <cms-user-token>"

Cada elemento de solicitud expone { id, processTypeId, clientBalanceId, requestedAmount, evidenceUrl, status, ... }, donde status es uno de PENDING, APPROVED, REJECTED.

Descargar evidencia​

Devuelve una URL de descarga pre-firmada para el archivo de evidencia de la solicitud.

curl "https://api.ali.app/cms/rest/app/partners/{clientId}/process-request/{processRequestId}/evidence/download" \
  -H "Authorization: Bearer <token>" \
  -H "x-user-token: Bearer <cms-user-token>"

Aprobar o rechazar una solicitud​

El parámetro de ruta action es approve o reject. Devuelve 204 No Content en caso de éxito.

curl -X PATCH "https://api.ali.app/cms/rest/app/partners/{partnerId}/process-request/{processRequestId}/approve" \
  -H "Authorization: Bearer <token>" \
  -H "x-user-token: Bearer <cms-user-token>"

curl -X PATCH "https://api.ali.app/cms/rest/app/partners/{partnerId}/process-request/{processRequestId}/reject" \
  -H "Authorization: Bearer <token>" \
  -H "x-user-token: Bearer <cms-user-token>"

Una solicitud que no está pendiente de revisión devuelve 409 Conflict.

Cancelar una solicitud​

curl -X PATCH "https://api.ali.app/cms/rest/app/partners/{partnerId}/process-request/{processRequestId}/cancel" \
  -H "Authorization: Bearer <token>" \
  -H "x-user-token: Bearer <cms-user-token>"

Flujo de progreso (SSE)​

Suscríbete al progreso en tiempo real mientras se procesa una solicitud. Al igual que el flujo de carga masiva, la conexión emite tramas data: sin nombre y es en memoria / de un único pod.

curl "https://api.ali.app/cms/rest/app/partners/{clientId}/process-request/progress" \
  -H "Authorization: Bearer <token>" \
  -H "x-user-token: Bearer <cms-user-token>" \
  -H "Accept: text/event-stream" \
  --no-buffer