网页接入

描述

通过url跳转至NTF收银台,跳转过来时可以将NFT商品参数和价格参数带入

测试环境地址: https://nft-sbx.alchemytech.cc/

生产环境地址: https://nftcheckout.alchemypay.org/

参数

参数名必选签名类型说明
appIdYYstring商户应用的唯一标识
tokenCCstring如果传入token,用户不需要再输入验证码登录;token可以从免登录访问获取token接口获取,URLencode处理
emailCCstring用户邮箱,如果走免登录,email请从获取token的API返回的参数重取值并进行urlencode
idCCstringid,从获取token接口获取,与token,email一起传入,URLencode处理
timestampYYstring当前 UTC 时间戳,13位
languageCYstring语言 不传默认英文 zh-HK 繁体中文 en-US 英语 ko 韩文 es 西班牙语
timeoutYYstring超时时间戳,13位
fiatCYstringUSD/EUR/SGD/JPY/GBP等,商家定义NFT法币单位填入🔺
amountCYstringNFT订单法币总金额,对应NFT定价法币单位,商家定义NFT法币单位填入🔺
cryptoCYstringBTC/ETH等 不传默认为ETH,NFT定价数字货币单位填入🔺
cryptoAmountCYstringNFT订单数字货币总金额,对应NFT数字货币单位,NFT定价数字货币单位填入🔺
targetFiatCYstring商户可定义默认展示的支付币种
typeYYstringNFT类型:MARKET/MINT
uniqueIdCYstringNFT Unique Identity,传入 MARKET必填🔺
quantityCYstringNFT数量,传入 MINT必填🔺
nameYYstringNFT名称
pictureYYstringNFT图片地址/视频快照地址/默认地址,,图片大小尺寸220px * 220 px,图片地址不支持携带参数,eg:?xxx=yy&ccc=dd等
redirectUrlYYstring支付成功后的跳转URL
callbackUrlYYstring用于接收Alchemy Pay的回调通知
merchantOrderNoYYstring商户自定义订单号
merchantNameCYstring商家名称
signatureYYstring签名,URLEncode处理

示例

法币定价带入参数:

{
    "amount": "5",
    "appId": "ahzxh0klegv1fzol",
    "callbackUrl": "https://alchemypay.org",
    "fiat": "SGD",
    "merchantName": "name",
    "merchantOrderNo": "ACH_TEST2023020110027",
    "name": "xter-nft",
    "nftAmount": "5",
    "nonce": 223634627,
    "picture": "https://download.bit.store/official/BitStore/pic/user_portrait/20.jpeg",
    "quantity": "3",
    "redirectUrl": "https://alchemypay.org",
    "signature": "nLjws0bt5PANY0ZE9BlnvFnHL4Y=",
    "targetFiat": "SGD",
    "timeout": "1675311363000",
    "timestamp": 1675305175,
    "type": "MINT"
}
https://nft-test.alchemytech.cc/?amount=200&appId=ahzxh0klegv1fzol&callbackUrl=https%3A%2F%2Falchemypay.org&email=oiSNiys7o%252BPHh6XiTeTg4xAw6za%252BOlzyajeYuue%252FTVc%253D&fiat=USD&id=EGPDNKKDygNT5vgBzYVwsA%253D%253D&merchantName=name&merchantOrderNo=ACH_TEST202212191001&name=%E4%B8%AD%E6%96%87&nftAmount=100&nonce=1674517091&picture=https%3A%2F%2Falchemypay.org%2Fwp-content%2Fuploads%2F2022%2F05%2Falchemy-pay-logo-light-1.png&redirectUrl=https%3A%2F%2Falchemypay.org&signature=frP9wAqJrbpE3Ui43QABGqph%2BUc%3D&targetFiat=USD&timeout=1701677383000&timestamp=1671608907&token=ACH3430784095ACHjF25%252F8dIFInSYQKgxn1786sqkncE0eYfsoCzNbtAuYdSzezW0oBnxoxmVbQUR%252FhnKz8tBDEptJfr22eZRvmRgA%253D%253D&type=MARKET&uniqueId=11133#/

数字货币定价带入参数:

{
    "appId": "ahzxh0klegv1fzol",
    "callbackUrl": "https://alchemypay.org",
    "crypto": "ETH",
    "cryptoAmount": "0.01",
    "merchantName": "name",
    "merchantOrderNo": "ACH_TEST2023020110027",
    "name": "xter-nft",
    "nonce": 839208497,
    "picture": "https://download.bit.store/official/BitStore/pic/user_portrait/20.jpeg",
    "quantity": "3",
    "redirectUrl": "https://alchemypay.org",
    "signature": "NzFLwv6pIwkN09SxKBz8QwFyxdA=",
    "targetFiat": "SGD",
    "timeout": "1675311363000",
    "timestamp": 1675305012,
    "type": "MINT"
}

https://nft-sbx.alchemytech.cc?appId=o0hz2e8avsbuk12h&callbackUrl=https%3A%2F%2Falchemypay.org&crypto=ETH&cryptoAmount=0.5&email=oiSNiys7o%2BPHh6XiTeTg4xAw6za%2BOlzyajeYuue%2FTVc%3D&fiat=USD&id=c5IC7mkHz7ku95dYUU7FHw%3D%3D&merchantName=name&merchantOrderNo=ACH_TEST202301091005&name=NFT+name&nonce=557173557&picture=https%3A%2F%2Fdownload.bit.store%2Fofficial%2FBitStore%2Fpic%2Fuser_portrait%2F20.jpeg&quantity=3&redirectUrl=https%3A%2F%2Falchemypay.org&signature=NsvaSQ67qwo1weRryNgMAM%2B2D5Q%3D&timeout=1673251045000&timestamp=1673258682&token=ACH6335436896ACHoAcgGT0oMCAkRKxUR8k0efO2H8RJpOxNl1ox%2FZpdH0eYOAHQtUYveEyQ86QDsmW6e6oST0xmwIefqHE5auuWIg%3D%3D&type=MINT