接口说明及规范
本文档为昔年易支付接口开发文档，适用于商户系统集成昔年易支付支付接口。
协议规则
| 项目 | 说明 |
|---|---|
| 提交数据格式 | application/x-www-form-urlencoded |
| 返回数据格式 | JSON |
| 字符编码 | UTF-8 |
| 签名算法 | SHA256WithRSA |
V2升级说明
重要变更
- V2接口全面使用 RSA 签名算法；V1接口使用 MD5 签名算法
- V2接口改用全新的接口地址，支持退款、代付等功能；V1接口使用submit.php和mapi.php提交订单
- V2接口新增timestamp入参和返回值用于校验时间戳
获取RSA密钥对
在 商户后台->个人资料->API信息 页面，点击【生成商户RSA密钥对】，生成后注意保存【商户私钥】。对接接口时只需要用到【平台公钥】与【商户私钥】。
安全提示
请妥善保管您的商户私钥，不要泄露给他人。建议将私钥保存在服务器配置文件中，而不是直接写在代码里。
接口请求规范
1. 请求头设置
Content-Type: application/x-www-form-urlencoded
Accept: application/json
User-Agent: 商户系统标识/版本号2. 公共请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| mch_id | String | 是 | 商户号，由平台分配 |
| timestamp | String | 是 | 请求时间戳，格式为yyyy-MM-dd HH:mm:ss |
| sign | String | 是 | 请求参数的签名，详见签名规则 |
3. 公共响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | Integer | 返回码，0表示成功，其他值表示失败 |
| msg | String | 返回信息，成功时为"success"，失败时为具体错误信息 |
| data | Object | 业务数据，失败时为null |
| sign | String | 响应结果的签名 |