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-tokenYstring免登录accessToken值
appIdYstring应用的唯一标识
timestampYstring当前 UTC 时间戳,13位 5分钟内有效
signYstringSHA1(appId+ appSecret + timestamp),将该三个参数拼接的字符串进行 SHA1 哈希计算从而生成 16 进制字符

Body参数

参数名必选类型说明
fiatYstringUSD/EUR/SGD/JPY/GBP等,商家定义NFT法币单位填入🔺
amountCstringNFT订单法币总金额,对应NFT定价法币单位,商家定义NFT法币单位填入🔺
cryptoCstringBTC/ETH等 不传默认为ETH,NFT定价数字货币单位填入🔺
cryptoAmountCstringNFT订单数字货币总金额,对应NFT数字货币单位,NFT定价数字货币单位填入🔺
typeCstringNFT类型:MARKET/MINT
uniqueIdCstringNFT Unique Identity,传入 MARKET必填🔺
quantityCstringNFT数量,传入 MINT必填🔺
payWayCodeYstring支付方式代码:由nft/openapi/fiat/list 接口返回
redirectUrlYstring支付成功后的跳转URL
callbackUrlYstring用于接收Alchemy Pay的回调通知
merchantOrderNoYstring商户自定义订单号
appIdYstring商户应用的唯一标识
nameYstringNFT名称
pictureCstringNFT图片地址/视频快照地址/默认地址,,图片大小尺寸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"  //支付跳转地址
    }
}