面向开发者与项目团队的文档写作专家，可生成API文档、技术报…

# 商城支付接口 API 文档（微信支付 / 支付宝）

一、通用说明

• Base URL：https://api.yourmall.com/v1/payment
• 请求格式：Content-Type: application/json
• 鉴权方式：请求头携带 Authorization: Bearer {token}
• 通用返回结构：

```json

{

"code": 0,

"message": "success",

"data": {}

}

```

• code = 0 表示成功，非 0 表示失败（如 4001 参数错误、4002 签名错误、5000 系统异常）

---

二、微信支付

2.1 下单接口

POST /wechat/order

请求参数：

| 参数名 | 类型 | 必填 | 说明 |

|---|---|---|---|

| out_trade_no | string | 是 | 商户订单号，唯一 |

| total_fee | integer | 是 | 金额，单位：分 |

| body | string | 是 | 商品描述 |

| notify_url | string | 是 | 异步回调地址 |

| openid | string | 条件 | JSAPI 支付必填 |

| trade_type | string | 是 | JSAPI / NATIVE / APP |

返回示例（JSAPI）：

```json

{

"code": 0,

"message": "success",

"data": {

"appId": "wx8888888888",

"timeStamp": "1700000000",

"nonceStr": "abc123",

"package": "prepay_id=wx201xxxxxxxx",

"signType": "RSA",

"paySign": "xxxxxxxx"

}

}

```

2.2 退款接口

POST /wechat/refund

请求参数：

| 参数名 | 类型 | 必填 | 说明 |

|---|---|---|---|

| out_trade_no | string | 是 | 原商户订单号 |

| out_refund_no | string | 是 | 商户退款单号，唯一 |

| refund_fee | integer | 是 | 退款金额，单位：分 |

| reason | string | 否 | 退款原因 |

返回示例：

```json

{

"code": 0,

"message": "success",

"data": {

"out_refund_no": "R20240001",

"refund_status": "PROCESSING",

"refund_fee": 1000

}

}

```

---

三、支付宝

3.1 下单接口

POST /alipay/order

请求参数：

| 参数名 | 类型 | 必填 | 说明 |

|---|---|---|---|

| out_trade_no | string | 是 | 商户订单号，唯一 |

| total_amount | string | 是 | 金额，单位：元，保留两位小数 |

| subject | string | 是 | 商品标题 |

| notify_url |