ST Pay 商户 APIST Pay 商户 API
指南
API
错误码
商户后台
AI 协助对接
  • 繁體中文
  • 简体中文
  • English
指南
API
错误码
商户后台
AI 协助对接
  • 繁體中文
  • 简体中文
  • English
  • 开始

    • 概览
    • 请求与响应格式
    • 身份验证与 IP 白名单
    • 签名
    • 商户后台
    • AI 辅助对接
  • API

    • 代收建单
    • 代付建单
    • 查单
    • Callback 通知
  • 参考

    • 订单状态与金额
    • 重复请求与结果确认
    • 错误码
    • 银行代码
    • 上线前检查清单

订单状态与金额

“后台显示”是商户后台显示的状态文字。

代收单

pending ──┬── 确认入账 ───────────────→ success        (发送 Callback)
          ├── ST Pay 人工拒绝 ─────────→ rejected       (发送 Callback,终态)
          └── 30 分钟到期,系统拒绝 ──→ rejected       (发送 Callback)
                                          │
                                          └── 之后确认收到款项 ──→ late_credited (不发送 Callback)
status后台显示含义是否为最终结果
pending待审批等待付款人转账与 ST Pay 确认否
success成功入账成功,结算金额已计入您的余额是
rejected已拒绝不入账、不收手续费人工拒绝是最终结果;系统超时拒绝之后仍可能变为 late_credited
late_credited超时入账订单已被系统超时拒绝,但之后确认付款人确实已付款,结算金额已计入您的余额是

超时入账不发送 Callback

您会先收到一次 rejected 的 Callback,之后同一笔订单若转为 late_credited,不会再收到通知,但余额已经增加。

建议:付款人反馈已付款但订单显示已拒绝时,请通过查单确认;并定期通过查单或商户后台的余额流水(变动类型“超时入账”)对账,核对 reject_reason 为“訂單已逾時”(系统返回的繁体中文原文)的订单是否已转为 late_credited。

代付单

pending ──┬── ST Pay 出款 ──→ paid       (扣款并发送 Callback)
          └── ST Pay 拒绝 ──→ rejected   (不扣款并发送 Callback)
status后台显示含义是否为最终结果
pending待审批等待 ST Pay 出款否
paid已代付已出款,已从余额扣除代付金额与手续费是
rejected已拒绝不扣款、不收手续费是

代付单没有自动超时机制,会保持 pending 直到 ST Pay 处理。

金额与手续费

项目计算方式
代收订单金额 payable_amount原始金额 + 识别尾数(0.01–0.99)
代收手续费 fee实收金额 × 代收费率,保留 2 位小数,第 3 位起直接舍去(不四舍五入)
代收结算金额 settlement_amount实收金额 − 手续费
代付手续费 fee代付金额 × 代付费率,保留 2 位小数,第 3 位起直接舍去(不四舍五入)
代付实扣总额 total_deducted代付金额 + 手续费
  • 费率在建单时锁定,之后的费率调整只影响新创建的订单。
  • 实收金额 received_amount 是 ST Pay 实际确认入账的金额,手续费与结算金额均以此计算。若付款人转账金额与订单金额不同,实收金额可能与 payable_amount 不一致。
  • 被拒绝的订单手续费为 0.00。
  • 每笔订单的原始金额或代付金额须在 ST Pay 设定的单笔上下限范围内(含上下限本身)。上下限按“代收或代付”与“通道类型”分别设定,请向 ST Pay 确认当前的数值。

示例:代收费率 2.5%,实收 1000.37,手续费为 1000.37 × 2.5% = 25.00925,舍去后为 25.00,结算金额为 975.37。

Next
重复请求与结果确认