# 集成 on-ramp 页面

## 使用权限

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

部分自定义功能则需要申请成为[基础合作伙伴或高级合作伙伴](https://dev.fatpay.org/zh/get-started/onboarding)才能使用，本章节所有功能或参数，均标注了所需的合作伙伴类型

成为[基础合作伙伴或高级合作伙伴](https://dev.fatpay.org/zh/get-started/onboarding)后，您将获得专属的 partnerId

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

## 页面 URL

### **域名**

```html
https://ramp.fatpay.xyz/home
```

### 公共参数

{% hint style="warning" %}
参数名称及参数值均为大小写敏感
{% endhint %}

<table><thead><tr><th>参数名称</th><th>类型</th><th>是否必填</th><th>是否需要参与签名</th><th width="209">说明</th><th>示例</th></tr></thead><tbody><tr><td>partnerId</td><td>String</td><td>是</td><td>公共：否<br>基础：否<br>高级：是</td><td>合作伙伴 id<br>1. 若使用快速启动方式，可赋值为 <em>public ，</em>即公共合作伙伴<br>2. 若作为<a href="../get-started/onboarding">基础合作伙伴或高级合作伙伴</a>接入，则填入对应的合作伙伴 id</td><td>partnerId=<em>public</em></td></tr><tr><td>timestamp</td><td>String(10)</td><td>公共：否<br>基础：否<br>高级：是</td><td>公共：否<br>基础：否<br>高级：是</td><td>Unixtime 时间戳，精确到秒</td><td>timestamp=1656600459</td></tr><tr><td>nonce</td><td>String(6)</td><td>公共：否<br>基础：否<br>高级：是</td><td>公共：否<br>基础：否<br>高级：是</td><td>随机正整数</td><td>nonce=183214</td></tr><tr><td>signature</td><td>String</td><td>公共：否<br>基础：否<br>高级：是</td><td>否</td><td>签名值的生成具体请见 <a href="integration-tutorial/widget-signature">加签</a></td><td>signature=4UoZ2gIm3bcLTw5K6WdBJIaYBiXgQF3uvOfY4Ovc6+4=</td></tr></tbody></table>

拼接参数后的 URL 实例（公共合作伙伴）

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

## 集成方式

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

### **链接跳转**

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

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

### **iframe嵌入**

{% code overflow="wrap" %}

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

{% endcode %}

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

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

## 自定义

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

{% content-ref url="integration-tutorial/widget-customization" %}
[widget-customization](https://dev.fatpay.org/zh/reference/integration-tutorial/widget-customization)
{% endcontent-ref %}

{% content-ref url="integration-tutorial/interface-customization" %}
[interface-customization](https://dev.fatpay.org/zh/reference/integration-tutorial/interface-customization)
{% endcontent-ref %}

{% hint style="info" %}
为了更高的安全性，[高级合作伙伴](https://dev.fatpay.org/zh/get-started/onboarding)必须对URL 进行签名
{% endhint %}

{% content-ref url="integration-tutorial/widget-signature" %}
[widget-signature](https://dev.fatpay.org/zh/reference/integration-tutorial/widget-signature)
{% endcontent-ref %}