集成 NFT Checkout 页面
FaTPay将用户重定向到 FaTPay 提供的 URL 即可完成服务的集成
Last updated
FaTPay将用户重定向到 FaTPay 提供的 URL 即可完成服务的集成
Last updated
成为高级合作伙伴后，您将获得专属的 partnerId及密钥，用于签名URL。
若同时集成on-ramp法币入金与NFT Checkout，会分配两个partnerId，注意区分使用场景。
拼接参数后的 URL 实例
参数名称及参数值均为大小写敏感
| 参数名称 | 类型 | 是否必填 | 是否参与签名 | 说明 | 示例 |
|---|---|---|---|---|---|
传入的NFT合约地址及TokenId需真实有效，NFT Checkout用户端会获取NFT名称及图片信息
参数名称及参数值均为大小写敏感
传入加密货币类型及金额用途：
NFT定价：NFT Checkout用户端会根据用户选择的法币类型自动计算法币金额
订单结算：FaTPay会根据传入加密货币类型及金额进行结算
示例：NFT市场实时价格为0.1ETH，可以指定0.1ETH或0.11ETH，实际定价可以自行指定
参数名称及参数值均为大小写敏感
若在中心化平台有NFT的额外订单信息，可通过以下字段提交，实际使用场景可以自行决定，所有信息都会在订单支付成功后同步返回
参数名称及参数值均为大小写敏感
参数名称及参数值均为大小写敏感
将用户重定向到 FaTPay 链接即可完成服务的嵌入，页面已适配桌面端和移动端，可以很方便的嵌入到桌面Web页或移动端APP内。
以上链接使用公共合作伙伴 partnerId=public，已包含基础的配置，用户进入可享受 FaTPay 的服务，复制粘贴即可。
以上链接使用公共合作伙伴 partnerId=public，已包含基础的配置，用户进入可享受 FaTPay 的服务，复制粘贴即可。
少部分国家支付服务商可能不支持在iframe内完成支付，建议追加 windowOpen 参数，控制 FaTPay 后续流程新窗口打开页面完成后续流程
同时通过在链接中增加相应参数，即可实现丰富的自定义功能
为了更高的安全性，必须对URL 进行签名
| 参数名称 | 类型 | 是否必填 | 是否参与签名 | 说明 | 示例 |
|---|---|---|---|---|---|
| 参数名称 | 类型 | 是否必填 | 是否参与签名 | 说明 | 示例 |
|---|---|---|---|---|---|
| 参数名称 | 类型 | 是否必填 | 是否参与签名 | 说明 | 示例 |
|---|---|---|---|---|---|
| 参数名称 | 类型 | 是否必填 | 是否参与签名 | 说明 | 示例 |
|---|---|---|---|---|---|
partnerId
String
是
是
合作伙伴 id 1. 若使用快速启动方式，可赋值为 public ，即公共合作伙伴 2. 若作为基础合作伙伴或高级合作伙伴接入，则填入对应的合作伙伴 id
partnerId=public
timestamp
String(10)
是
是
Unixtime 时间戳，精确到秒
timestamp=1656600459
timeout
String(10)
是
是
收银台过期时间，Unixtime 时间戳，精确到秒，超时后该链接无法下单
timestamp=1656600459
nonce
String(6)
是
是
随机正整数
nonce=183214
signature
String
是
否
签名值的生成具体请见 加签
signature=4UoZ2gIm3bcLTw5K6WdBJIaYBiXgQF3uvOfY4Ovc6+4=
contractAddress
String
是
是
NFT合约地址地址
contractAddress=0x407c5d2c02ab0e4b0a98d14778a5de180eb1357f
nftNetwork
String
是
是
NFT合约所属公链 - ethereum
- polygon
- bsc
- optimism - arbitrum - avalanche - fantom - celo - harmony 其他公链可联系商务对接人
nftNetwork=ethereum
tokenId
String
type=MARKET，必填 type=MINT，不填
是
指定NFT的TokenID，若交易类型为Market需提交（二级转让对应TokenID的NFT），若交易类型为Mint不需要提交
tokenId=245
merchantUniqueId
String
否
是
若在中心化平台有NFT的唯一标识，可通过该字段提交，交易成功后订单明细内会返回，方便后续交易匹配
merchantUniqueId=8888888888
type
String
是
是
MARKET：二级市场销售
MINT：铸造
type=MARKET
mintQuantity
String
type=MARKET，不填 type=MINT，必填
是
≥1的整数 - 当type=mint的时候需填写（若不填则默认为1） - 若type=MARKET则忽略该参数
mintQuantity=1
ownerWalletAddress
String
type=MARKET，必填 type=MINT，不填
是
NFT当前持有人钱包地址
ownerWalletAddress=0x407c5d2c02ab0e4b0a98d14778a5de180eb1367f
transferWalletAddress
String
是
是
支付后，NFT转让的钱包地址
transferWalletAddress=0x1D894C1D34B462796c6f43A9d086C9F175CCb422
cryptoCurrency
String
是
是
指定加密货币
cryptoCurrency=USDC_POLYGON
amount
String
是
是
指定加密货币金额
amount=200
walletAddress
String
若为实时结算需填写 具体请联系商务
是
加密货币结算的钱包地址
walletAddress=0x2D463C1D34B462796c6f43A9d086C9F175CCb488
walletAddressTag
String
否
是
加密货币结算的钱包地址的Tag/Memo（仅支持Tag/Memo的公链支持传该参数，如ATOM）
walletAddressTag=111
merchantOrderNo
String
否
是
外部商户订单号
merchantOrderNo=88888888888888
externalCustomerId
String
否
是
外部商户客户ID
externalCustomerId=88888888888888
ext
String
否
是
扩展字段，根据合作方诉求自行定义，加签前需要对该字段进行urlencode
ext=88888
language
String
否
否
默认显示语言，用户可 菜单内修改，不传根据系统规则显示默认语言
language=en
fiatCurrency
String
否
否
限制用户只能在给定的法币中选择，多个法币用"," 分隔
限制选择只能从USD、THB 中选择
fiatCurrency=USD,THB
defaultFiatCurrency
String
否
否
默认选择的法币
默认选择法币USD defaultFiatCurrency=USD
String
否
否
默认填充的邮箱，用户可自行修改。
邮箱格式校验错误，则邮箱留空
email=fatpay@fatpay.xyz