第一步 创建订单
请求地址:POST
/js/create
请求参数
说明:可以先查看认证方法 Basic Auth 认证
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
orderId | String(128) | 必填 | 商户订单 ID,可以多次请求重复但只能存在一笔成功交易 |
currency | String(3) | 必填 | 币种 (举例:EUR/USD) |
amount | Number(12,3) | 必填 | 交易金额 |
appId | Number(20) | 必填 | 系统->网站APP->APP ID |
callbackUrl | String(255) | 必填 | 3D/Checkout 回调 URL(一般用于处理面显示逻辑,比如跳转到原有的商品页面) |
notificationUrl | String(255) | 必填 | 异步通知 URL,此参数不为空,交易完成会往此地址发送通知(常用于处理订单状态) |
productInfos | Array | 必填 | 商品信息(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"
}
]
}返回参数
订单返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
code | Number(3) | 返回码,详见附录 |
appId | Number(20) | 系统->网站APP->APP ID |
transactionCurrency | String(3) | 交易币种(比如CNY/USD) |
transactionAmount | String(12) | 交易金额 |
redirectUrl | String(255) | 跳转的URL |
transactionType | String(32) | Sale |
message | String(255) | 系统返回信息 |
token | String(1024) | 订单token(第二步创建支付时候需要使用) |
timestamp | Number | 返回时间戳 |
expires | Number | 账单失效时间(单位:秒,默认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"
}