API接入
描述
如果您希望用户跳过支付货币选择、登录、支付方式选择,直接进入到付款页面,那么您可以使用此接口。
通过创建订单的接口,我们将生成一个支付链接,您需要将您的用户重定向至此链接完成支付,订单15分钟超时。
测试环境请求URL
https://api-nft-sbx.alchemytech.cc/nft/openapi/trade/order
生产环境请求URL
https://openapi-nft.alchemypay.org/nft/openapi/trade/order
请求方式:POST
Header参数:
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
access-token | Y | string | 免登录accessToken值 |
appId | Y | string | 应用的唯一标识 |
timestamp | Y | string | 当前 UTC 时间戳,13位 5分钟内有效 |
sign | Y | string | SHA1(appId+ appSecret + timestamp),将该三个参数拼接的字符串进行 SHA1 哈希计算从而生成 16 进制字符 |
Body参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
fiat | Y | string | USD/EUR/SGD/JPY/GBP等,商家定义NFT法币单位填入🔺 |
amount | C | string | NFT订单法币总金额,对应NFT定价法币单位,商家定义NFT法币单位填入🔺 |
crypto | C | string | BTC/ETH等 不传默认为ETH,NFT定价数字货币单位填入🔺 |
cryptoAmount | C | string | NFT订单数字货币总金额,对应NFT数字货币单位,NFT定价数字货币单位填入🔺 |
type | C | string | NFT类型:MARKET/MINT |
uniqueId | C | string | NFT Unique Identity,传入 MARKET必填🔺 |
quantity | C | string | NFT数量,传入 MINT必填🔺 |
payWayCode | Y | string | 支付方式代码:由nft/openapi/fiat/list 接口返回 |
redirectUrl | Y | string | 支付成功后的跳转URL |
callbackUrl | Y | string | 用于接收Alchemy Pay的回调通知 |
merchantOrderNo | Y | string | 商户自定义订单号 |
appId | Y | string | 商户应用的唯一标识 |
name | Y | string | NFT名称 |
picture | C | string | NFT图片地址/视频快照地址/默认地址,,图片大小尺寸220px * 220 px,图片地址不支持携带参数,eg:?xxx=yy&ccc=dd等 |
请求示例:
//法币
{
"side": "BUY",
"fiat": "USD",
"amount": "888",
"type": "MARKET",
"picture": "https://alchemypay.org",
"name": "nftName",
"uniqueId": "#1231",
"redirectUrl": "https://alchemypay.org",
"callbackUrl": "https://alchemypay.org",
"payWayCode": "10001",
"merchantOrderNo": "MER200000001",
"appId": "qwjelqjelqkwje"
}
//币本位
{
"side": "BUY",
"fiat": "USD",
"type": "MARKET",
"name": "nftName",
"picture": "https://alchemypay.org",
"uniqueId": "#1231",
"redirectUrl": "https://alchemypay.org",
"callbackUrl": "https://alchemypay.org",
"payWayCode": "10001",
"merchantOrderNo": "MER200000001",
"appId": "qwjelqjelqkwje",
"crypto": "ETH",
"cryptoAmount": "0.02",
}
返回示例:
{
"success": true,
"returnCode": "0000",
"returnMsg": "SUCCESS",
"extend": "",
"data": {
"orderNo":"945628891261980032",
"payUrl": "https://nft-test.alchemytech.cc/#/paymentMethod?token=ACH3430784095ACHyE0n0PobCLqH0i%2BsiCjLI%2FbXSCg756UApqylZ8%2Fy0Xxcu14QzZlUY%2Fg3zSHEVd84mUzLIbUF2Bdg5dLz4hTyMA%3D%3D&email=D%2F6dKirEszZ2qmEOA5L93X5hCnimXkw6bTQVo92ScdR6HmiSbViNxaYB18X9IfnX&orderNo=1044205847647412224&id=EGPDNKKDygNT5vgBzYVwsA%3D%3D" //支付跳转地址
}
}
Updated 4 months ago