# 集成 on-ramp 页面

## 使用权限

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

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

成为[基础合作伙伴或高级合作伙伴](/zh/get-started/onboarding.md)后，您将获得专属的 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="/pages/gAGd40q7Wycl10xkPLO8">基础合作伙伴或高级合作伙伴</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="/pages/cLq3N4WjwnFuAvJ6kvd9">加签</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="/pages/0GumJFBafX2MD82057sS" %}
[自定义控件](/zh/reference/integration-tutorial/widget-customization.md)
{% endcontent-ref %}

{% content-ref url="/pages/yq4L9luWqzJisyfQAR7U" %}
[自定义界面](/zh/reference/integration-tutorial/interface-customization.md)
{% endcontent-ref %}

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

{% content-ref url="/pages/cLq3N4WjwnFuAvJ6kvd9" %}
[加签](/zh/reference/integration-tutorial/widget-signature.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev.fatpay.org/zh/reference/integration-tutorial.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.