Skip to content

第一步 创建订单

请求地址:POST /js/create

请求参数

说明:

可以先查看认证方法 Basic Auth 认证

参数类型必填说明
orderIdString(128)必填商户订单 ID,可以多次请求重复但只能存在一笔成功交易
currencyString(3)必填币种 (举例:EUR/USD)
amountNumber(12,3)必填交易金额
appIdNumber(20)必填系统->网站APP->APP ID
callbackUrlString(255)必填3D/Checkout 回调 URL(一般用于处理面显示逻辑,比如跳转到原有的商品页面)
notificationUrlString(255)必填异步通知 URL,此参数不为空,交易完成会往此地址发送通知(常用于处理订单状态)
productInfosArray必填商品信息(ProductInfo详情)

请求实例

json
{
  "appId": "1998997704361046000",
  "amount": "12",
  "callbackUrl": "https://test.com",
  "currency": "USD",
  "notificationUrl": "https://test.com/webhook/test/notify",
  "orderId": "1777443202785",
  "productInfos": [
    {
      "productName": "Test Product",
      "currency": "USD",
      "quantity": 1,
      "price": "12.00"
    }
  ]
}

返回参数

订单返回参数

参数类型说明
codeNumber(3)返回码,详见附录
appIdNumber(20)系统->网站APP->APP ID
transactionCurrencyString(3)交易币种(比如CNY/USD)
transactionAmountString(12)交易金额
redirectUrlString(255)跳转的URL
transactionTypeString(32)Sale
messageString(255)系统返回信息
tokenString(1024)订单token(第二步创建支付时候需要使用)
timestampNumber返回时间戳
expiresNumber账单失效时间(单位:秒,默认1小时)

返回实例

json
{
  "appId": 1998997704361046000,
  "expires": 3599,
  "message": "Token created successfully",
  "orderId": "1777443202785",
  "code": 131,
  "timestamp": 1777443735797,
  "token": "eyJvcmRlcklkIjoiMTc3NzQ0MzczNTQ1MCIsImFwcElkIjoxOTk4OTk3NzA0MzYxMDQ2MDE4LCJtZXJjaGFudE5vIjoiNTU1NzUyIiwiYWxnIjoiSFMyNTYifQ.eyJzdWIiOiIxOTk4OTk3MjgyNzk5OTM5NTg2IiwiaWF0IjoxNzc3NDQzNzM1LCJleHAiOjE3Nzc0NDczMzV9.qB1C4XUOn83jct_boUL4jQKxXdbhL2YLM3mWUvAewo0",
  "transactionAmount": "12",
  "transactionCurrency": "USD",
  "transactionType": "Sale"
}