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

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

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

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

上线前检查清单

  1. 用示例凭证计算出的签名与文档一致。
  2. 所有字段值都以字符串发送,金额不是数字类型。
  3. 代收建单的 url 与 json 两种模式(如有使用)、fps 与 bank_transfer 两种通道都已测试。
  4. 付款页面显示的是 payable_amount,而不是原始金额。
  5. 代付建单的 FPS 三种账号格式(如有使用)与银行转账都已测试。
  6. Callback 接口:验签正确、签名不一致时会丢弃、重复通知能幂等处理、10 秒内返回 ok。
  7. Callback 以 order_no 匹配订单,能区分代收与代付。
  8. 有定期查单机制,能处理未收到 Callback 与 late_credited 的情况。
  9. 建单超时与 internal_error 会以商户单号查单确认,不会直接判定为失败。
  10. 程序以 code 判断结果,不依赖 message 文本。
  11. 生产环境的凭证、域名与 IP 白名单已另行申请,且密钥只存放在服务器端。
  12. 服务器时间已校准(建议开启 NTP 时间同步),每个请求的 timestamp 都是发送当下的时间。
  13. 每个建单请求都传入 callback_url;地址是合法的 http 或 https 地址(两者都接受),域名可从公网解析且只指向公网 IP,不会重定向(3xx),服务器返回 HTTP 2xx。
  14. 代收成功以 received_amount(或 settlement_amount)入账;与预期金额不同时转人工,不自动入账。
  15. 已是终态的订单不会因后到、状态不同的 Callback 被回退;有疑义以查单结果为准。
Prev
银行代码