集成 NFT Checkout 页面
FaTPay将用户重定向到 FaTPay 提供的 URL 即可完成服务的集成
使用权限
成为高级合作伙伴后，您将获得专属的 partnerId及密钥，用于签名URL。
若同时集成on-ramp法币入金与NFT Checkout，会分配两个partnerId，注意区分使用场景。
页面 URL
域名
拼接参数后的 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= |
NFT基础信息
传入的NFT合约地址及TokenId需真实有效，NFT Checkout用户端会获取NFT名称及图片信息
参数名称及参数值均为大小写敏感
| 参数名称 | 类型 | 是否必填 | 是否参与签名 | 说明 | 示例 |
|---|---|---|---|---|---|
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 |
NFT定价&结算
传入加密货币类型及金额用途：
NFT定价：NFT Checkout用户端会根据用户选择的法币类型自动计算法币金额
订单结算：FaTPay会根据传入加密货币类型及金额进行结算
示例：NFT市场实时价格为0.1ETH，可以指定0.1ETH或0.11ETH，实际定价可以自行指定
参数名称及参数值均为大小写敏感
| 参数名称 | 类型 | 是否必填 | 是否参与签名 | 说明 | 示例 |
|---|---|---|---|---|---|
cryptoCurrency | String | 是 | 是 | 指定加密货币 | cryptoCurrency=USDC_POLYGON |
amount | String | 是 | 是 | 指定加密货币金额 | amount=200 |
walletAddress | String | 若为实时结算需填写 具体请联系商务 | 是 | 加密货币结算的钱包地址 | walletAddress=0x2D463C1D34B462796c6f43A9d086C9F175CCb488 |
walletAddressTag | String | 否 | 是 | 加密货币结算的钱包地址的Tag/Memo（仅支持Tag/Memo的公链支持传该参数，如ATOM） | walletAddressTag=111 |
合作方外部信息
若在中心化平台有NFT的额外订单信息，可通过以下字段提交，实际使用场景可以自行决定，所有信息都会在订单支付成功后同步返回
参数名称及参数值均为大小写敏感
| 参数名称 | 类型 | 是否必填 | 是否参与签名 | 说明 | 示例 |
|---|---|---|---|---|---|
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 |
集成方式
将用户重定向到 FaTPay 链接即可完成服务的嵌入，页面已适配桌面端和移动端，可以很方便的嵌入到桌面Web页或移动端APP内。
链接跳转
以上链接使用公共合作伙伴 partnerId=public，已包含基础的配置，用户进入可享受 FaTPay 的服务，复制粘贴即可。
iframe嵌入
以上链接使用公共合作伙伴 partnerId=public，已包含基础的配置，用户进入可享受 FaTPay 的服务，复制粘贴即可。
少部分国家支付服务商可能不支持在iframe内完成支付，建议追加 windowOpen 参数，控制 FaTPay 后续流程新窗口打开页面完成后续流程
自定义
同时通过在链接中增加相应参数，即可实现丰富的自定义功能
自定义界面为了更高的安全性，必须对URL 进行签名
Last updated