须区分两种地址: 交易资金的结算目的地,以及交易无法完成时, 加密资产 的退款目的地。
POST https://api.luniumpay.com/mesh/agents/{agent_id}/settlement
X-API-Key: lun_live_…
{"settlement_address": "0x…"}
这是 Mesh 激活生产的前提,须选择平台支持的结算网络,并提供该网络有效地址。
refund_address 退款地址这是独立配置,应为 您客户本人控制的钱包,须兼容该订单实际退款网络;Pix 无法完成时,按退款说明将资产返还至此。
refund_address时,也不会自动退至链上充值来源。若客户从交易所提币,来源可能是 交易所共用钱包,并不直接属于客户。订单会停留于 AWAITING_REFUND_ADDRESS (webhook: cashout.awaiting_refund_address),直至通过以下接口提供客户钱包: POST /cash-outs/{cashout_id}/refund-address。如已持有该钱包,可在创建时提前提交。| 情况 | 情况 |
|---|---|
| 充值后 Pix 收款标识被拒绝 | 资金返还至托管后,按 refund_address处理,状态为 REFUNDED,并提供 refund_tx_hash。 |
| 发送至结算服务商前失败 | 部分路由会每 5 分钟重试,最长约 45 分钟。是否退款、金额及费用须以对应订单和路由返回为准,不能一概承诺 全额 退款或固定退款期限。 |
| 充值金额与报价不同 | 按实际收到金额及路由规则核算,可能重新报价或进入核查,须继续跟踪原订单。 |
充值晚于 expires_at | 部分路由仍会在原订单观察窗口内识别晚到充值,最长可能为 7 天。以原订单状态及处理说明为准,不复用地址创建其他交易。 |
最终资金结果须以状态及凭证确认,例如: COMPLETED (Pix 已付款,提供 E2E)或 REFUNDED (加密资产已退回,提供哈希)。未达最终结果时继续核查,不把审核或不确定状态当作成功或失败。
修改须使用智能体自身密钥。 agent_id 仅识别身份,不能授权修改,避免他人仅凭公开 ID 改变结算目的地。