{
  "_sobre": "Lunium 公开事实与注明日期的历史快照。各部分保留来源，不包含密钥、个人资料或交易金额总量。历史数值不能用于承诺当前条件。",
  "gerado_em": "2026-09-17T18:37:10.285Z",
  "contrato": {
    "openapi_versao": "1.33.1",
    "openapi_spec": "3.1.0",
    "url_spec": "https://api.luniumpay.com/openapi.json",
    "origem_da_spec": "来自生产环境公开规范：GET https://api.luniumpay.com/openapi.json；当前中文规范见 https://docs.luniumpay.com/zh/openapi.json",
    "base_url": "https://api.luniumpay.com",
    "autenticacao": "使用 X-API-Key 请求头。通过 POST /keys/sandbox 一次请求获取沙盒密钥，测试人员本人 email 必填；接入手册、流程图及后续步骤发送至该邮箱。",
    "endpoints_publicos_total": 57,
    "endpoints": [
      {
        "metodo": "GET",
        "caminho": "/cash-outs",
        "resumo": "列出订单"
      },
      {
        "metodo": "POST",
        "caminho": "/cash-outs",
        "resumo": "创建报价（第 1 / 3 步）"
      },
      {
        "metodo": "POST",
        "caminho": "/cash-outs/preview",
        "resumo": "报价预览（不创建订单）"
      },
      {
        "metodo": "GET",
        "caminho": "/cash-outs/{cashout_id}",
        "resumo": "跟踪订单（第 3 / 3 步）"
      },
      {
        "metodo": "POST",
        "caminho": "/cash-outs/{cashout_id}/accept",
        "resumo": "接受报价并取得地址（第 2 / 3 步）"
      },
      {
        "metodo": "GET",
        "caminho": "/cashin/catalog",
        "resumo": "Cash-in 目录：Pix 收款后可交付的资产"
      },
      {
        "metodo": "POST",
        "caminho": "/cashin/charge",
        "resumo": "创建 Pix 收款单，用于 BRL 托管或加密资产交付"
      },
      {
        "metodo": "GET",
        "caminho": "/cashin/charges",
        "resumo": "列出 / 恢复当前密钥的 cash-in 收款单"
      },
      {
        "metodo": "GET",
        "caminho": "/cashin/events",
        "resumo": "当前密钥的运行事件流"
      },
      {
        "metodo": "GET",
        "caminho": "/cashin/limits",
        "resumo": "查询该付款人当前可支付金额"
      },
      {
        "metodo": "POST",
        "caminho": "/cashin/preview",
        "resumo": "Cash-in 预估，不创建交易"
      },
      {
        "metodo": "GET",
        "caminho": "/cashin/{cashin_id}/status",
        "resumo": "Pix 收款单状态"
      },
      {
        "metodo": "GET",
        "caminho": "/catalog",
        "resumo": "当前可结算的资产、网络及限额"
      },
      {
        "metodo": "GET",
        "caminho": "/catalog/dex",
        "resumo": "可通过 DEX 交易的长尾代币"
      },
      {
        "metodo": "GET",
        "caminho": "/comissao",
        "resumo": "Sub fee 余额，即合作伙伴佣金"
      },
      {
        "metodo": "GET",
        "caminho": "/comissao/extrato",
        "resumo": "佣金流水"
      },
      {
        "metodo": "POST",
        "caminho": "/comissao/sacar",
        "resumo": "以加密资产形式提取佣金"
      },
      {
        "metodo": "POST",
        "caminho": "/keys",
        "resumo": "自助创建密钥"
      },
      {
        "metodo": "GET",
        "caminho": "/keys/me",
        "resumo": "当前限额及当日使用量"
      },
      {
        "metodo": "PATCH",
        "caminho": "/keys/me",
        "resumo": "更新密钥配置：名称、结算、webhook 及凭证轮换"
      },
      {
        "metodo": "POST",
        "caminho": "/keys/painel-link",
        "resumo": "通过邮件获取监控链接，无需 API 密钥"
      },
      {
        "metodo": "POST",
        "caminho": "/keys/sandbox",
        "resumo": "一次调用获取测试密钥，无需已有 API 密钥"
      },
      {
        "metodo": "POST",
        "caminho": "/leads",
        "resumo": "将商务或技术问题转交人工"
      },
      {
        "metodo": "GET",
        "caminho": "/mesh",
        "resumo": "智能体接入前须知"
      },
      {
        "metodo": "GET",
        "caminho": "/mesh/agents",
        "resumo": "发现网络成员"
      },
      {
        "metodo": "POST",
        "caminho": "/mesh/agents",
        "resumo": "注册智能体并获取测试环境凭证"
      },
      {
        "metodo": "GET",
        "caminho": "/mesh/agents/{agent_id}",
        "resumo": "智能体状态、mandate 授权、指标及推荐关系"
      },
      {
        "metodo": "POST",
        "caminho": "/mesh/agents/{agent_id}/mandate",
        "resumo": "设置自身限额策略"
      },
      {
        "metodo": "GET",
        "caminho": "/mesh/agents/{agent_id}/network",
        "resumo": "推荐关系、层级树及网络交易量"
      },
      {
        "metodo": "POST",
        "caminho": "/mesh/agents/{agent_id}/production-request",
        "resumo": "自动激活生产环境，无需人工审批"
      },
      {
        "metodo": "GET",
        "caminho": "/mesh/agents/{agent_id}/rewards",
        "resumo": "奖励余额及账本流水"
      },
      {
        "metodo": "POST",
        "caminho": "/mesh/agents/{agent_id}/settlement",
        "resumo": "设置资金目的地"
      },
      {
        "metodo": "POST",
        "caminho": "/mesh/agents/{agent_id}/validate",
        "resumo": "提交测试环境使用证明"
      },
      {
        "metodo": "GET",
        "caminho": "/mesh/economy",
        "resumo": "网络经济的公开规则"
      },
      {
        "metodo": "GET",
        "caminho": "/mesh/graph",
        "resumo": "Mesh 智能体关系图"
      },
      {
        "metodo": "POST",
        "caminho": "/mesh/referrals",
        "resumo": "签发推荐证明（attestation）"
      },
      {
        "metodo": "GET",
        "caminho": "/payouts",
        "resumo": "列出当前密钥的 Pix 对外付款"
      },
      {
        "metodo": "POST",
        "caminho": "/payouts",
        "resumo": "直接支付 Pix，不经过加密资产环节"
      },
      {
        "metodo": "GET",
        "caminho": "/payouts/{payout_id}",
        "resumo": "Pix 对外付款状态"
      },
      {
        "metodo": "GET",
        "caminho": "/ping",
        "resumo": "API 健康状态"
      },
      {
        "metodo": "GET",
        "caminho": "/pix/keys/lookup",
        "resumo": "在核验服务可用时查询 Pix 收款人"
      },
      {
        "metodo": "GET",
        "caminho": "/saldo",
        "resumo": "BRL 托管余额：可用、冻结及后续资金释放"
      },
      {
        "metodo": "GET",
        "caminho": "/saldo/clientes",
        "resumo": "分页列出有余额的客户子账户"
      },
      {
        "metodo": "GET",
        "caminho": "/saldo/consolidado",
        "resumo": "密钥汇总：主账户 + 客户子账户，总托管金额"
      },
      {
        "metodo": "GET",
        "caminho": "/saldo/extrato",
        "resumo": "余额流水：会计记录或按交易分组"
      },
      {
        "metodo": "POST",
        "caminho": "/saldo/sacar-cripto",
        "resumo": "将 BRL 余额兑换并提取至自托管加密资产钱包"
      },
      {
        "metodo": "POST",
        "caminho": "/saldo/transferir",
        "resumo": "子账户与主账户之间内部转账，不生成 Pix"
      },
      {
        "metodo": "GET",
        "caminho": "/sandbox",
        "resumo": "查询测试环境功能"
      },
      {
        "metodo": "POST",
        "caminho": "/sandbox/cashin/{cashin_id}/pay",
        "resumo": "模拟测试 Pix 收款单的付款"
      },
      {
        "metodo": "GET",
        "caminho": "/sandbox/events",
        "resumo": "查看测试环境生成的事件"
      },
      {
        "metodo": "POST",
        "caminho": "/sandbox/operations/{operation_id}/resolve",
        "resumo": "核实测试环境中结果不确定的交易"
      },
      {
        "metodo": "GET",
        "caminho": "/sandbox/qr/{cashin_id}.svg",
        "resumo": "不可用于真实付款的测试二维码图片"
      },
      {
        "metodo": "POST",
        "caminho": "/sandbox/reset",
        "resumo": "重置当前密钥的模拟数据"
      },
      {
        "metodo": "GET",
        "caminho": "/v1/verificar/{e2e}",
        "resumo": "公开核验 Pix 付款，无需密钥"
      },
      {
        "metodo": "GET",
        "caminho": "/webhooks/deliveries",
        "resumo": "查询当前密钥的 webhook 投递历史"
      },
      {
        "metodo": "POST",
        "caminho": "/webhooks/deliveries/{event_id}/retry",
        "resumo": "重发事件"
      },
      {
        "metodo": "POST",
        "caminho": "/webhooks/test",
        "resumo": "立即发送测试事件"
      }
    ],
    "origem": "GET https://api.luniumpay.com/openapi.json",
    "verificado_em": "2026-09-22T00:27:02.350157+00:00",
    "openapi_sha256": "f021af28e516ef7c0e94547ba2cfa83834af5d1501cfa40a0b2995c989a6dc05"
  },
  "produtos": [
    {
      "id": "cash_in",
      "nome": "买入／入金",
      "descricao": "客户支付 Pix，随后交付稳定币或记入 BRL 托管余额；完成条件按具体流程判断。",
      "endpoints": [
        "POST /cashin/preview",
        "POST /cashin/charge",
        "GET /cashin/{cashin_id}/status",
        "GET /cashin/charges",
        "GET /cashin/catalog",
        "GET /cashin/limits"
      ]
    },
    {
      "id": "cash_out",
      "nome": "卖出／出金",
      "descricao": "客户转入加密资产，向 Pix 收款键或兼容的复制粘贴码收款单支付巴西雷亚尔。",
      "endpoints": [
        "POST /cash-outs/preview",
        "POST /cash-outs",
        "POST /cash-outs/{cashout_id}/accept",
        "GET /cash-outs/{cashout_id}",
        "GET /catalog"
      ]
    },
    {
      "id": "saldo",
      "nome": "巴西雷亚尔托管余额",
      "descricao": "按 customer_ref 子账户记录 BRL，通过 Pix 入金，并通过 Pix 或加密资产提现。",
      "endpoints": [
        "GET /saldo",
        "GET /saldo/extrato",
        "GET /saldo/clientes",
        "GET /saldo/consolidado",
        "POST /saldo/transferir",
        "POST /saldo/sacar-cripto"
      ]
    },
    {
      "id": "payouts",
      "nome": "Pix 付款",
      "descricao": "直接从 BRL 余额扣款支付 Pix，不经过加密资产兑换。",
      "endpoints": [
        "POST /payouts",
        "GET /payouts",
        "GET /payouts/{payout_id}"
      ]
    },
    {
      "id": "verificacao",
      "nome": "公开付款核验",
      "descricao": "无需密钥，可通过 EndToEndId 核验 Pix 付款。",
      "endpoints": [
        "GET /v1/verificar/{e2e}"
      ],
      "sem_chave": true
    }
  ],
  "ativos": {
    "instantaneo": {
      "descricao": "历史快照描述：Polygon USDT/USDC 买入通过合作交易所交付；当时目录预计不超过两分钟，instant 自 2026-09-16 起为空。卖出 fast 通道当时可在数秒内检测入金，Pix 约一至两分钟完成。这些历史描述不代表当前通道、可用性或时长承诺；操作前查询现行目录。",
      "cash_in": [],
      "cash_out": [
        {
          "ativo": "USDT",
          "rede": "polygon"
        },
        {
          "ativo": "USDC",
          "rede": "polygon"
        }
      ]
    },
    "via_corretora": {
      "descricao": "通过交易所入金、兑换与结算，时长取决于网络确认。历史目录对 Polygon USDT/USDC 买入显示预计不超过两分钟；当前条件须重新查询。",
      "cash_out_ativos": 1443,
      "cash_out_redes": 238,
      "cash_in_rotas": 1761,
      "cash_in_redes": 279,
      "cash_in_moedas": 1551
    },
    "dex": {
      "descricao": "通过 DEX 交易的长尾代币，报价时提交 token_address。",
      "redes": [
        "polygon"
      ]
    },
    "memo_obrigatorio": {
      "descricao": "共享地址网络要求随入金提交 memo/tag：接受报价响应为 deposit_tag，买入交付字段为 payout_tag。",
      "redes": [
        "algo",
        "atom",
        "eos",
        "hbar",
        "kava",
        "luna",
        "ton",
        "xlm",
        "xrp"
      ]
    },
    "catalogos_ao_vivo": {
      "cash_out": "https://api.luniumpay.com/catalog",
      "cash_in": "https://api.luniumpay.com/cashin/catalog"
    },
    "atualizado_em": "2026-09-17T18:37:10.285Z",
    "origem": "GET https://api.luniumpay.com/catalog 及 GET https://api.luniumpay.com/cashin/catalog"
  },
  "limites": {
    "por_operacao": {
      "cashin": {
        "min_brl_cents": 100,
        "max_brl_cents": 600000
      },
      "payout": {
        "min_brl_cents": 100,
        "max_brl_cents": 600000
      },
      "cashout": {
        "min_brl_cents": 600,
        "max_brl_cents": 25000000
      }
    },
    "por_pagador": {
      "applies_to": [
        "Cash-in（法币兑换加密资产）"
      ],
      "first_transaction_cents": 10000,
      "first_window_cents": 20000,
      "first_window_hours": 24,
      "mature_daily_cents": 600000,
      "nota": "按付款人的 CPF/CNPJ 计算。通过 GET /cashin/limits?payer_tax= 查询该付款人当前可用额度。"
    },
    "por_recebedor": {
      "applies_to": [
        "Cash-out（加密资产兑换法币）"
      ],
      "daily_cents": 10000000,
      "scope": "cpf_cnpj",
      "nota": "按 Pix 收款人的 CPF/CNPJ 汇总日金额，巴西利亚时间午夜重置。本字段为历史说明；当前收款键类型、证件要求与实际限额以密钥及现行接口响应为准。"
    },
    "validade_do_qr_minutos": 15,
    "nota": "自 2026-09-10 起，旧版 Início/Crescimento/Escala 分级不再适用。使用单笔限额、买入付款人分级、卖出收款人上限及密钥的 mandate。买入实际最低金额取决于费率和通道；查询 GET /keys/me 及 POST /cashin/preview 的 min_brl_cents。",
    "origem": "GET https://api.luniumpay.com/keys/me → limits",
    "teto_diario_por_chave": null
  },
  "retencao": {
    "escada_do_pagador": {
      "aplica_a": "买入流程（Pix → 加密资产或余额），按实际付款人的 CPF/CNPJ 分级",
      "estreia_cents": 10000,
      "primeiras_24h_cents": 20000,
      "maduro_dia_cents": 600000,
      "consulta": "GET /cashin/limits?payer_tax=",
      "origem": "GET /keys/me → limits.payer_limits"
    },
    "retido_no_provedor": {
      "descricao": "历史策略描述：超过即时额度后，服务商仍可接受二维码付款，并暂缓资金 24 小时后释放；当时首笔即可达到每日 R$6,000。合作伙伴可通过 allow_hold:false 禁用此方式，返回 403 及即时可用额度。实际策略以当前响应为准。",
      "horas": 24,
      "teto_dia_cents": 600000,
      "campos_na_resposta": [
        "held",
        "delay_until"
      ],
      "origem": "服务配置：PAYER_DELAY_HOURS / PAYER_DELAY_MAX_CENTS"
    },
    "carencia_do_saldo": {
      "descricao": "历史说明：自 2026-09-16 起，标准托管入账在 Pix 结算后即可用，carencia_horas 为 0、carencia_ate 为 null；另有约定时可能存在本地等待期。超过 retencao_acima_cents 的首次 Pix 可能冻结至服务商释放，并产生 saldo.liberado。请始终核对当前项目条件。",
      "horas_padrao": 0,
      "campos_na_resposta": [
        "carencia_horas",
        "liberar_em",
        "carencia_ate"
      ],
      "origem": "GET /saldo 的 carencia_horas 及密钥的 saldo_hold_hours"
    },
    "invariante": "资金暂缓期限届满前不得交付；结算及 SQL 领取任务时重复校验，校验失败时不执行。"
  },
  "estados": {
    "cash_in": [
      "pending",
      "delayed",
      "under_review",
      "paid",
      "expired",
      "refunded",
      "failed"
    ],
    "cash_out": [
      "QUOTE_CREATED",
      "AWAITING_DEPOSIT",
      "DEPOSIT_DETECTED",
      "PAYING_OUT",
      "COMPLETED",
      "MANUAL_REVIEW",
      "REFUNDING_CRYPTO",
      "REFUNDED",
      "EXPIRED",
      "FAILED"
    ],
    "payout": [
      "requested",
      "processing",
      "sent",
      "failed",
      "refunded"
    ],
    "origem": "OpenAPI：CashOut.state、Cobranca.status/settlement_status、Payout；以及服务器标记时间的 GET /cash-outs/{id}.timeline",
    "cash_in_settlement_status": [
      "pending",
      "sending",
      "sent",
      "incerto",
      "failed"
    ],
    "cash_out_timeline_etapas": [
      "AWAITING_DEPOSIT",
      "DEPOSIT_DETECTED",
      "DEPOSIT_CONFIRMED",
      "SELLING",
      "SOLD",
      "FORWARDING",
      "PAYING_OUT",
      "COMPLETED"
    ]
  },
  "seguranca": [
    {
      "id": "webhook_assinado",
      "descricao": "Webhook 使用 HMAC SHA-256，X-Lunium-Signature 含时间戳。接收端须基于原始字节验证签名、核对时间窗口并按 event_id 去重；仅验证签名不能防止重放。"
    },
    {
      "id": "幂等性",
      "descricao": "持久化 external_id，重试时保留相同请求体。超时后查询原操作。各接口的冲突校验及校验顺序可能不同；不得新建 ID 绕过不确定结果或 429。"
    },
    {
      "id": "egress_validado",
      "descricao": "每次投递前解析并校验 Webhook URL，拒绝内部地址、云元数据地址及指向私网的重定向，将连接固定至已校验 IP。"
    },
    {
      "id": "retencao_fail_closed",
      "descricao": "在结算及 SQL 领取任务时检查暂缓可用条件，worker、状态查询与队列均不得提前结算。"
    },
    {
      "id": "payout_duravel",
      "descricao": "提现在调用服务商之前，于同一事务内记录操作并扣款，保证扣款有对应订单可供对账。"
    },
    {
      "id": "verificacao_aberta",
      "descricao": "GET /v1/verificar/{e2e} 无需密钥，可独立核验由平台结算的 Pix。"
    }
  ],
  "medicoes": [
    {
      "chave": "cashout_polygon_aceite_ate_pix_p50_s",
      "descricao": "历史测量：Polygon 卖出交易从接受报价至 Pix 已付款的中位时间。",
      "valor": 83,
      "unidade": "秒",
      "amostra": 66,
      "janela_dias": 90,
      "medido_em": "2026-09-17T09:00:00Z",
      "origem": "cashout_eventos（服务器记录各状态变更时间）"
    },
    {
      "chave": "cashout_polygon_aceite_ate_pix_p90_s",
      "descricao": "历史测量：Polygon 卖出交易从接受报价至 Pix 已付款的 p90 时间。",
      "valor": 194,
      "unidade": "秒",
      "amostra": 66,
      "janela_dias": 90,
      "medido_em": "2026-09-17T15:09:36.264Z",
      "origem": "cashout_eventos"
    },
    {
      "chave": "cashin_polygon_prazo_entrega",
      "descricao": "历史目录预计：Polygon USDT/USDC 买入不超过两分钟；自 2026-09-16 起通过交易所交付，未发布独立实测。",
      "valor": "预计不超过两分钟",
      "unidade": "prazo",
      "medido_em": "2026-09-17T09:00:00Z",
      "origem": "GET /cashin/catalog → convert[].eta"
    },
    {
      "chave": "cashin_operacoes_entregues",
      "descricao": "历史窗口内已交付的买入交易（Pix → 加密资产）。",
      "valor": 209,
      "unidade": "笔操作",
      "amostra": 209,
      "janela_dias": 90,
      "medido_em": "2026-09-17T15:09:36.264Z",
      "origem": "cashin_charges"
    },
    {
      "chave": "cashout_operacoes_completas",
      "descricao": "历史窗口内已完成的卖出交易（加密资产 → Pix）。",
      "valor": 66,
      "unidade": "笔操作",
      "amostra": 66,
      "janela_dias": 90,
      "medido_em": "2026-09-17T15:09:36.264Z",
      "origem": "cashout_orders"
    },
    {
      "chave": "payouts_enviados_com_comprovante",
      "descricao": "已发送且具有 EndToEndId 的 Pix 提现比例；样本分母为全部已发送交易。",
      "valor": 32,
      "unidade": "笔操作",
      "amostra": 32,
      "janela_dias": 90,
      "medido_em": "2026-09-17T15:09:36.264Z",
      "origem": "payout_orders"
    },
    {
      "chave": "webhooks_entregues_30d",
      "descricao": "历史 30 天窗口内以 2xx 确认投递的 Webhook；样本为全部投递尝试。",
      "valor": 519,
      "unidade": "entregas",
      "amostra": 662,
      "janela_dias": 90,
      "medido_em": "2026-09-17T15:09:36.264Z",
      "origem": "cashin_webhook_deliveries"
    }
  ],
  "links": {
    "documentacao": "https://docs.luniumpay.com",
    "documentacao_en": "https://docs.luniumpay.com/zh/en/",
    "openapi": "https://api.luniumpay.com/openapi.json",
    "llms_txt": "https://docs.luniumpay.com/zh/llms.txt",
    "status": "https://docs.luniumpay.com/zh/status",
    "status_json": "https://docs.luniumpay.com/zh/status.json",
    "manual_pdf": "https://docs.luniumpay.com/zh/manual.pdf",
    "sandbox": "POST https://api.luniumpay.com/keys/sandbox，提交 {\"email\":\"voce@empresa.com\"}（必填）",
    "contato": "contato@luniumpay.com"
  },
  "documentacao": {
    "revisao": "2026-09-19.3",
    "manual": "https://docs.luniumpay.com/zh/manual",
    "contrato": "https://docs.luniumpay.com/zh/manual-contract.json",
    "nota": "接口审查与历史快照并列保留。gerado_em、测量及其他快照维持原始日期。目录、费用、限额与可用性必须在运行时重新查询。现行中文接口见 https://docs.luniumpay.com/zh/openapi.json 。"
  },
  "snapshot_warning": "本文件含注明日期的历史快照，仅供核实来源，不是当前条件、SLA 或通道可用性承诺。历史策略与现行规则冲突时，以 https://docs.luniumpay.com/zh/manual-contract.json 及当前密钥接口响应为准。"
}