> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pay247.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 接入说明

<Note>
  此文档是Pay247的唯一官方文档，Pay247 API提供的能力会在此持续更新，请大家及时关注。
</Note>

### 请求方法 Method: POST

### 请求头 Header:

```
"Content-Type":"application/json;charset=UTF-8"
```

### 响应头 Header:

```
"Content-Type":"application/json;charset=UTF-8"
```

### 时区

API所使用时区为 `UTC+8`

### 公共参数

* 公共请求参数

| 参数名       | 必选 | 类型     | 说明    | 示例                                   |
| :-------- | :- | :----- | :---- | :----------------------------------- |
| mch\_id   | 是  | string | 商户号   | SVSPYS63XM10042                      |
| timestamp | 是  | int    | 请求时间戳 | 1594047539321                        |
| version   | 是  | string | 版本    | v3.0                                 |
| uuid      | 是  | string | 请求ID  | 550e8400-e29b-41d4-a716-446655440000 |
| sign      | 是  | string | 签名    | b05a16b1e92aa4948e164b747b5749b4     |

* 公共响应参数

| 参数名       | 必须 | 类型     | 说明          | 示例                                   |
| :-------- | -- | :----- | ----------- | :----------------------------------- |
| code      | 是  | int    | 状态码，参考字典状态码 | 0                                    |
| message   | 是  | string | 提示内容/错误信息   | 操作成功                                 |
| uuid      | 是  | string | 响应ID        | 550e8400-e29b-41d4-a716-446655440000 |
| timestamp | 是  | int    | 响应时间戳       | 1599047539321                        |
| data      | 是  | mixed  | 响应数据        | 响应数据对象或者数组或者null                     |

### 状态码

* 状态码（code）

| 状态码  | 解释           |
| :--- | :----------- |
| 0    | 成功           |
| 4000 | 参数错误         |
| 4001 | 订单重复         |
| 4002 | 订单金额不在通道限额范围 |
| 4040 | 订单不存在        |
| 5000 | 系统异常         |
| 5001 | 钱包余额不足       |

### 支付主题

* 支付主题（pay\_theme）

| 主题代码   | 解释                       |
| :----- | :----------------------- |
| link   | 系统默认收银台模式                |
| custom | 商户自定义收银台模式，会返回银行卡、收款码等信息 |

### 支付方式

* 支付方式（pay\_method），更准确的开通的支付方式，请到商户系统后台查阅

| 币种   | 支付类型 | 支付方式        | 解释             |
| :--- | :--- | :---------- | :------------- |
| USDT | 代收   | TRC20       | USDT 波场TRC20代收 |
| USDT | 代付   | TRC20       | USDT 波场TRC20代付 |
| INR  | 代收   | UPI         | UPI扫码          |
| INR  | 代收   | UPI\_INTENT | UPI唤醒          |
| INR  | 代付   | BANK        | IFSC 银行转账      |
| PHP  | 代收   | GCASH       | GCASH 电子钱包     |
| PHP  | 代收   | MAYA        | MAYA 电子钱包      |
| PHP  | 代付   | BANK        | 银行转账           |