创建新的支付会话。服务端会按商户店铺配置解析来源系统,并生成收银台 URL。
Documentation Index
Fetch the complete documentation index at: https://docs.stablepayfi.ai/llms.txt
Use this file to discover all available pages before exploring further.
Bearer API Key,例如 Bearer sk_live_xxx。
Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。
防重放随机字符串,长度 16-64 个字符,建议每次请求使用新的 UUID。
使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256,结果为小写 hex。GET 请求的 requestBody 为空字符串。
Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。
防重放随机字符串,长度 16-64 个字符,建议每次请求使用新的 UUID。
16 - 64使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256,结果为小写 hex。GET 请求的 requestBody 为空字符串。
支付金额,使用货币最小单位。
x >= 1商户账本币种,例如 USD。
商户订单 ID,同一商户下必须唯一。
订单描述,会写入会话 metadata。
商品明细。若传入,amount 必须等于商品小计 + 税费 + 运费。
税费金额,使用货币最小单位。
x >= 0运费金额,使用货币最小单位。
x >= 0支付成功后的跳转地址。
用户取消支付后的跳转地址。
支付用户邮箱,选填但强烈建议传入;用于支付通知、客户识别和售后对账,并会写入 metadata.email。
商户自定义元数据键值对。非字符串值会在响应中转为字符串。
支付会话创建成功。
支付会话 ID。
订单总金额,使用货币最小单位。
商户账本币种,小写返回。
支付状态。confirming 会映射为 processing,completed 会映射为 paid。
pending, processing, paid, failed, expired, canceled 创建时间,Unix 秒。
过期时间,Unix 秒。
收银台 URL。
商品明细。
税费金额,使用货币最小单位。
运费金额,使用货币最小单位。
存在币种转换时返回的汇率值。
用户实际链上支付币种,例如 USDT。
目标支付金额,使用目标币种最小单位。
汇率锁定时间,Unix 秒。
关联订阅 ID,仅订阅场景返回。
关联发票 ID,仅发票/订阅场景返回。
商户自定义元数据。