API 参考文档

{"maxLength":200}

{"maxLength":120}

{"maxLength":120}

{"maxLength":40}

{"maxLength":1000}

{"enum":["cashin","cashout","cashin_cashout","payout","outro","custody"]}

{"maxLength":60}

{"maxLength":60}

{"maxLength":60}

用户自行申报的来源，与 UTM 分开，例如 chatgpt、google、indicacao。

确认用户提供联系方式，以接收对此次请求的回复。

{"const":true}

请求开始时所在页面或业务背景。

反垃圾隐藏字段，正常客户端应省略或留空。

{"const":true}

用户明确同意后返回的不透明归因 token，仅发送至 POST /keys、POST /keys/sandbox 或 lunium_start_sandbox_demo，绝不放入 URL 或日志。

{"minLength":47,"maxLength":47,"pattern":"^ldt_[A-Za-z0-9_-]{43}$"}

立即开始自助接入，人工联系为可选。

{"const":true}

用户明确同意后返回的不透明归因 token，仅发送至 POST /keys、POST /keys/sandbox 或 lunium_start_sandbox_demo，绝不放入 URL 或日志。

{"minLength":47,"maxLength":47,"pattern":"^ldt_[A-Za-z0-9_-]{43}$"}

立即开始自助接入，人工联系为可选。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

巴西央行端到端标识：E + 32 个字符。

原样返回的巴西央行端到端标识，由字母 E 及凭证代码组成。任何第三方均可通过同一接口重新核验。

含明确时区偏移的 ISO 8601 时间，采用巴西利亚时间。不要默认 UTC 或设备本地时间，应使用返回的偏移。

FAST 渠道的可用组合。充值 / Pix 时效取决于具体交易，不是固定 SLA。自2026年9月24日起包含平台 DEPIX/liquid 路由，该项目有独立 min、max、费用及时效。

DEX 长尾代币支持的网络及说明。

交易所渠道，每个资产列出支持网络。自2026年9月6日起包含 solana、tron，以及 XRP、XLM、ATOM、HBAR、KAVA、HIVE、STEEM、IOST 等共用地址网络；这些网络在接受报价后返回 deposit_tag。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

卖出的资产。必须使用 GET /catalog 中完全一致的 id，例如 "usdt"。须与 network 组合使用，且 (asset, network) 必须存在于目录。

GET /catalog 列出的加密资产入金网络，不同于 /cashin/catalog 的交付网络。

加密资产数量，十进制字符串，例如 "50"，不要使用浮点数。不能同时传 brl_amount 或 br_code，此方式创建订单时须提供 pix_key。

反向报价的目标 BRL 金额，最多两位小数的字符串，例如 "250.00"。不能同时传 amount 或 br_code，创建时须提供 pix_key。响应返回精确加密资产充值量及实际 BRL 金额，后者可能因舍入与目标略有差异。接受前展示返回金额，最低金额及限额以路由、密钥及收款人当前条件为准。

接收 BRL 的 Pix 标识。格式由 API 规范化为服务商要求，不符合时在创建充值前返回 400 pix_key_invalida。支持 CPF 11 位、CNPJ 14 位、+55 国际格式手机号（如 +5548996005588）、邮箱，或 UUID 随机标识（如 6602ede6-b1a9-4e63-9178-c6883fd0095e）。

可选，通常根据收款标识格式推断，如邮箱、CNPJ、UUID 或带 +55 的手机号。若为 11 位纯数字，无法区分 CPF 与手机号，则必须填写，否则返回 tipo_ambiguo，不会擅自猜测。

{"enum":["cpf","cnpj","phone","email","random"]}

精确合约地址 / mint。/catalog/dex 代币可能有相同符号，因此必须明确地址。

每个业务意图的持久标识，最多 64 个字符。相同请求体重试复用原订单；更改网络、资产、token、目的地、Pix 类型、金额或退款钱包会产生 409 冲突。须先恢复原订单，再决定是否新建。旧订单若缺少可验证请求身份，可能须按 cashout_id/external_id 恢复。

{"maxLength":64}

客户确认并控制的退款钱包，须符合退款网络。不能根据充值链上来源自动推断。未提供钱包时，流程可能停留于 AWAITING_REFUND_ADDRESS；请查询返回的 refund_asset、refund_network 及 refund_amount。DePix 卖出自 1.44.0 起也为可选，此前必填；如提供，须为客户有效的 Liquid 地址（lq1…），测试环境同样要求格式有效。

已启用时可提交带固定金额的 Pix Copia e Cola，支持兼容的 USDT/USDC 路由，替代 pix_key、amount 及 brl_amount。生产可能返回 503 br_code_indisponivel。报价 amount 已包含固定 R$ 1 运营预留款（reserve_brl，其 USDT 等值见 copia_e_cola_buffer_usd），用于确保按二维码精确金额付款；剩余部分由 Lunium 留作修正预留，不退还。客户粘贴或扫描了带金额的静态 / 动态二维码时，须发送完整 br_code，不能仅提取 pix_key + brl_amount，否则可能无法保留原收款单 txid 或精确金额，收款方可能无法匹配。

{"minLength":40,"maxLength":512}

仅用于测试环境 DePix/Liquid，优先于金额小数触发条件。未明确指定场景时，.01 至 .08 触发仍有效。生产密钥返回 403 sandbox_only，场景见 GET /sandbox。

{"enum":["success","delayed","failed","expired","refunded","settlement_uncertain","provider_unavailable","route_unavailable","no_deposit"]}

DePix/Liquid 收款人的 CPF（11 位）或 CNPJ（14 位）。email、phone 或 random 类型 Pix 标识必填；cpf/cnpj 类型直接使用标识本身的证件。生产不得使用虚构证件。

不透明订单标识，生产环境可能为 UUID，测试环境以 sbx_ 开头。原样保存，不做类型转换。

订单状态。COMPLETED 确认 Pix 已付款，中间阶段因渠道而异，DELAYED 属于测试场景。AWAITING_REFUND_ADDRESS 表示须退款但尚无钱包，通过 POST /cash-outs/{cashout_id}/refund-address 提交；适用于加密资产卖出，以及自 1.44.0 起的 DePix 卖出。DePix 成功流程为 QUOTE_CREATED → AWAITING_DEPOSIT → DEPOSIT_DETECTED → PROCESSING → COMPLETED。Pix 无法支付时进入 REFUNDING → REFUNDED，缺少钱包则 AWAITING_REFUND_ADDRESS。若 DePix 已发送至服务商，须确认资金返还后才可退款；此前保持 MANUAL_REVIEW，退款最高为实际返还金额。

{"enum":["QUOTE_CREATED","AWAITING_DEPOSIT","DEPOSIT_DETECTED","DEPOSIT_CONFIRMED","SELLING","SOLD","FORWARDING","PAYING_OUT","COMPLETED","MANUAL_REVIEW","REFUNDING_CRYPTO","REFUNDED","EXPIRED","FAILED","DELAYED","AWAITING_REFUND_ADDRESS","PROCESSING","REFUNDING"]}

FAST、DEX 或 CONVERT 渠道。时效取决于路由、确认及处理。DePix/Liquid 使用 depix_liquid。

{"enum":["FAST","DEX","CONVERT",null,"depix_liquid"]}

卖出的资产。必须使用 GET /catalog 中完全一致的 id，例如 "usdt"。须与 network 组合使用，且 (asset, network) 必须存在于目录。

目录列出的充值区块链网络，例如 "polygon"。返回地址仅对该网络有效。

加密资产数量，以十进制字符串表示，绝不使用浮点数。

Pix 收款账户将收到的巴西雷亚尔（BRL）金额。

响应中经遮盖的收款人 Pix 标识。请求传入完整标识，不要将遮盖后的响应与原值逐字比较。

通常可省略，邮箱、CNPJ、随机标识及带 +55 的手机号可根据格式推断。11 位纯数字无法区分 CPF 与手机号，必须明确指定类型，以免付错收款人。显式类型优先于推断。

{"enum":["cpf","cnpj","phone","email","random"]}

客户发送加密资产的地址，仅在接受报价后提供。测试环境 DePix 返回不可付款标记 SANDBOX:LIQUID:NAO_ENVIAR:…，切勿发送真实资产。

接受报价时返回的 memo/tag，充值须一并填写。仅使用 GET /catalog 中的网络。

每个业务意图的持久标识，最多 64 个字符。相同请求体重试复用原订单；更改网络、资产、token、目的地、Pix 类型、金额或退款钱包会产生 409 冲突。须先恢复原订单，再决定是否新建。旧订单若缺少可验证请求身份，可能须按 cashout_id/external_id 恢复。

{"maxLength":64}

客户确认的退款钱包，缺失时不代表可以使用 deposit_from。订单可能停留于 AWAITING_REFUND_ADDRESS。自 1.44.0 起，DePix 卖出也适用，须提供客户 Liquid 地址 lq1…。

退款完成后的交易哈希，不代表所有退款均有固定金额或时限。

充值的链上来源，仅供参考，可能为交易所共用钱包。绝不能自动将其选为退款目的地。

报价时提供的 Copia e Cola 支付码（如有），brl_amount 为二维码金额。

从收款二维码中读取的收款人姓名。

R$ 1 运营预留款的 USDT 等值金额，报价时换算，已包含在总额中，不要重复加上。已有订单保留其原金额。

报价到期时间，ISO 8601 UTC，例如 2026-09-02T14:03:00Z。过期后接受报价返回 erro=cotacao_expirada，应重新报价，不要反复提交。

Pix 完成后的巴西央行端到端标识，可通过 GET /v1/verificar/{e2e} 无需密钥公开核验。可向最终客户提供。测试环境为虚构 E2E，ISPB 为 00000000，不能证明银行付款。

可分享的凭证页面链接，生成后提供。cashout.completed 事件中可能仍为 null，后续 cashout.receipt_ready 或同一订单查询会提供链接。

PDF 凭证文件，可附至工单、发送给客户或留作会计档案，核查时不依赖在线凭证页面。包含收款人姓名、证件及机构、金额、日期、E2E 和核验链接，与在线页面使用同一数据源。在订单尚未达到对应阶段时为 null。凭证内容及 API、webhook、控制台、Telegram 等获取方式详见 https://docs.luniumpay.com/zh/manual#comprovante 。

{"nullable":true}

公开核验直达链接，无需密钥，可交给交易对方独立确认付款。不会展示 Pix 收款标识、完整姓名或完整证件。订单尚未达到相应阶段时为 null。

{"nullable":true}

服务器在状态变化时记录的时间线，来自网关时间而非轮询时间：AWAITING_DEPOSIT → DEPOSIT_DETECTED → DEPOSIT_CONFIRMED →（SELLING → SOLD → FORWARDING，仅交易所渠道）→ PAYING_OUT → COMPLETED。用于客户交易跟踪界面。

当前已观察到的充值确认数，仅在订单等待网络确认时返回，不持久保存，会随区块变化。结合 confirmations_required 展示实际进展，不要编造进度。

交易所对该网络充值入账所要求的确认数。

返回的失败原因，包括测试环境场景。

模拟交易时为 true。

该笔卖出创建时保存的合作伙伴 sub fee，单位 bps。早于此字段的旧订单或 DePix 卖出可能为 null。

{"nullable":true}

Pix 确认时确定的合作伙伴份额，以分计，即记入佣金账本的金额。

{"nullable":true}

AWAITING_REFUND_ADDRESS 时为 true。查询退款资料，并通过 POST /cash-outs/{cashout_id}/refund-address 提交客户确认的钱包。

核算后的实际退款数量，不要默认等于最初充值量。DePix 全部由 Lunium 持有时，AWAITING_REFUND_ADDRESS 已提供 refund_amount、refund_asset（DEPIX）及 refund_network（liquid）。若已转交服务商，MANUAL_REVIEW 中这些字段保持 null，直至确认返还；之后 refund_amount 最高为实际返还金额加未转交部分，且不超过订单金额。

实际退款资产，可能与充值资产不同。

实际退款网络，须使用客户确认且兼容的钱包。

合作服务商向 Lunium 返还资金的参考标识，不是向客户完成退款的证明。

DePix 卖出费率，单位 bps。

DePix 卖出固定费用，以分计。

总费用，以分计，在 DePix 报价及模拟订单中提供。

Pix 净额，以分计，在 DePix 报价及模拟订单中提供。

R$ 1 运营预留款的 USDT 等值金额，报价时换算，已包含在总额中，不要重复加上。已有订单保留其原金额。

新订单固定 R$ 1 运营预留款，已包含在总额中。旧订单保留原预留金额。

不透明订单标识，生产环境可能为 UUID，测试环境以 sbx_ 开头。原样保存，不做类型转换。

订单状态。COMPLETED 确认 Pix 已付款，中间阶段因渠道而异，DELAYED 属于测试场景。AWAITING_REFUND_ADDRESS 表示须退款但尚无钱包，通过 POST /cash-outs/{cashout_id}/refund-address 提交；适用于加密资产卖出，以及自 1.44.0 起的 DePix 卖出。DePix 成功流程为 QUOTE_CREATED → AWAITING_DEPOSIT → DEPOSIT_DETECTED → PROCESSING → COMPLETED。Pix 无法支付时进入 REFUNDING → REFUNDED，缺少钱包则 AWAITING_REFUND_ADDRESS。若 DePix 已发送至服务商，须确认资金返还后才可退款；此前保持 MANUAL_REVIEW，退款最高为实际返还金额。

{"enum":["QUOTE_CREATED","AWAITING_DEPOSIT","DEPOSIT_DETECTED","DEPOSIT_CONFIRMED","SELLING","SOLD","FORWARDING","PAYING_OUT","COMPLETED","MANUAL_REVIEW","REFUNDING_CRYPTO","REFUNDED","EXPIRED","FAILED","DELAYED","AWAITING_REFUND_ADDRESS","PROCESSING","REFUNDING"]}

FAST、DEX 或 CONVERT 渠道。时效取决于路由、确认及处理。DePix/Liquid 使用 depix_liquid。

{"enum":["FAST","DEX","CONVERT",null,"depix_liquid"]}

卖出的资产。必须使用 GET /catalog 中完全一致的 id，例如 "usdt"。须与 network 组合使用，且 (asset, network) 必须存在于目录。

目录列出的充值区块链网络，例如 "polygon"。返回地址仅对该网络有效。

加密资产数量，以十进制字符串表示，绝不使用浮点数。

Pix 收款账户将收到的巴西雷亚尔（BRL）金额。

响应中经遮盖的收款人 Pix 标识。请求传入完整标识，不要将遮盖后的响应与原值逐字比较。

通常可省略，邮箱、CNPJ、随机标识及带 +55 的手机号可根据格式推断。11 位纯数字无法区分 CPF 与手机号，必须明确指定类型，以免付错收款人。显式类型优先于推断。

{"enum":["cpf","cnpj","phone","email","random"]}

客户发送加密资产的地址，仅在接受报价后提供。测试环境 DePix 返回不可付款标记 SANDBOX:LIQUID:NAO_ENVIAR:…，切勿发送真实资产。

接受报价时返回的 memo/tag，充值须一并填写。仅使用 GET /catalog 中的网络。

每个业务意图的持久标识，最多 64 个字符。相同请求体重试复用原订单；更改网络、资产、token、目的地、Pix 类型、金额或退款钱包会产生 409 冲突。须先恢复原订单，再决定是否新建。旧订单若缺少可验证请求身份，可能须按 cashout_id/external_id 恢复。

{"maxLength":64}

客户确认的退款钱包，缺失时不代表可以使用 deposit_from。订单可能停留于 AWAITING_REFUND_ADDRESS。自 1.44.0 起，DePix 卖出也适用，须提供客户 Liquid 地址 lq1…。

退款完成后的交易哈希，不代表所有退款均有固定金额或时限。

充值的链上来源，仅供参考，可能为交易所共用钱包。绝不能自动将其选为退款目的地。

报价时提供的 Copia e Cola 支付码（如有），brl_amount 为二维码金额。

从收款二维码中读取的收款人姓名。

R$ 1 运营预留款的 USDT 等值金额，报价时换算，已包含在总额中，不要重复加上。已有订单保留其原金额。

报价到期时间，ISO 8601 UTC，例如 2026-09-02T14:03:00Z。过期后接受报价返回 erro=cotacao_expirada，应重新报价，不要反复提交。

Pix 完成后的巴西央行端到端标识，可通过 GET /v1/verificar/{e2e} 无需密钥公开核验。可向最终客户提供。测试环境为虚构 E2E，ISPB 为 00000000，不能证明银行付款。

可分享的凭证页面链接，生成后提供。cashout.completed 事件中可能仍为 null，后续 cashout.receipt_ready 或同一订单查询会提供链接。

PDF 凭证文件，可附至工单、发送给客户或留作会计档案，核查时不依赖在线凭证页面。包含收款人姓名、证件及机构、金额、日期、E2E 和核验链接，与在线页面使用同一数据源。在订单尚未达到对应阶段时为 null。凭证内容及 API、webhook、控制台、Telegram 等获取方式详见 https://docs.luniumpay.com/zh/manual#comprovante 。

{"nullable":true}

公开核验直达链接，无需密钥，可交给交易对方独立确认付款。不会展示 Pix 收款标识、完整姓名或完整证件。订单尚未达到相应阶段时为 null。

{"nullable":true}

服务器在状态变化时记录的时间线，来自网关时间而非轮询时间：AWAITING_DEPOSIT → DEPOSIT_DETECTED → DEPOSIT_CONFIRMED →（SELLING → SOLD → FORWARDING，仅交易所渠道）→ PAYING_OUT → COMPLETED。用于客户交易跟踪界面。

当前已观察到的充值确认数，仅在订单等待网络确认时返回，不持久保存，会随区块变化。结合 confirmations_required 展示实际进展，不要编造进度。

交易所对该网络充值入账所要求的确认数。

返回的失败原因，包括测试环境场景。

模拟交易时为 true。

该笔卖出创建时保存的合作伙伴 sub fee，单位 bps。早于此字段的旧订单或 DePix 卖出可能为 null。

{"nullable":true}

Pix 确认时确定的合作伙伴份额，以分计，即记入佣金账本的金额。

{"nullable":true}

AWAITING_REFUND_ADDRESS 时为 true。查询退款资料，并通过 POST /cash-outs/{cashout_id}/refund-address 提交客户确认的钱包。

核算后的实际退款数量，不要默认等于最初充值量。DePix 全部由 Lunium 持有时，AWAITING_REFUND_ADDRESS 已提供 refund_amount、refund_asset（DEPIX）及 refund_network（liquid）。若已转交服务商，MANUAL_REVIEW 中这些字段保持 null，直至确认返还；之后 refund_amount 最高为实际返还金额加未转交部分，且不超过订单金额。

实际退款资产，可能与充值资产不同。

实际退款网络，须使用客户确认且兼容的钱包。

合作服务商向 Lunium 返还资金的参考标识，不是向客户完成退款的证明。

DePix 卖出费率，单位 bps。

DePix 卖出固定费用，以分计。

总费用，以分计，在 DePix 报价及模拟订单中提供。

Pix 净额，以分计，在 DePix 报价及模拟订单中提供。

R$ 1 运营预留款的 USDT 等值金额，报价时换算，已包含在总额中，不要重复加上。已有订单保留其原金额。

新订单固定 R$ 1 运营预留款，已包含在总额中。旧订单保留原预留金额。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

幂等恢复：返回该 external_id 对应的交易，结果为 0 或 1 笔。标识在同一密钥及产品内唯一，区分大小写，并永久保留。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

不透明订单标识，生产环境可能为 UUID，测试环境以 sbx_ 开头。原样保存，不做类型转换。

订单状态。COMPLETED 确认 Pix 已付款，中间阶段因渠道而异，DELAYED 属于测试场景。AWAITING_REFUND_ADDRESS 表示须退款但尚无钱包，通过 POST /cash-outs/{cashout_id}/refund-address 提交；适用于加密资产卖出，以及自 1.44.0 起的 DePix 卖出。DePix 成功流程为 QUOTE_CREATED → AWAITING_DEPOSIT → DEPOSIT_DETECTED → PROCESSING → COMPLETED。Pix 无法支付时进入 REFUNDING → REFUNDED，缺少钱包则 AWAITING_REFUND_ADDRESS。若 DePix 已发送至服务商，须确认资金返还后才可退款；此前保持 MANUAL_REVIEW，退款最高为实际返还金额。

{"enum":["QUOTE_CREATED","AWAITING_DEPOSIT","DEPOSIT_DETECTED","DEPOSIT_CONFIRMED","SELLING","SOLD","FORWARDING","PAYING_OUT","COMPLETED","MANUAL_REVIEW","REFUNDING_CRYPTO","REFUNDED","EXPIRED","FAILED","DELAYED","AWAITING_REFUND_ADDRESS","PROCESSING","REFUNDING"]}

FAST、DEX 或 CONVERT 渠道。时效取决于路由、确认及处理。DePix/Liquid 使用 depix_liquid。

{"enum":["FAST","DEX","CONVERT",null,"depix_liquid"]}

卖出的资产。必须使用 GET /catalog 中完全一致的 id，例如 "usdt"。须与 network 组合使用，且 (asset, network) 必须存在于目录。

目录列出的充值区块链网络，例如 "polygon"。返回地址仅对该网络有效。

加密资产数量，以十进制字符串表示，绝不使用浮点数。

Pix 收款账户将收到的巴西雷亚尔（BRL）金额。

响应中经遮盖的收款人 Pix 标识。请求传入完整标识，不要将遮盖后的响应与原值逐字比较。

通常可省略，邮箱、CNPJ、随机标识及带 +55 的手机号可根据格式推断。11 位纯数字无法区分 CPF 与手机号，必须明确指定类型，以免付错收款人。显式类型优先于推断。

{"enum":["cpf","cnpj","phone","email","random"]}

客户发送加密资产的地址，仅在接受报价后提供。测试环境 DePix 返回不可付款标记 SANDBOX:LIQUID:NAO_ENVIAR:…，切勿发送真实资产。

接受报价时返回的 memo/tag，充值须一并填写。仅使用 GET /catalog 中的网络。

每个业务意图的持久标识，最多 64 个字符。相同请求体重试复用原订单；更改网络、资产、token、目的地、Pix 类型、金额或退款钱包会产生 409 冲突。须先恢复原订单，再决定是否新建。旧订单若缺少可验证请求身份，可能须按 cashout_id/external_id 恢复。

{"maxLength":64}

客户确认的退款钱包，缺失时不代表可以使用 deposit_from。订单可能停留于 AWAITING_REFUND_ADDRESS。自 1.44.0 起，DePix 卖出也适用，须提供客户 Liquid 地址 lq1…。

退款完成后的交易哈希，不代表所有退款均有固定金额或时限。

充值的链上来源，仅供参考，可能为交易所共用钱包。绝不能自动将其选为退款目的地。

报价时提供的 Copia e Cola 支付码（如有），brl_amount 为二维码金额。

从收款二维码中读取的收款人姓名。

R$ 1 运营预留款的 USDT 等值金额，报价时换算，已包含在总额中，不要重复加上。已有订单保留其原金额。

报价到期时间，ISO 8601 UTC，例如 2026-09-02T14:03:00Z。过期后接受报价返回 erro=cotacao_expirada，应重新报价，不要反复提交。

Pix 完成后的巴西央行端到端标识，可通过 GET /v1/verificar/{e2e} 无需密钥公开核验。可向最终客户提供。测试环境为虚构 E2E，ISPB 为 00000000，不能证明银行付款。

可分享的凭证页面链接，生成后提供。cashout.completed 事件中可能仍为 null，后续 cashout.receipt_ready 或同一订单查询会提供链接。

PDF 凭证文件，可附至工单、发送给客户或留作会计档案，核查时不依赖在线凭证页面。包含收款人姓名、证件及机构、金额、日期、E2E 和核验链接，与在线页面使用同一数据源。在订单尚未达到对应阶段时为 null。凭证内容及 API、webhook、控制台、Telegram 等获取方式详见 https://docs.luniumpay.com/zh/manual#comprovante 。

{"nullable":true}

公开核验直达链接，无需密钥，可交给交易对方独立确认付款。不会展示 Pix 收款标识、完整姓名或完整证件。订单尚未达到相应阶段时为 null。

{"nullable":true}

服务器在状态变化时记录的时间线，来自网关时间而非轮询时间：AWAITING_DEPOSIT → DEPOSIT_DETECTED → DEPOSIT_CONFIRMED →（SELLING → SOLD → FORWARDING，仅交易所渠道）→ PAYING_OUT → COMPLETED。用于客户交易跟踪界面。

当前已观察到的充值确认数，仅在订单等待网络确认时返回，不持久保存，会随区块变化。结合 confirmations_required 展示实际进展，不要编造进度。

交易所对该网络充值入账所要求的确认数。

返回的失败原因，包括测试环境场景。

模拟交易时为 true。

该笔卖出创建时保存的合作伙伴 sub fee，单位 bps。早于此字段的旧订单或 DePix 卖出可能为 null。

{"nullable":true}

Pix 确认时确定的合作伙伴份额，以分计，即记入佣金账本的金额。

{"nullable":true}

AWAITING_REFUND_ADDRESS 时为 true。查询退款资料，并通过 POST /cash-outs/{cashout_id}/refund-address 提交客户确认的钱包。

核算后的实际退款数量，不要默认等于最初充值量。DePix 全部由 Lunium 持有时，AWAITING_REFUND_ADDRESS 已提供 refund_amount、refund_asset（DEPIX）及 refund_network（liquid）。若已转交服务商，MANUAL_REVIEW 中这些字段保持 null，直至确认返还；之后 refund_amount 最高为实际返还金额加未转交部分，且不超过订单金额。

实际退款资产，可能与充值资产不同。

实际退款网络，须使用客户确认且兼容的钱包。

合作服务商向 Lunium 返还资金的参考标识，不是向客户完成退款的证明。

DePix 卖出费率，单位 bps。

DePix 卖出固定费用，以分计。

总费用，以分计，在 DePix 报价及模拟订单中提供。

Pix 净额，以分计，在 DePix 报价及模拟订单中提供。

R$ 1 运营预留款的 USDT 等值金额，报价时换算，已包含在总额中，不要重复加上。已有订单保留其原金额。

新订单固定 R$ 1 运营预留款，已包含在总额中。旧订单保留原预留金额。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

不透明订单标识，生产环境可能为 UUID，测试环境以 sbx_ 开头。原样保存，不做类型转换。

订单状态。COMPLETED 确认 Pix 已付款，中间阶段因渠道而异，DELAYED 属于测试场景。AWAITING_REFUND_ADDRESS 表示须退款但尚无钱包，通过 POST /cash-outs/{cashout_id}/refund-address 提交；适用于加密资产卖出，以及自 1.44.0 起的 DePix 卖出。DePix 成功流程为 QUOTE_CREATED → AWAITING_DEPOSIT → DEPOSIT_DETECTED → PROCESSING → COMPLETED。Pix 无法支付时进入 REFUNDING → REFUNDED，缺少钱包则 AWAITING_REFUND_ADDRESS。若 DePix 已发送至服务商，须确认资金返还后才可退款；此前保持 MANUAL_REVIEW，退款最高为实际返还金额。

{"enum":["QUOTE_CREATED","AWAITING_DEPOSIT","DEPOSIT_DETECTED","DEPOSIT_CONFIRMED","SELLING","SOLD","FORWARDING","PAYING_OUT","COMPLETED","MANUAL_REVIEW","REFUNDING_CRYPTO","REFUNDED","EXPIRED","FAILED","DELAYED","AWAITING_REFUND_ADDRESS","PROCESSING","REFUNDING"]}

FAST、DEX 或 CONVERT 渠道。时效取决于路由、确认及处理。DePix/Liquid 使用 depix_liquid。

{"enum":["FAST","DEX","CONVERT",null,"depix_liquid"]}

卖出的资产。必须使用 GET /catalog 中完全一致的 id，例如 "usdt"。须与 network 组合使用，且 (asset, network) 必须存在于目录。

目录列出的充值区块链网络，例如 "polygon"。返回地址仅对该网络有效。

加密资产数量，以十进制字符串表示，绝不使用浮点数。

Pix 收款账户将收到的巴西雷亚尔（BRL）金额。

响应中经遮盖的收款人 Pix 标识。请求传入完整标识，不要将遮盖后的响应与原值逐字比较。

通常可省略，邮箱、CNPJ、随机标识及带 +55 的手机号可根据格式推断。11 位纯数字无法区分 CPF 与手机号，必须明确指定类型，以免付错收款人。显式类型优先于推断。

{"enum":["cpf","cnpj","phone","email","random"]}

客户发送加密资产的地址，仅在接受报价后提供。测试环境 DePix 返回不可付款标记 SANDBOX:LIQUID:NAO_ENVIAR:…，切勿发送真实资产。

接受报价时返回的 memo/tag，充值须一并填写。仅使用 GET /catalog 中的网络。

每个业务意图的持久标识，最多 64 个字符。相同请求体重试复用原订单；更改网络、资产、token、目的地、Pix 类型、金额或退款钱包会产生 409 冲突。须先恢复原订单，再决定是否新建。旧订单若缺少可验证请求身份，可能须按 cashout_id/external_id 恢复。

{"maxLength":64}

客户确认的退款钱包，缺失时不代表可以使用 deposit_from。订单可能停留于 AWAITING_REFUND_ADDRESS。自 1.44.0 起，DePix 卖出也适用，须提供客户 Liquid 地址 lq1…。

退款完成后的交易哈希，不代表所有退款均有固定金额或时限。

充值的链上来源，仅供参考，可能为交易所共用钱包。绝不能自动将其选为退款目的地。

报价时提供的 Copia e Cola 支付码（如有），brl_amount 为二维码金额。

从收款二维码中读取的收款人姓名。

R$ 1 运营预留款的 USDT 等值金额，报价时换算，已包含在总额中，不要重复加上。已有订单保留其原金额。

报价到期时间，ISO 8601 UTC，例如 2026-09-02T14:03:00Z。过期后接受报价返回 erro=cotacao_expirada，应重新报价，不要反复提交。

Pix 完成后的巴西央行端到端标识，可通过 GET /v1/verificar/{e2e} 无需密钥公开核验。可向最终客户提供。测试环境为虚构 E2E，ISPB 为 00000000，不能证明银行付款。

可分享的凭证页面链接，生成后提供。cashout.completed 事件中可能仍为 null，后续 cashout.receipt_ready 或同一订单查询会提供链接。

PDF 凭证文件，可附至工单、发送给客户或留作会计档案，核查时不依赖在线凭证页面。包含收款人姓名、证件及机构、金额、日期、E2E 和核验链接，与在线页面使用同一数据源。在订单尚未达到对应阶段时为 null。凭证内容及 API、webhook、控制台、Telegram 等获取方式详见 https://docs.luniumpay.com/zh/manual#comprovante 。

{"nullable":true}

公开核验直达链接，无需密钥，可交给交易对方独立确认付款。不会展示 Pix 收款标识、完整姓名或完整证件。订单尚未达到相应阶段时为 null。

{"nullable":true}

服务器在状态变化时记录的时间线，来自网关时间而非轮询时间：AWAITING_DEPOSIT → DEPOSIT_DETECTED → DEPOSIT_CONFIRMED →（SELLING → SOLD → FORWARDING，仅交易所渠道）→ PAYING_OUT → COMPLETED。用于客户交易跟踪界面。

当前已观察到的充值确认数，仅在订单等待网络确认时返回，不持久保存，会随区块变化。结合 confirmations_required 展示实际进展，不要编造进度。

交易所对该网络充值入账所要求的确认数。

返回的失败原因，包括测试环境场景。

模拟交易时为 true。

该笔卖出创建时保存的合作伙伴 sub fee，单位 bps。早于此字段的旧订单或 DePix 卖出可能为 null。

{"nullable":true}

Pix 确认时确定的合作伙伴份额，以分计，即记入佣金账本的金额。

{"nullable":true}

AWAITING_REFUND_ADDRESS 时为 true。查询退款资料，并通过 POST /cash-outs/{cashout_id}/refund-address 提交客户确认的钱包。

核算后的实际退款数量，不要默认等于最初充值量。DePix 全部由 Lunium 持有时，AWAITING_REFUND_ADDRESS 已提供 refund_amount、refund_asset（DEPIX）及 refund_network（liquid）。若已转交服务商，MANUAL_REVIEW 中这些字段保持 null，直至确认返还；之后 refund_amount 最高为实际返还金额加未转交部分，且不超过订单金额。

实际退款资产，可能与充值资产不同。

实际退款网络，须使用客户确认且兼容的钱包。

合作服务商向 Lunium 返还资金的参考标识，不是向客户完成退款的证明。

DePix 卖出费率，单位 bps。

DePix 卖出固定费用，以分计。

总费用，以分计，在 DePix 报价及模拟订单中提供。

Pix 净额，以分计，在 DePix 报价及模拟订单中提供。

R$ 1 运营预留款的 USDT 等值金额，报价时换算，已包含在总额中，不要重复加上。已有订单保留其原金额。

新订单固定 R$ 1 运营预留款，已包含在总额中。旧订单保留原预留金额。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

收款金额，以整数 BRL 分计，例如 15000 = R$ 150.00。创建前查询 GET /cashin/limits，获取付款人当前无需冻结及需要冻结的额度区间。

交付路由的网络，将目录中的 network 值填入此 chain 字段。

{"default":"polygon"}

GET /cashin/catalog 中可交付路由的资产，不限于稳定币。

{"default":"usdt"}

destino=cripto 时为该收款单的钱包，省略时可能使用密钥的 settlement_address；destino=saldo 时应省略。地址必须符合所选网络。

付款人 CPF（11 位）或 CNPJ（14 位），仅数字。用于识别付款人，并计算 GET /cashin/limits 公布的反欺诈限额与冻结条件。

最多 64 个字符的幂等标识。重试保持相同标识及全部参数。差异比较规则因接口而异，不要利用重放修改原交易。409 external_id_divergente 表示检测到冲突。

{"maxLength":64}

saldo 将扣费后的净额计入 BRL 托管余额，无需钱包；cripto（默认）交付至所填或已配置的钱包。费用及等待期见 GET /saldo，冻结条件见收款单创建响应及状态。

{"enum":["cripto","saldo"],"default":"cripto"}

可选余额子账户，即您的最终客户 ID。destino: "saldo" 时入账至该子账户；GET /saldo?customer_ref= 查询，POST /payouts 使用相同 customer_ref 支出。省略时使用密钥主账户。

{"maxLength":80}

false 会拒绝需要按付款人分级规则冻结的收款单，不会移除密钥的其他冻结或限制。true 或省略时允许适用冻结。须同时读取 held_hours 及 hold_hours/liberar_em。

{"default":true}

目标 memo/tag。XRP、XLM、TON、ATOM、HBAR、ALGO、EOS、KAVA、LUNA 等共用地址网络须提供，以识别实际收款人。缺少时，创建收款单前返回 400 memo_obrigatorio。XRP 使用 destination tag，为 0 至 4294967295 的整数。支持 memo、tag、destination_tag 别名，目录以 memoRequired: true 标记。

{"maxLength":120}

付款人姓名，如提供。

仅用于测试密钥。GET /sandbox 提供各流程的场景矩阵，生产环境应省略。价格、付款及提现均为模拟结果。

{"enum":["success","delayed","held","expired","refunded","failed","payer_mismatch","settlement_failed","settlement_uncertain","route_unavailable","provider_unavailable"]}

仅 chain="liquid"（DePix）适用。full 直接向指定钱包交付全部 DePix，不从中扣除密钥费用。split 采用接收再转发：Lunium 接收后扣除密钥的固定及比例费用，再向 payout_address 发送净额，响应 net_cents 即收款人实际接收金额。split 必须提供 payout_address。省略此字段时，以密钥的实际默认配置为准。

{"enum":["full","split"],"default":"full"}

收款单标识，格式为 ci_…。

Pix 状态。paid 本身不证明入账 / 交付完成，须读取 settlement_status。

{"enum":["pending","delayed","under_review","paid","expired","refunded","failed"]}

Pix 金额，以分计。

cripto 表示链上交付，saldo 表示计入密钥 BRL 托管余额，可通过 POST /payouts 及 POST /saldo/sacar-cripto 使用。

{"enum":["cripto","saldo"]}

创建时的资金来源：Pix 或余额提现。

{"enum":["pix","saldo"]}

您的最终客户引用，即余额子账户。

{"maxLength":80}

接收加密资产的钱包，适用于 destino=cripto。

共用收款地址等需要附加标识的网络，填写目标钱包 memo/tag，适用于 destino=cripto。

交付网络，使用 GET /cashin/catalog 中的 ID。

交付资产，如 usdt、usdc、btc 等。

创建收款单时固定的比例费用，单位 bps。

创建收款单时固定的费用，以分计。

创建收款单时保存的合作伙伴 sub fee。

创建时返回的 Pix Copia e Cola，托管余额提现时为 null。

二维码 PNG 图片，仅在创建响应中提供。

最多 64 个字符的幂等标识。重试保持相同标识及全部参数。差异比较规则因接口而异，不要利用重放修改原交易。409 external_id_divergente 表示检测到冲突。

{"maxLength":64}

该收款单的实际有效期，以此时间戳为准，也包括机器人延长的有效期。

服务商冻结的预计释放时间，如有。

余额入账结束等待期的时间。即时可用时为 null，新密钥自2026年9月16日起默认采用即时释放，但仍须核对适用冻结规则。

收款单本地冻结小时数，不等同于 held_hours 或余额的一般等待期。

向服务商请求的冻结时长。即使为零，也可能存在本地冻结 hold_hours/liberar_em。

held_hours > 0 时为 true，单独此字段不能反映本地冻结。

模拟交易时为 true。

仅 chain="liquid" 提供，说明 DePix 交付方式。其他网络无此字段。

{"enum":["full","split"]}

仅 chain="liquid" 且 delivery_mode="split" 提供，表示扣费后收款人实际收到的 DePix，即 Lunium 链上发送金额。

仅 chain="liquid" 且 delivery_mode="split" 提供，表示从总额扣除的固定及比例费用。net_cents + fee_total_cents == amount_cents。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

企业或项目名称，将显示在控制台及通知中。

{"minLength":2,"maxLength":80}

建议提供邮箱，新密钥除在响应中显示外，也会发送至此邮箱。

EVM（Polygon）结算钱包，可选，也可之后设置。

用于接收事件的 HTTPS URL，可选。

用户同意技术联系后，由 POST /leads 返回的 ldt_… 不透明 token，将此密钥关联至联系请求。仅放请求体，不放 URL。可选，缺失或无效不阻止创建。

{"minLength":47,"maxLength":47,"pattern":"^ldt_[A-Za-z0-9_-]{43}$"}

明文密钥，仅本次响应提供，平台只保存哈希。

成功将密钥副本发送至所填 email 时为 true；未填邮箱或发送失败时为 false。

提供 webhook_url 时出现。

密钥公开视图：prefix、name、flags。

当前有效限额。

当前密钥交易流程的只读实时监控。

提交已获同意的 lead_token 后，返回归因关联结果，绝不阻止密钥创建。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

当前密钥按单笔及付款人计算的限额与使用情况。每日限额为 null 仅表示没有该项上限，不代表不存在其他限制，仍可能适用 mandate 及个人限额。

enabled、via、unlocks_at_settled_volume_cents、settled_volume_cents、remaining_cents。

密钥的项目监控面板。

状态、合作伙伴及社区群组链接。

Sub fee 累计佣金，即合作伙伴余额，详情见 GET /comissao。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

{"minLength":2,"maxLength":80}

Polygon 地址，格式为 0x…；null 表示清除。

公开 HTTPS 地址，null 表示清除。如密钥尚无 webhook_secret，设置 URL 时会生成。

true 表示轮换 webhook 签名密钥，新值仅在响应中显示一次。

true 表示轮换监控 token。自本次调用起，旧 URL 无法再查看数据，新 URL 返回于 monitor_url。

合作伙伴 sub fee，以 bps 表示，另加于 Lunium 费用，由最终用户承担。100 = 1%，最高 1000 = 10%。仅影响新建收款单，已有收款单保留创建时费率；0 表示关闭。

{"minimum":0,"maximum":1000}

加密资产 → Pix 卖出的合作伙伴 sub fee，单位 bps，在 Lunium 费用之外另计。订单创建时固定，仅影响新订单，不适用于二维码 Copia e Cola 卖出。0 表示关闭。

{"minimum":0,"maximum":1000}

托管转出佣金，包括 POST /payouts 的 Pix 提现及 POST /saldo/sacar-cripto 的加密资产提现，单位 bps，在平台费用之外从余额另扣，提现完成后计入佣金。0 表示关闭。

{"minimum":0,"maximum":1000}

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

必填，测试人员邮箱，例如 you@company.com。LuniumPay 支持团队向该地址发送一封接入邮件，包含平台介绍、三步接入、手册及 PDF、流程图及 VendaCripto。每个地址仅发送一次，并附退订链接。

{"maxLength":160}

可选标签，便于之后识别密钥。

可选 HTTPS webhook。

可选，为用户同意后 POST /leads 返回的不透明 token，用于将此测试密钥关联至联系人。归因无效或不可用不会阻止创建密钥。不要将 token 放入 URL 或日志。

{"pattern":"^ldt_[A-Za-z0-9_-]{43}$"}

{"const":true}

上述确定性测试触发条件。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

CPF 为 11 位数字，CNPJ 为 14 位，仅接受数字。

返回给您的值已遮盖，不提供完整资料。

{"enum":["first_transaction","first_24h","mature","disabled","desconhecido"]}

含适用冻结的证件参考最高额度。创建时仍会核对密钥、最低金额及可用性。

当前阶段无需冻结即可接受的剩余额度，别名为 instant_available_cents。限额规则关闭时为 null（stage=disabled）。

限额规则关闭时为 null（stage=disabled）。

限额何时提高，以及提高至多少。

与 available_cents 相同，明确表示无需冻结即可接受的额度。

适用时提供需要冻结的额度条件。可能由服务商冻结，也可能是收款单本地冻结，须核对创建响应及状态。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

收款单标识，格式为 ci_…。

Pix 状态。paid 本身不证明入账 / 交付完成，须读取 settlement_status。

{"enum":["pending","delayed","under_review","paid","expired","refunded","failed"]}

入账 / 交付状态：sent 表示完成；incerto 须对账。Pix 已付款与资产交付是不同状态。

{"enum":["pending","sending","entregando","sent","incerto","failed",null]}

Pix 金额，以分计。

从结算服务商收到、尚未扣除密钥充值费用的金额，不是托管净入账。

结算返回的旧版数量字段，须结合 asset 及路由专有字段理解。

交付链上哈希，或交易所内部交付标识。

上述哈希的区块浏览器链接，如存在。

接收加密资产的钱包，适用于 destino=cripto。

共用收款地址等需要附加标识的网络，填写目标钱包 memo/tag，适用于 destino=cripto。

交付网络，使用 GET /cashin/catalog 中的 ID。

交付资产，如 usdt、usdc、btc 等。

应支付二维码的付款人 CPF/CNPJ。不同证件付款将退款，refund_reason 为 PAYER_MISMATCH。

最多 64 个字符的幂等标识。重试保持相同标识及全部参数。差异比较规则因接口而异，不要利用重放修改原交易。409 external_id_divergente 表示检测到冲突。

{"maxLength":64}

该收款单的实际有效期，以此时间戳为准，也包括机器人延长的有效期。

cripto 表示链上交付，saldo 表示计入密钥 BRL 托管余额，可通过 POST /payouts 及 POST /saldo/sacar-cripto 使用。

{"enum":["cripto","saldo"]}

向服务商请求的冻结时长。即使为零，也可能存在本地冻结 hold_hours/liberar_em。

held_hours > 0 时为 true，单独此字段不能反映本地冻结。

服务商冻结的预计释放时间，如有。

余额入账结束等待期的时间。即时可用时为 null，新密钥自2026年9月16日起默认采用即时释放，但仍须核对适用冻结规则。

收到的 Pix EndToEndId，即巴西央行端到端标识。

用户填写或银行识别的付款人姓名。

您的最终客户引用，即余额子账户。

{"maxLength":80}

status=refunded 时的退款原因，例如 PAYER_MISMATCH（付款证件不符）、TEST_AMOUNT（测试金额）或 PROVIDER_REJECTED。

便于人工阅读的退款原因。

交易渠道：casa、corretora、saldo 或 liquid，不构成时效承诺。

按渠道统计的各阶段耗时中位数，单位秒，用于展示典型耗时，不是保证期限。

模拟交易时为 true。

仅 chain="liquid" 提供，说明 DePix 交付方式。其他网络无此字段。

{"enum":["full","split"]}

仅 chain="liquid" 且 delivery_mode="split" 提供，表示扣费后收款人实际收到的 DePix，即 Lunium 链上发送金额。

仅 chain="liquid" 且 delivery_mode="split" 提供，表示从总额扣除的固定及比例费用。net_cents + fee_total_cents == amount_cents。

独立于 Pix 付款的交付证据：none = 无已完成发送；broadcast = 已提供交易但尚无已记录确认；confirmed = 已记录确认凭证；reported = 已报告完成但无链上证明，包括托管入账 / 内部转账；simulated = 无真实资金的测试。没有确认记录不能证明失败，核验覆盖范围取决于网络及时间段。

{"enum":["none","broadcast","confirmed","reported","simulated"]}

记录链上确认的时间，仅 settlement_proof=confirmed 时填写。

{"nullable":true}

已确认区块号，以字符串保存，避免精度损失。

{"nullable":true}

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

Pix 金额，以整数 BRL 分计，5000 = R$ 50.00。最高 600000（R$ 6,000.00），仍受账户较低限额约束，费用在此金额之外另行扣除。

{"minimum":1,"maximum":600000}

接收 BRL 的 Pix 收款标识：CPF、CNPJ、+55 手机号、邮箱或随机标识。11 位纯数字必须同时指定 pix_key_type（"cpf" 或 "phone"），否则返回 erro=tipo_ambiguo，不会猜测。

可选，通常根据收款标识格式推断，如邮箱、CNPJ、UUID 或带 +55 的手机号。若为 11 位纯数字，无法区分 CPF 与手机号，则必须填写，否则返回 tipo_ambiguo，不会擅自猜测。

{"enum":["cpf","cnpj","phone","email","random"]}

收款人的有效 CPF 或 CNPJ，须通过校验位检查。邮箱、手机号及随机收款标识必填；收款标识本身为有效 CPF/CNPJ 时可省略，API 直接提取，如另行提供则须一致。证件格式校验不证明该 Pix 标识的实际归属。

可选，收款人完整姓名，作为最终用户姓名发送给 Pix 服务商。不是必填项，允许向第三方 Pix 收款标识付款。

{"maxLength":120}

最多 64 个字符的幂等标识。重试保持原金额、Pix 标识、类型、证件、customer_ref 及 funding_source。409 external_id_divergente 或 external_id_nao_verificavel 会返回 payout_id/recovery_endpoint，供查询原订单；不要为绕过冲突生成新 ID。

{"maxLength":64}

扣款子账户，适用于托管密钥。Pix 发送前先扣除本金、平台费用（saque_fee_bps）及服务商费用；服务商明确拒绝时冲回扣款。可用余额低于本金及费用时返回 402 saldo_insuficiente，费用字段见 GET /saldo 的 saque_fee_bps、saque_taxa_estimada_cents。使用与充值时相同的子账户引用，例如商户引用。

{"maxLength":80}

仅用于测试密钥。GET /sandbox 提供各流程的场景矩阵，生产环境应省略。价格、付款及提现均为模拟结果。

{"enum":["success","delayed","held","expired","refunded","failed","payer_mismatch","settlement_failed","settlement_uncertain","route_unavailable","provider_unavailable"]}

可选，仅接受 pix_brl。此接口扣减通过 Pix 收到的 BRL 余额，绝不扣减 USDT 钱包。

{"enum":["pix_brl"]}

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

{"enum":["carencia_primeiro_deposito"]}

{"enum":["esperar"]}

{"maxLength":80}

processing、sent、failed 或 refunded，须通过流水核对余额，并兼容新增状态。

收款人实际收到的金额。

amount_cents 之外的总费用：fee_service_total_cents + fee_provider_cents。已包含合作伙伴佣金，不要重复加上。

已保存的 Lunium 服务费，以分计，为会计组成项。客户界面及通知应使用 fee_service_total_cents。

服务商费用：fee_cents 减去 fee_service_cents 及 fee_partner_cents。

{"enum":["cpf","cnpj","phone","email","random"]}

收款人证件经遮盖后的值，如有；请求中该字段为可选。

最多 64 个字符的幂等标识。重试保持相同标识及全部参数。差异比较规则因接口而异，不要利用重放修改原交易。409 external_id_divergente 表示检测到冲突。

{"maxLength":64}

failed/refunded 时的原因。

已发送 Pix 的 EndToEndId。

付款后取得的收款人姓名，如可用；未取得时为 null。

公开 Pix 核验，GET /v1/verificar/{e2e}。

模拟交易时为 true。

本次提现从余额扣除的合作伙伴 sub fee，以分计，已包含在 fee_cents 中。

{"nullable":true}

客户合并服务费，即交易保存的 Lunium 费用加合作伙伴佣金，保留原分位舍入及历史费率。旧记录中平台组成项未知时为 null。生产及测试环境的付款响应与 payout.* webhook data 均提供此字段。仅加一次 fee_provider_cents 即得 fee_cents，不再加 fee_partner_cents。

{"minimum":0}

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

幂等恢复：返回该 external_id 对应的交易，结果为 0 或 1 笔。标识在同一密钥及产品内唯一，区分大小写，并永久保留。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

{"maxLength":80}

processing、sent、failed 或 refunded，须通过流水核对余额，并兼容新增状态。

收款人实际收到的金额。

amount_cents 之外的总费用：fee_service_total_cents + fee_provider_cents。已包含合作伙伴佣金，不要重复加上。

已保存的 Lunium 服务费，以分计，为会计组成项。客户界面及通知应使用 fee_service_total_cents。

服务商费用：fee_cents 减去 fee_service_cents 及 fee_partner_cents。

{"enum":["cpf","cnpj","phone","email","random"]}

收款人证件经遮盖后的值，如有；请求中该字段为可选。

最多 64 个字符的幂等标识。重试保持相同标识及全部参数。差异比较规则因接口而异，不要利用重放修改原交易。409 external_id_divergente 表示检测到冲突。

{"maxLength":64}

failed/refunded 时的原因。

已发送 Pix 的 EndToEndId。

付款后取得的收款人姓名，如可用；未取得时为 null。

公开 Pix 核验，GET /v1/verificar/{e2e}。

模拟交易时为 true。

本次提现从余额扣除的合作伙伴 sub fee，以分计，已包含在 fee_cents 中。

{"nullable":true}

客户合并服务费，即交易保存的 Lunium 费用加合作伙伴佣金，保留原分位舍入及历史费率。旧记录中平台组成项未知时为 null。生产及测试环境的付款响应与 payout.* webhook data 均提供此字段。仅加一次 fee_provider_cents 即得 fee_cents，不再加 fee_partner_cents。

{"minimum":0}

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

本次响应中，已耗尽尝试次数的记录数。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

{"const":true}

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。

erro 的旧别名，计划于2026年11月9日停止返回。不要依赖此字段，使用规范字段 erro；它不会脱离 erro 单独出现。

稳定错误码，应据此编写分支，不根据 detail 文本判断。本列表来自 API 实际使用的错误码。

corrigir = 请求有误，原样重试无效；repetir = 暂时故障，可用相同请求重试；esperar = 等待配额恢复；parar = 不要重试，请联系团队；falar_com_suporte = 不循环重试，保留 request_id 及 external_id 并联系 Lunium，例如 config_provedor。

{"enum":["corrigir","repetir","esperar","parar","falar_com_suporte"]}

面向人工阅读的说明，不用于业务分支判断。

限额错误中可能提供，已换算为订单币种。

本次请求标识，同时出现在 X-Request-ID 响应头中，联系支持时请提供。若请求头 X-Request-ID 符合 [A-Za-z0-9._:-]{8,64}，将全程保留原值。