三网话费充值接口文档

**三网话费充值接口文档**

**1. 接口概述**

本接口用于实现三网话费充值功能，支持多种支付方式，包括微信、支付宝、银行卡等。该接口提供了一个统一的API入口，让开发者可以轻松地集成到自己的系统中。

**2. 接口地址**

* **充值接口**: ` />* **查询接口**: ` />
**3. 请求方式**

* **POST**: 用于发送充值请求* **GET**: 用于查询充值状态**4. 请求参数**

###4.1 充值接口| 参数名称 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `phone` | string | 是 | 手机号码 |
| `amount` | number | 是 | 充值金额 |
| `payType` | string | 是 | 支付方式（微信、支付宝、银行卡等） |

###4.2 查询接口| 参数名称 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `phone` | string | 是 | 手机号码 |
| `orderNo` | string | 是 | 充值订单号 |

**5. 响应数据**

###5.1 充值接口* **成功**: `200 OK`

json{
 "code":0,
 "msg": "充值成功",
 "data": {
 "orderNo": "1234567890"
 }
}

* **失败**: `400 Bad Request`

json{
 "code": -1,
 "msg": "充值失败",
 "data": {}
}

###5.2 查询接口* **成功**: `200 OK`

json{
 "code":0,
 "msg": "查询成功",
 "data": {
 "orderNo": "1234567890",
 "status": "已完成"
 }
}

* **失败**: `400 Bad Request`

json{
 "code": -1,
 "msg": "查询失败",
 "data": {}
}

**6. 支付方式**

支持以下支付方式：

* 微信* 支付宝* 银行卡**7. 充值金额限制**

充值金额最小为 `10` 元，最大为 `10000` 元。

**8. 接口限流**

接口每分钟可处理 `100` 次请求，超过此次数将返回 `429 Too Many Requests` 错误。

**9. 接口错误码**

| 错误码 | 描述 |
| --- | --- |
|0 | 成功 |
| -1 | 失败 |
|40001 | 充值金额过小 |
|40002 | 充值金额过大 |
|40003 | 支付方式不支持 |

**10. 接口示例**

###10.1 充值接口

bashcurl -X POST 
  
 -H 'Content-Type: application/json' 
 -d '{"phone": "1234567890", "amount":100, "payType": "微信"}'

###10.2 查询接口

bashcurl -X GET 
  
 -H 'Content-Type: application/json' 
 -d '{"phone": "1234567890", "orderNo": "1234567890"}'

**11. 接口安全**

该接口使用 HTTPS 协议传输数据，确保了数据的安全性。

**12. 接口维护**

该接口将在每天凌晨2:00 进行维护，维护时间为30 分钟。