Duas rotas diferentes, que muita gente confunde: para onde vai o dinheiro da operação, e para onde volta a cripto se a operação não puder ser concluída.
POST https://api.luniumpay.com/mesh/agents/{agent_id}/settlement
X-API-Key: lun_live_…
{"settlement_address": "0x…"}É requisito para entrar em produção: sem rota de liquidação, o dinheiro não tem para onde ir. A rede precisa ser uma das suportadas — endereço em rede que não existe é ordem que nunca chega.
refund_address de cada ordemCoisa diferente, e a mais importante de acertar. É a carteira do seu usuário, na mesma rede do depósito — para onde a cripto volta se o PIX não puder ser pago.
refund_address, a devolução vai para a origem on-chain do depósito. Quando o usuário sacou de uma exchange, essa origem é a carteira da exchange — e o dinheiro dele não volta para ele. Mande sempre.| Situação | Desfecho |
|---|---|
| Chave PIX recusada depois do depósito | A cripto volta à custódia e segue para refund_address. Estado REFUNDED, com refund_tx_hash. |
| Falha antes do envio ao liquidante | Retentado a cada 5 min por até 45 min. Se não liquidar, devolve o valor cheio — taxa inclusive. |
| Depósito com valor diferente do cotado | Paga-se o valor realmente recebido, recotado na liquidação. |
Depósito depois de expires_at | A ordem revive quando o depósito aparece, por até 7 dias. |
Só existem dois desfechos terminais com dinheiro: COMPLETED (o PIX saiu, com E2E) ou REFUNDED (a cripto voltou, com hash). Nunca um terceiro estado silencioso.
A troca exige a chave do próprio agente. O agent_id identifica, não autoriza — se identificasse e autorizasse, qualquer um redirecionaria a liquidação alheia, que é a forma mais direta de roubar dinheiro neste desenho.