创建交易单

post

https://{api}.subotiz.com/api/v1/trades

创建交易单

Body Params

amount

string

required

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

currency

string

required

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

customer_id

string

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

customer_data

object

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

metadata

object

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

order_id

string

required

接入方订单 ID

payment_mode

string

required

支付业务模式：

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

payment_token

string

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

return_url

string

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

txn_time

string

required

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

server_name

string

required

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

payment_method_data

object

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

summary

string

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

refer_info

object

客户的来源信息

Headers

Request-Id

string

required

Defaults to 008e3967-a1b5-48bb-be14-d5bff5092e61

请求的唯一标识符

Response

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK