接口说明及规范

本文档为支付接口开发文档，适用于商户系统集成支付接口。

协议规则

项目 说明
提交数据格式 application/x-www-form-urlencoded
返回数据格式 JSON
字符编码 UTF-8
签名算法 SHA256WithRSA

V2升级说明

重要变更

  1. V2接口全面使用 RSA 签名算法；V1接口使用 MD5 签名算法
  2. V2接口改用全新的接口地址，支持退款、代付等功能；V1接口使用submit.php和mapi.php提交订单
  3. 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 响应结果的签名