API 接口文档

接口列表

接口	方法	路径	说明
JSAPI 支付	POST	/v1/pay/jsapi	H5/小程序支付
二维码支付	POST	/v1/pay/qrpay	生成支付二维码
交易查询	POST	/v1/pay/tradeQuery	查询订单状态
退款	POST	/v1/pay/refund	订单退款
退款查询	POST	/v1/pay/refundQuery	查询退款状态
异步通知	POST	商户提供	支付/退款结果通知

参考文档

• 状态定义 - 交易状态、订单状态说明
• 错误码参考 - 全局错误码说明

通用规范

请求

• 协议: HTTPS
• 方法: POST
• Content-Type: application/json
• 编码: UTF-8

认证信息

所有接口需在 HTTP Header 中携带 Authorization 字段进行身份认证和签名验证。

Authorization 格式

Authorization: RSA service_id={服务商号},timestamp={时间戳},nonce_str={随机字符串},sign={签名值}

参数说明

参数	类型	必填	说明
service_id	String	是	服务商/机构号
timestamp	String	是	时间戳(秒)
nonce_str	String	是	随机字符串
sign	String	是	签名值(RSA-SHA256)

签名规则

将 service_id、timestamp、nonce_str 三个参数按 ASCII 排序后拼接,使用商户私钥进行 RSA-SHA256 签名。

待签名字符串示例:

nonce_str=abc123&service_id=SVC1234567890&timestamp=1704067200

请求示例

POST /v1/pay/jsapi
Content-Type: application/json
Authorization: RSA service_id=SVC1234567890,timestamp=1704067200,nonce_str=abc123,sign=签名值

{
  "merchant_no": "1234567890",
  "out_trade_no": "ORDER001",
  "total_amount": 100
}

curl https://api.meepay.org/v1/pay/jsapi \
  -X POST \
  -H "Content-Type: application/json" \
  -H 'Authorization: RSA service_id=SVC1234567890,timestamp=1704067200,nonce_str=abc123,sign=签名值' \
  -d '{"merchant_no": "1234567890", "out_trade_no": "ORDER001", "total_amount": 100}'

响应格式

{
  "code": "00000",
  "msg": "success",
  "data": {}
}

参数	类型	说明
code	String	响应码,00000 成功,非 00000 为5位错误码
msg	String	响应消息
data	Object	业务数据

错误码

错误码	说明
00000	成功
10001	参数错误
10002	签名失败
10003	商户号不存在
10010	系统繁忙