{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Mock 契约","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"mock-契约","__idx":0},"children":["Mock 契约"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["本页面和法币付款 OpenAPI Reference 均为设计预览。接口名称、字段、状态、权限和错误码尚未最终确定。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["法币付款 API 支持组织从 Infini USD 余额向第三方银行账户支付 USD。第一期固定通过 SGB 执行，调用方无需选择服务商；响应会返回只读的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provider=sgb"]},"，用于对账和后续扩展。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["所有接口使用以下前缀："]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/payouts"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"最小接口集合","__idx":1},"children":["最小接口集合"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"方法"},"children":["方法"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"接口"},"children":["接口"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"用途"},"children":["用途"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/payouts/quotes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["校验银行资料并获取有时效性的付款报价"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/payouts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["创建并立即开始执行直接付款"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/payouts/{payout_id}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["查询当前付款状态"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["第一期不提供收款人资源。银行收款资料随 Quote 一次性提交，并不可变地绑定到 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quote_id"]},"；",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/payouts"]}," 不能替换或修改这份收款资料。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"选择需要固定的金额","__idx":2},"children":["选择需要固定的金额"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["创建 Quote 时，请选择需要准确固定的是收款金额，还是付款账户的总扣款金额。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fee_paid_by"]}," 会改变 Infini 对两侧金额的计算方式，并非仅用于展示。第一期支持以下两种方式。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"固定收款金额","__idx":3},"children":["固定收款金额"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["适用于收款人必须准确收到指定金额的场景，例如支付发票。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"amount\": \"1000.00\",\n  \"amount_mode\": \"receive\",\n  \"fee_paid_by\": \"PAYER\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["收款人准确收到 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1000.00 USD"]},"。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYER"]}," 表示手续费外扣，付款手续费会额外计入 Infini USD 余额的扣款金额。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["receiving_amount"]}," 为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1000.00"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sending_amount = receiving_amount + fee_amount"]},"。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"固定总扣款金额","__idx":4},"children":["固定总扣款金额"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["适用于付款总扣款不能超过固定预算的场景。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"amount\": \"1000.00\",\n  \"amount_mode\": \"send\",\n  \"fee_paid_by\": \"BENEFICIARY\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Infini 准确扣除 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1000.00 USD"]},"。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BENEFICIARY"]}," 表示手续费内扣，付款手续费从该金额中扣除，因此收款人的到账金额会更少。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sending_amount"]}," 为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1000.00"]},"。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["receiving_amount = sending_amount - fee_amount"]},"。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["请仅使用以上字段组合。第一期不支持其他 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount_mode"]}," 与 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fee_paid_by"]}," 组合。修改 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fee_paid_by"]}," 后必须重新请求 Quote；",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quote_id"]}," 会固定 Payout 使用的手续费承担方和计算结果。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"查看-quote-金额","__idx":5},"children":["查看 Quote 金额"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sending_amount"]},"：Infini USD 余额的实际总扣款金额。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["receiving_amount"]},"：发送到收款银行账户的金额。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fee_amount"]},"：Quote 计算出的手续费总额；",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bank_fee_amount"]}," 是其中包含的银行或通道费。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fee_rate_decimal"]},"：Quote 使用的手续费率；",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rate"]}," 是汇率。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["对账时，请使用 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sending_amount"]}," 作为该笔付款的支出金额。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"直接执行","__idx":6},"children":["直接执行"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API 付款不会进入后台人工审批流。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/payouts"]}," 会执行具有最终效力的付款前校验，并立即开始执行。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["银行付款是异步过程。创建成功并返回 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status=processing"]},"，表示请求已经通过 Infini 校验且付款执行已经开始，不代表收款人的银行账户已经到账。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]}," 表示 SGB 在当前已知状态下报告付款完成。对端银行仍可能拒收并退回一笔已经完成的汇款，此时付款状态会变为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returned"]},"。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quote-与执行前校验","__idx":7},"children":["Quote 与执行前校验"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/payouts/quotes"]}," 会校验收款资料，并执行初步的路由、金额、合规和限额检查。它返回一份包含收款资料、金额、汇率、费用和手续费承担方的有时效快照。一份 Quote："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["不会冻结组织余额；"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["不会批准或创建付款；"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["过期后不能继续使用；"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["不保证当前限额、合规状态、余额或服务商可用性保持不变。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v2/payouts"]}," 会在创建主付款单、扣减余额并开始 SGB 执行前，重新执行所有关键校验。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"幂等","__idx":8},"children":["幂等"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_reference_id"]}," 在商户范围内唯一标识一笔逻辑付款："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["使用相同引用和完全相同的业务请求重试时，返回已有资源；"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["付款幂等重试时，响应中的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_duplicate=true"]},"；"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["使用相同引用提交不同业务数据时，返回 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409 idempotency_conflict"]},"。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quote_id"]}," 和其他决定付款内容的字段都会参与幂等一致性比较。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"银行敏感信息","__idx":9},"children":["银行敏感信息"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quote 请求包含银行账户敏感信息，响应只返回脱敏账号。客户端不得将完整银行账号写入 URL、日志、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_reference_id"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["statement_reference"]}," 或其他自由文本元数据。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"状态与对账","__idx":10},"children":["状态与对账"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"付款状态"},"children":["付款状态"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"含义"},"children":["含义"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["已开始执行，等待最终结算"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SGB 在当前已知状态下报告付款完成"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["付款在银行成功完成前失败"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returned"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["对端银行退回一笔已经提交或完成的汇款"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API 付款不会出现待审批状态。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/payouts/{payout_id}"]}," 是对外权威对账接口。第一期 Fiat Payout API 不提供 Webhook 文档。"]}]},"headings":[{"value":"Mock 契约","id":"mock-契约","depth":2},{"value":"最小接口集合","id":"最小接口集合","depth":2},{"value":"选择需要固定的金额","id":"选择需要固定的金额","depth":2},{"value":"固定收款金额","id":"固定收款金额","depth":3},{"value":"固定总扣款金额","id":"固定总扣款金额","depth":3},{"value":"查看 Quote 金额","id":"查看-quote-金额","depth":3},{"value":"直接执行","id":"直接执行","depth":2},{"value":"Quote 与执行前校验","id":"quote-与执行前校验","depth":2},{"value":"幂等","id":"幂等","depth":2},{"value":"银行敏感信息","id":"银行敏感信息","depth":2},{"value":"状态与对账","id":"状态与对账","depth":2}],"frontmatter":{"title":"法币付款 API 文档","seo":{"title":"Mock 契约"}},"lastModified":"2026-07-30T10:43:50.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh/docs/en/payout-api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}