跳到主要内容

商户收款术语

接入时先区分业务订单、收款会话和实际付款。它们分别决定商品交付、付款交互和资金对账,不能互相替代。

术语含义与接入规则
业务订单你自己的购买、账单或服务操作;它是履约去重的边界。
Checkout(收款会话)一次收银台收款交互,具有自己的 ID、URL、金额和有效期。同一订单可关联多个 Checkout;order_id 不保证唯一,也不替代 Idempotency-Key。
收款方式付款采用的方式,如 ipp 或 erc20_transfer。收款方式响应按方式分组。
币种/网络组合某种收款方式实际支持的 {currency, chain},例如 USDC 与一个 EIP-155 网络编号。不可把分别出现的币种与网络自由组合,也不能从一种方式推断另一种方式支持相同组合。
付款项(attempt_id)一项已检测到付款的明细,记录累计 finalized 到账、已退款及当前可退金额。退款前从付款明细选择其 attempt_id。
Payment Intent(退款范围)Refund 的 payment_intent 表示原收款标识。同一 Payment Intent 最多一笔 requires_action 或 processing 的退款,限制覆盖其所有付款项;不要仅按 attempt_id 并发创建。使用响应返回的标识,不从其他资源 ID 推导。
履约发货、交付内容或开通服务,是商户自己的业务动作。Checkout 成功不等于已经履约;先核对订单关联、金额、币种和资金异常,再按订单只交付一次。
Webhook 事件资源发生变化的通知,带事件 ID 和关联资源标识;它不是当前完整资源快照。验签、持久化并去重后,查询资源取得当前状态。
Settlement(资金归集)将已 finalized 的 IPP 入款全额归集到原入款固定的钱包,由商户钱包执行。它不是银行出款,也不允许任意修改到账地址。

状态属于具体资源​

Checkout 的主状态只有 open、processing、succeeded、failed。processing 表示付款已上链但仍需达到确认要求,不应提示再次付款;succeeded 表示满足所选收款确认条件,履约前仍须检查 exception_status。业务订单的 fulfilled 由商户记录,不是 Checkout 状态。退款和归集使用各自的状态,不能套用 Checkout 状态表。

商户 API 与原生 IPP​

本节的 Checkout 是托管商户 API 的收款会话。原生 IPP 也使用 Checkout 一词,但通过 PaymentSession、确认选项和不可变 Request 组织协议交互;两者的端点、认证、金额表达和成功规则分别定义。使用哪个接入层,就遵循该层返回的对象与接口。参阅协议术语。

按第一笔收款完成创建、交付收银台链接、查询与履约,再按接口开放状态选择通知、退款及归集能力。