集成 NFT Checkout 页面

FaTPay将用户重定向到 FaTPay 提供的 URL 即可完成服务的集成

使用权限

成为高级合作伙伴后，您将获得专属的 partnerId及密钥，用于签名URL。

若同时集成on-ramp法币入金与NFT Checkout，会分配两个partnerId，注意区分使用场景。

页面 URL

域名

https://ramp.fatpay.xyz/home

拼接参数后的 URL 实例

https://ramp.fatpay.xyz/home?nonce=123321&partnerId=KOZiIRdpZ&timestamp=1676532904&timeout=1676619304&contractAddress=0x407c5d2c02ab0e4b0a98d14778a5de180eb1357f&nftNetwork=ethereum&tokenId=245&type=MARKET&ownerWalletAddress=0x407c5d2c02ab0e4b0a98d14778a5de180eb1367f&transferWalletAddress=0x1D894C1D34B462796c6f43A9d086C9F175CCb422&cryptoCurrency=USDC_POLYGON&amount=200&walletAddress=0x2D463C1D34B462796c6f43A9d086C9F175CCb488&signature=oM378von68VI5BNS%2FC9wGSR5S%2BDteuPv%2BFGpW%2FvgreQ%3D

公共参数

参数名称及参数值均为大小写敏感

参数名称	类型	是否必填	是否参与签名	说明	示例
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	是	是	指定加密货币 附录：NFT可支持加密货币	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
email	String	否	否	默认填充的邮箱，用户可自行修改。 邮箱格式校验错误，则邮箱留空	[email protected]

集成方式

将用户重定向到 FaTPay 链接即可完成服务的嵌入，页面已适配桌面端和移动端，可以很方便的嵌入到桌面Web页或移动端APP内。

链接跳转

<a href="https://rmp.fatpay.xyz/?partnerId=public" target="_blank">Buy with FaTPay</a>

以上链接使用公共合作伙伴 partnerId=public，已包含基础的配置，用户进入可享受 FaTPay 的服务，复制粘贴即可。

iframe嵌入

<iframe
  src="https://ramp.fatpay.xyz/?partnerId=public&windowOpen=1"
  allow="accelerometer; autoplay; camera; gyroscope; payment"
  width="100%"
  height="100%"
  frameborder="0"
/>
</iframe>

以上链接使用公共合作伙伴 partnerId=public，已包含基础的配置，用户进入可享受 FaTPay 的服务，复制粘贴即可。

少部分国家支付服务商可能不支持在iframe内完成支付，建议追加 windowOpen 参数，控制 FaTPay 后续流程新窗口打开页面完成后续流程

自定义

同时通过在链接中增加相应参数，即可实现丰富的自定义功能

自定义界面

为了更高的安全性，必须对URL 进行签名

加签