银盛支付API接口文档 - 开发参数说明
银盛支付API接口文档是开发者对接银盛支付系统的重要参考资料。本文档详细介绍银盛支付各接口的参数说明、调用方式和返回格式，帮助开发者快速完成接口对接。
一、接口基础信息
接口地址
| 环境 | 地址 |
|---|---|
| 测试环境 | https://test-api.yinsheng.com |
| 生产环境 | https://api.yinsheng.com |
请求方式
- 支持HTTP POST请求
- Content-Type: application/x-www-form-urlencoded 或 application/json
- 字符编码：UTF-8
公共请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| merchant_no | String | 是 | 商户号 |
| timestamp | Long | 是 | 时间戳（秒级） |
| nonce_str | String | 是 | 随机字符串（32位以内） |
| sign | String | 是 | 签名 |
| version | String | 否 | 版本号，默认1.0 |
二、支付接口
扫码支付接口
接口地址：/pay/qrcode/create
功能说明：生成支付二维码，用户扫码完成支付
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| order_no | String | 是 | 商户订单号，唯一标识 |
| amount | String | 是 | 订单金额，单位元，如100.00 |
| pay_type | String | 是 | 支付类型：WECHAT_NATIVE/ALIPAY_QR |
| subject | String | 是 | 商品名称 |
| notify_url | String | 是 | 异步通知地址 |
| expire_time | Integer | 否 | 二维码有效期（秒），默认300 |
| attach | String | 否 | 附加数据，原样返回 |
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | String | 返回码，0000表示成功 |
| msg | String | 返回信息 |
| order_no | String | 商户订单号 |
| qr_code | String | 支付二维码内容 |
| qr_url | String | 二维码图片URL |
三、订单查询接口
接口地址：/order/query
功能说明：查询订单支付状态
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| order_no | String | 是 | 商户订单号 |
| trade_no | String | 否 | 银盛交易号 |
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | String | 返回码 |
| msg | String | 返回信息 |
| order_no | String | 商户订单号 |
| trade_no | String | 银盛交易号 |
| status | String | 订单状态：0待支付/1已支付/2已关闭 |
| amount | String | 订单金额 |
| pay_time | String | 支付时间 |
四、退款接口
接口地址：/refund/create
功能说明：发起退款请求
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| order_no | String | 是 | 原商户订单号 |
| refund_no | String | 是 | 退款订单号，唯一标识 |
| refund_amount | String | 是 | 退款金额，单位元 |
| refund_reason | String | 否 | 退款原因 |
| notify_url | String | 否 | 退款结果通知地址 |
五、异步通知
支付完成后，银盛支付会向商户设置的notify_url发送异步通知：
通知参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| order_no | String | 商户订单号 |
| trade_no | String | 银盛交易号 |
| amount | String | 订单金额 |
| status | String | 支付状态 |
| pay_time | String | 支付完成时间 |
| pay_type | String | 支付方式 |
| sign | String | 签名 |
返回要求
商户收到通知后，需返回字符串"SUCCESS"，否则银盛支付会重复发送通知。
六、错误码说明
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| 0000 | 成功 | - |
| 1001 | 签名错误 | 检查签名算法和密钥 |
| 1002 | 参数错误 | 检查必填参数是否完整 |
| 1003 | 商户不存在 | 检查商户号是否正确 |
| 2001 | 订单已存在 | 更换订单号 |
| 2002 | 订单不存在 | 检查订单号是否正确 |
| 3001 | 余额不足 | 检查账户余额 |
七、联系我们
如果您在对接过程中遇到问题，欢迎联系我们：
- 招商咨询：135-6041-0649
- 产品咨询：182-1888-7488
- 技术支持：136-3138-7748
- 客服热线：400-600-9811
地址：广州市天河区体育西路191号中石化大厦B塔48楼