Guides
Alchemy Pay
Start typing to search…

创建订单

路径：

POST open/api/payment

🚧

必须保留响应中的orderNo，它是用于订单查询的唯一标识符。

参数

请求参数

参数名

签名

必传

类型

长度

备注

appId

Y

Y

string

64

商户的唯一标识符

sign

N

Y

string

256

签名

merchantOrderNo

Y

Y

string

64

客户交易ID

orderAmount

Y

Y

string

64

订单金额（单位为分）

payCurrency

Y

Y

string

64

支付货币（EUR / USD）

userId

Y

Y

string

128

用户的唯一标识符（邮箱 / 手机号码）

paymentExchange

Y

N

string

512

前提条件：支付方式已配置交易所方式

1.指定交易所，可多次转账
2.用户通过发送此参数只能在交易所支付方式下使用指定交易所进行支付

paymentTokens

Y

N

string

128

  1. 指定支付数币，可以传输多个数币
  2. 转账后，用户只能使用列出的数币进行支付
  3. 必须包含在商户配置的数币表中
  4. 适用于转账和交易所

redirectURL

N

N

string

512

成功购买后的重定向地址

callbackURL

N

N

string

512

接收订单Webhook的地址

customParam

N

N

string

512

商户自定义参数

支持的token:

CryptoNetwork
USDTTRX, BSC, ETH, SOL
USDCTRX, BSC, ETH, SOL
ETHETH, BSC
BTCBTC
PCIETH, PCI

支持交易所代码：

ExchangeCode
Kraken16f021b0-f220-4bbb-aa3b-82d423301957
Paxos2fdd678d-8ece-49f5-992c-a1d7c4367833
Bybit3b8d8911-b2c0-4c1a-9127-675653c21960
Coinbase47624467-e52e-4938-a41a-7926b6c27acf
Robinhood6e192ebb-a073-4055-bbd7-d644539c9a20
Binance9226e5c2-ebc3-4fdd-94f6-ed52cdce1420

請求示例：

{
    "appId": "TEST000001",
    "sign": "TEST000001",
    "merchantOrderNo": "11126",
    "userId": "123456789@qq.com",
    "orderAmount": "1000",
    "payCurrency": "USD",
    "paymentTokens": "USDT,ETH",
    "paymentExchange": "16f021b0-f220-4bbb-aa3b-82d423301957,9226e5c2-ebc3-4fdd-94f6-ed52cdce1420",
    "redirectURL": "http://127.0.0.1:8022/open/api/payment2",
    "callbackURL": "http://127.0.0.1:8022/open/api/callback"
}

响应参数说明

参数名类型详情
successboolean是否成功
errorboolean是否出错
codelong响应代码
msgstring响应消息
traceIdstring追踪 ID
modelobject响应详细信息
checkout addressstring收銀台网址

响应示例

{
  "code": "0",
  "msg": "success",
  "model": {
    "webUrl": "htts://127.0.0.1:8080?orderNum=30021710923663910033",
    "orderNo":"2132131321"
  },
  "traceId": "666802eeb989c77a375967aded5d646",
  "success": true,
  "error": false
}

响应代码

代码解释
0成功
1支付异常
8000参数验证错误
8003Content-type 应为 application/json
8004请求参数格式不正确，需要是 JSON 格式
8007签名错误
8011重复的商户订单号
8012非法的 IP 地址
8013不支持的加密货币

Updated 23 days ago