# 支付管理接口

## 接口标准
- HTTP 入口：`/api/payment/auth/{controller}/{action}`
- 所有接口都需要 `Authorization: Bearer <JWT>`
- 返回格式为 JSON，继承账号授权接口返回结构
- HTTP 状态码固定返回 `200`
- `code` 统一使用常见业务状态语义：`200` 成功、`401` 未认证/登录过期、`403` 已认证但无权限、`404` 资源不存在、`500` 服务端异常

```jsonc
{
  "code": 200, // 业务状态码
  "info": "ok", // 提示信息
  "data": {}, // 业务数据
  "error": "", // 可选，401/403 等鉴权异常时返回稳定错误标识
  "token": "jwt" // 续签时可能返回，可选
}
```

## 接口列表

### `/api/payment/auth/address/set`
- 说明：新增或修改收货地址

```jsonc
{
  "id": 0, // 地址 ID，0 表示新增，非 0 表示更新
  "type": 1, // 默认地址标记，0 否，1 是
  "user_name": "张三", // 收货人姓名
  "user_phone": "13800000000", // 收货人手机号
  "region_prov": "浙江省", // 省份
  "region_city": "杭州市", // 城市
  "region_area": "西湖区", // 区县
  "region_addr": "文三路 1 号", // 详细地址
  "idcode": "", // 可选，身份证号码
  "idimg1": "", // 可选，身份证正面图片
  "idimg2": "" // 可选，身份证反面图片
}
```

### `/api/payment/auth/address/get`
- 说明：获取当前用户地址列表

```jsonc
{}
```

### `/api/payment/auth/address/state`
- 说明：切换默认地址状态

```jsonc
{
  "id": 1, // 地址 ID
  "type": 1 // 目标状态，0 非默认，1 默认
}
```

### `/api/payment/auth/address/remove`
- 说明：删除收货地址

```jsonc
{
  "id": 1 // 地址 ID
}
```

### `/api/payment/auth/balance/get`
- 说明：分页获取余额记录

```jsonc
{
  "page": 1 // 页码
}
```

### `/api/payment/auth/integral/get`
- 说明：分页获取积分记录

```jsonc
{
  "page": 1 // 页码
}
```