Un mandate es el límite que el agente se impone: máximo por operación, máximo diario y lista de contrapartes autorizadas.
POST https://api.luniumpay.com/mesh/agents/{agent_id}/mandate
X-API-Key: lun_live_…
{"max_por_operacao_cents": 30000,
"max_diario_cents": 200000,
"contrapartes": ["12345678901"]}El mandate solo restringe, nunca flexibiliza. El límite que se aplica siempre es el menor entre el límite de la plataforma para esa operación y el de tu mandate. Por eso puedes definirlo sin aprobación: lo máximo que hace es limitarte.
Un rechazo por mandate se resuelve editando la propia política, nunca pidiendo un aumento del límite. Por eso el error es mandate_valor_acima_do_teto, y no el mismo código del límite de la API: el agente debe saber de quién es la política que lo bloqueó.
| Operación | Límite de la plataforma |
|---|---|
Venta de cripto → PIX (cash-out) | De R$ 6,00 a R$ 250.000,00 por transacción, y R$ 100.000,00 al día para el CPF/CNPJ de quien recibe el PIX; cuando la clave no es un documento (correo electrónico, teléfono, aleatoria), este límite diario se aplica por clave. No hay un límite diario de la plataforma por clave de API. |
Compra PIX → cripto (cash-in) y payouts | En cash-in, el rango efectivo por solicitud de cobro es dinámico e incluye la tarifa; lee GET /keys/me, obtén la vista previa y consulta GET /cashin/limits para el pagador. En payout se aplican el rango por operación y el saldo disponible. Lunium no impone un límite diario por clave. |
Como el límite diario de cash-out corresponde al destinatario, el máximo efectivo de una venta a quien aún no ha recibido nada ese día es R$ 100.000,00, no R$ 250.000,00. La API devuelve ambos: limits.max_brl_cents (lo que se aplica ahora) y limits.max_brl_cents_por_transacao. La cifra de tu clave siempre está en GET /keys/me.
El mismo rechazo, con los mismos códigos. Una política que solo existe en producción no se puede probar y descubrirías tu propio límite el primer día real.