Mosend
MosendDeveloper

Billing — Nequi

Referencia de 5 endpoints generados desde mosend-wb-backend/src/modules/nequi-payments/nequi-payments.controller.ts.

Base path: /organizations/:orgId/billing/nequi·5 endpoints·Source: mosend-wb-backend/src/modules/nequi-payments/nequi-payments.controller.ts
GET/organizations/:orgId/billing/nequi/enabled
bearer

¿Está habilitado el pago con Nequi?

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/:orgId/billing/nequi/enabled' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
POST/organizations/:orgId/billing/nequi/push
bearer

Inicia un pago push: Nequi envía la solicitud a la app del celular indicado.

Path params

  • orgIdstringrequerido

Body (JSON)

  • invoiceIdstring · uuid

    Factura a pagar. Omitir para recarga de saldo (requiere amount).

  • amountnumber

    Monto de la recarga (moneda de la org). Ignorado si hay invoiceId.

  • phoneNumberstringrequerido

    Celular Nequi del cliente (10 dígitos).

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/nequi/push' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"invoiceId": "00000000-0000-0000-0000-000000000000","amount": 0,"phoneNumber": "<phoneNumber>"}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
POST/organizations/:orgId/billing/nequi/qr
bearer

Genera un QR dinámico de Nequi para el monto.

Path params

  • orgIdstringrequerido

Body (JSON)

  • invoiceIdstring · uuid
  • amountnumber

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/nequi/qr' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"invoiceId": "00000000-0000-0000-0000-000000000000","amount": 0}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/billing/nequi/:paymentId/status
bearer

Estado del pago (hace un check en vivo contra Nequi si sigue pendiente).

Path params

  • orgIdstringrequerido
  • paymentIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/nequi/00000000-0000-0000-0000-000000000000/status' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
POST/organizations/:orgId/billing/nequi/:paymentId/cancel
bearer

Cancela un pago pendiente (cierre del modal).

Path params

  • orgIdstringrequerido
  • paymentIdstringrequerido

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/nequi/00000000-0000-0000-0000-000000000000/cancel' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}