收银台创建

API TEST CONSOLE

模拟请求

POST/trade/checkout/create

国家测试环境

Header Params

appId nonce timestamp authorization

Body Params application/json

Response

TEST ONLY

该国家测试域名暂未配置。

认证信息仅保留在当前页面内存中，不会写入本地存储。

创建托管收银台订单，返回可供付款人访问的支付链接。

POST/trade/checkout/create

请求参数

字段	类型	必填	最大长度	说明
`merchantOrderNo`	String	是	32	商户订单号
`transactionAmount`	String	是	20	收款金额，整数（保留 2 位小数）
`paymentType`	String	是	32	支付方式
`idType`	String	否	50	用户证件类型
`userIdCard`	String	否	32	用户证件号码
`userName`	String	否	64	用户姓名
`userPhone`	String	否	20	用户手机号
`userEmail`	String	否	50	用户邮箱
`expireTime`	String	否	-	订单过期时间（国家当地时间）
`paymentCallbackUrl`	String	否	200	代收回调地址

请求示例

{
  "merchantOrderNo": "CHECKOUT202609170001",
  "transactionAmount": "100.00",
  "paymentType": "PAYMENT_TYPE",
  "paymentCallbackUrl": "https://merchant.example/callback"
}

响应参数

字段	类型	必填	最大长度	说明
`code`	int	是	-	状态码，非 200 代表异常
`data`	Object	是	-	响应体
`data.merchantOrderNo`	String	是	32	商户订单号
`data.tradeNo`	String	是	32	平台单号
`data.transactionAmount`	String	是	20	收款金额
`data.status`	String	是	20	订单状态
`data.expireTime`	String	是	-	过期时间（国家当地时间）
`data.paymentLink`	String	是	24	支付链接
`data.failMsg`	String	否	200	订单失败原因
`msg`	String	否	-	异常信息
`tid`	String	是	-	traceId

响应示例

{
  "code": 200,
  "data": {
    "merchantOrderNo": "CHECKOUT202609170001",
    "tradeNo": "VP20260917000003",
    "transactionAmount": "100.00",
    "status": "PENDING",
    "expireTime": "2026-09-17 16:30:00",
    "paymentLink": "https://checkout.example/pay/VP20260917000003"
  },
  "msg": "success",
  "tid": "747bbf80261844ed85b809212aab0d81"
}