Dos rutas distintas que mucha gente confunde: adónde va el dinero de la operación, y adónde vuelve la cripto si no se puede completar la operación.
POST https://api.luniumpay.com/mesh/agents/{agent_id}/settlement
X-API-Key: lun_live_…
{"settlement_address": "0x…"}Es un requisito para entrar en producción: sin una ruta de liquidación, el dinero no tiene destino. La red debe ser una de las compatibles: una dirección en una red inexistente es una orden que nunca llega.
refund_address de cada ordenEs algo distinto y lo más importante que debes indicar correctamente. Es la billetera de tu usuario, en la misma red del depósito, adonde vuelve la cripto si no se puede pagar el PIX.
refund_address, la devolución nunca va al origen on-chain del depósito: cuando el usuario retiró de un exchange, ese origen es la billetera del exchange, y el dinero no regresaría al usuario. La orden se detiene en AWAITING_REFUND_ADDRESS (webhook cashout.awaiting_refund_address) hasta que indiques la billetera del usuario en POST /cash-outs/{cashout_id}/refund-address. Si ya tienes la billetera, envíala al crear la orden.| Estado | Resultado |
|---|---|
| Clave PIX rechazada después del depósito | La cripto vuelve a la custodia y continúa hacia refund_address. Estado REFUNDED, con refund_tx_hash. |
| Fallo antes del envío al liquidador | Se reintenta cada 5 min durante un máximo de 45 min. Si no se liquida, se devuelve el importe completo , incluida la tarifa. |
| Depósito con un importe distinto del cotizado | Se paga el importe realmente recibido, con una nueva cotización en la liquidación. |
Depósito después de expires_at | La orden se reactiva cuando aparece el depósito, durante un máximo de 7 días. |
Solo existen dos resultados finales con dinero: COMPLETED (el PIX se envió, con E2E) o REFUNDED (la cripto regresó, con hash). Nunca un tercer estado silencioso.
El cambio requiere la clave del propio agente. El agent_id identifica, no autoriza: si identificara y autorizara, cualquiera podría redirigir la liquidación de otro, la forma más directa de robar dinero en este diseño.