FaTPay Docs
🇨🇳 中文(简体)
🇨🇳 中文(简体)
  • 介绍
  • 申请集成
    • 成为合作伙伴
    • 快速启动
  • 更多场景的最佳实践
    • 交易所
    • 项目方
    • 钱包工具
    • 流量合作
    • NFT
  • 参考文档
    • 集成 on-ramp 页面
      • 自定义控件
      • 自定义界面
      • 加签
    • 集成 NFT Checkout 页面
    • API 接口文档
      • API
        • 加密货币查询接口
        • 法定货币及支付方式查询接口
        • 报价查询接口
        • 订单列表查询接口
      • Webhooks
        • 订单回调通知
      • 接口加签 & 验签
  • 附录
    • 语言种类
    • 可支持法币
    • 可支持加密货币(on-ramp)
    • 可支持的加密货币(NFT Checkout)
    • API 接口错误码索引
    • RSA 密钥生成指南
    • Demo
      • 集成 FaTPay 页面加签
      • API 接口加签
      • Webhook 订单回调验签
  • 翻译说明
    • 中文翻译
Powered by GitBook
On this page
  • 使用权限
  • 页面 URL
  • 域名
  • 公共参数
  • 集成方式
  • 链接跳转
  • iframe嵌入
  • 自定义
  1. 参考文档

集成 on-ramp 页面

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

PreviousNFTNext自定义控件

Last updated 2 years ago

使用权限

对于大多数项目,无需任何权限即可集成 FaTPay 页面

部分自定义功能则需要申请成为才能使用,本章节所有功能或参数,均标注了所需的合作伙伴类型

成为后,您将获得专属的 partnerId

对于高级合作伙伴,还将获得密钥 ,用于签名URL,获得更好的安全性保障

页面 URL

域名

https://ramp.fatpay.xyz/home

公共参数

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

参数名称
类型
是否必填
是否需要参与签名
说明
示例

partnerId

String

是

公共:否 基础:否 高级:是

partnerId=public

timestamp

String(10)

公共:否 基础:否 高级:是

公共:否 基础:否 高级:是

Unixtime 时间戳,精确到秒

timestamp=1656600459

nonce

String(6)

公共:否 基础:否 高级:是

公共:否 基础:否 高级:是

随机正整数

nonce=183214

signature

String

公共:否 基础:否 高级:是

否

signature=4UoZ2gIm3bcLTw5K6WdBJIaYBiXgQF3uvOfY4Ovc6+4=

拼接参数后的 URL 实例(公共合作伙伴)

https://ramp.fatpay.xyz/?partnerId=public

集成方式

将用户重定向到 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 后续流程新窗口打开页面完成后续流程

自定义

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

合作伙伴 id 1. 若使用快速启动方式,可赋值为 public ,即公共合作伙伴 2. 若作为接入,则填入对应的合作伙伴 id

签名值的生成具体请见

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

基础合作伙伴或高级合作伙伴
基础合作伙伴或高级合作伙伴
自定义控件
自定义界面
高级合作伙伴
加签
基础合作伙伴或高级合作伙伴
加签