MosendDeveloper

Billing (Alertas de saldo)

Referencia de 2 endpoints generados desde mosend-wb-backend/src/modules/wallet-alerts/wallet-alerts.controller.ts.

Base path: /organizations/:orgId/billing/alert-settings·2 endpoints·Source: mosend-wb-backend/src/modules/wallet-alerts/wallet-alerts.controller.ts
GET/organizations/:orgId/billing/alert-settings
bearer

Devuelve configuración actual de alertas de saldo bajo y auto-recarga.

Path params

  • orgIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/alert-settings' \
  -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"
}
PATCH/organizations/:orgId/billing/alert-settings
bearer

Actualiza configuración de alertas de saldo bajo y auto-recarga.

Path params

  • orgIdstringrequerido

Body (JSON)

  • lowBalanceThresholdnumber

    Umbral de saldo bajo en la moneda del wallet. Si está set y el saldo cae al o por debajo, el cron envía una alerta. `null` desactiva la alerta.

  • autoRechargeEnabledboolean

    Activa/desactiva auto-recarga. Para activar, requiere `autoRechargeAmount` > 0, `autoRechargeCurrency` (3 chars), y que la org tenga `autoPayMethodId` (tarjeta default registrada).

  • autoRechargeAmountnumber

    Monto a cobrar a la tarjeta default cada vez que se dispara la auto-recarga.

  • autoRechargeCurrencystring

    Moneda ISO-4217 de 3 chars (USD, COP, MXN, ...).

Respuestas

  • 200
curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/alert-settings' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"lowBalanceThreshold": 0,"autoRechargeEnabled": true,"autoRechargeAmount": 0,"autoRechargeCurrency": "<autoRechargeCurrency>"}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}