跳转到主要内容
POST
创建交易单

授权

Authorization
string
header
必填

Bearer API Key 鉴权。格式:Authorization: Bearer {your_api_key}

请求头

Request-Id
string
默认值:008e3967-a1b5-48bb-be14-d5bff5092e61
必填

请求的唯一标识符

请求体

application/json
amount
string
必填

支付金额,金额必须大于0,只有使用 subscription 支付方式时可出现0。截取两位小数

currency
string
必填

金额对应的交易币种,编码遵照ISO4217

order_id
string
必填

接入方订单 ID

payment_mode
string
必填

支付业务模式:

  • onetime_payment:一次性支付,需要收集顾客支付信息,传入 payment_method_data 字段
  • subscription:首次订阅支付,需要收集顾客支付信息,传入 payment_method_data 字段,支付成功时会返回 payment_token 用于后续订阅续费
  • recurring_payment:订阅续订支付,需要传入 payment_token 完成支付,无需收集用户支付信息
txn_time
string
必填

交易发起时间,UTC格式,示例:2025-07-02T15:04:05Z

server_name
string
必填

客户端域名信息,固定值: checkout.subotiz.com

customer_id
string

Subotiz 顾客 id,关联 Subotiz 中已有顾客,与 customer_data 字段二选一,在需要关联已有顾客的场景选择使用该字段

customer_data
object

顾客数据,在 Subotiz 创建顾客对象,与 customer_id 字段二选一,在需要创建新顾客的场景选择使用该字段。

metadata
object

一组可附加到对象上的键值对,允许您以结构化格式存储附加信息。

payment_token
string

顾客支付 token,用于订阅续订,使用 recurring_payment 支付方式时必传。

return_url
string

在类似 3DS 跳转支付场景时,支付渠道受理成功后重定向的页面

payment_method_data
object

顾客支付信息,首次订阅支付,使用 subscription 支付方式时必传

summary
string

交易摘要信息,如果渠道接口支持,该字段会传递给渠道。当前仅支持自有支付的非0元支付

refer_info
object

客户的来源信息

响应

200 - application/json

OK

通过order_id查询交易单响应

code
string

error code

message
string

error message

data
object

通过order_id查询交易单响应