{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"5. 业务核心概念","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":"5-业务核心概念","__idx":0},"children":["5. 业务核心概念"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["为了帮助商户理解订单与支付在交易过程中的行为，以下介绍订单有效期、支付有效期、订单状态以及异常标签的设计逻辑。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"51-订单有效期order-expiration","__idx":1},"children":["5.1 订单有效期（Order Expiration）"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["订单有效期由商户在后台设置，或在创建订单时通过 API 的 expires_in 字段定义。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["它的含义是："]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["用户必须在订单有效期内完成支付，否则订单将被视为过期或者部分付款。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"对商户的意义","__idx":2},"children":["对商户的意义"]},{"$$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":"Heading","attributes":{"level":4,"id":"对-infini-的意义","__idx":3},"children":["对 Infini 的意义"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["仅作为订单状态变化的判断依据 (pending → expired) ，订单终态后状态将不再变化（终态包括：expired、paid、partial_paid）。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["用户在订单过期后的付款仍会被异常标签识别为“晚到支付”（late payment），并更新confirming_amount和confirmed_amount。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["👉 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["订单有效期仅作用于订单（Order）。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"52-支付有效期payment-expiration","__idx":4},"children":["5.2 支付有效期（Payment Expiration）"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["支付有效期指 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["每个支付单（Payment）所生成的支付地址/二维码的有效使用时限"]},"。"," ","默认有效期为 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["1 小时"]},"。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["它的含义是："]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["用户需要在支付有效期内完成付款。支付单过期后，用户可重新生成新的支付单并获得新的报价和支付地址。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"场景示例","__idx":5},"children":["场景示例"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["用户停留超时 → 支付地址过期 → 生成新的支付单"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["链上价格波动 → 用户需要新的报价 → 生成新的支付单"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["👉 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["支付有效期仅作用于支付单（Payment）。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"53-订单状态说明","__idx":6},"children":["5.3 订单状态说明"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["订单状态由：是否过期、amount_confirming、amount_confirmed 三个关键字段决定。"]},{"$$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":"状态（Status）"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["状态（Status）"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"是否过期"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["是否过期"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"amount_confirming"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["amount_confirming"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"amount_confirmed"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["amount_confirmed"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"业务含义"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["业务含义"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["pending"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["= 0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["= 0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["初始状态，等待用户付款。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["> 0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["= 0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["用户已付款，但链上交易仍在确认中。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["processing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["> 0 且 < order_amount"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["已确认部分金额，但不足订单金额。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["paid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["≥ order_amount"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["全额付款成功。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["expired"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["是"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["= 0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["= 0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["超时未付款，订单关闭。"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["partial_paid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["是"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["> 0 且 < order_amount"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["过期，但用户已支付部分金额。商户可选择部分发货、联系用户补款或退款等处理方式。"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"54-异常标签exception-tags","__idx":7},"children":["5.4 异常标签（Exception Tags）"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["链上支付可能出现多种异常情况，因此 Infini 提供 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["异常标签 exception_tags"]}," 用于帮助商户进行客服处理、财务对账及风控判断。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["⚠️ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["异常标签不影响订单状态，可同时存在多个。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"异常标签说明","__idx":8},"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":"strong","attributes":{},"children":["标签名称"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["说明"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["late"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["用户在订单过期后才付款。区别于 expired（未付款即过期）。"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"55-异常标签用途","__idx":9},"children":["5.5 异常标签用途"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["客服跟进（补款、退款、币种纠正等）"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["风控处理（block 风险资产）"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["财务对账"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["配合订单"]}]}]},"headings":[{"value":"5. 业务核心概念","id":"5-业务核心概念","depth":2},{"value":"5.1 订单有效期（Order Expiration）","id":"51-订单有效期order-expiration","depth":3},{"value":"对商户的意义","id":"对商户的意义","depth":4},{"value":"对 Infini 的意义","id":"对-infini-的意义","depth":4},{"value":"5.2 支付有效期（Payment Expiration）","id":"52-支付有效期payment-expiration","depth":3},{"value":"场景示例","id":"场景示例","depth":4},{"value":"5.3 订单状态说明","id":"53-订单状态说明","depth":3},{"value":"5.4 异常标签（Exception Tags）","id":"54-异常标签exception-tags","depth":3},{"value":"异常标签说明","id":"异常标签说明","depth":4},{"value":"5.5 异常标签用途","id":"55-异常标签用途","depth":3}],"frontmatter":{"seo":{"title":"5. 业务核心概念"}},"lastModified":"2026-06-12T06:47:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh/docs/en/5-core-concept","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}