集成 on-ramp 页面

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

使用权限

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

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

成为基础合作伙伴或高级合作伙伴后,您将获得专属的 partnerId

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

页面 URL

域名

https://ramp.fatpay.xyz/home

公共参数

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

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

partnerId

String

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

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

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 后续流程新窗口打开页面完成后续流程

自定义

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

自定义控件自定义界面

为了更高的安全性,高级合作伙伴必须对URL 进行签名

加签

Last updated