易支付 · 接口说明及规范

协议规则

获取 RSA 密钥对

登录商户中心 → API 信息 → 点击【生成商户 RSA 密钥对】。 私钥只显示一次，对接时只用商户私钥签名与平台公钥验签。

签名规则

签名步骤

1. 取请求报文所有非空参数，剔除 sign、sign_type，按键名 ASCII 码升序排序。
2. 拼接为 k1=v1&k2=v2 形式，得到待签名字符串。
3. 用商户私钥对该字符串做 SHA256WithRSA 签名，Base64 编码得到 sign。

验签步骤

1. 按上述 1~2 步得到待签名字符串。
2. 用平台公钥对 sign 做 SHA256WithRSA 验签。

PHP 示例

function epay_sign(array $params, string $privateKey): string {
    unset($params['sign'], $params['sign_type']);
    $params = array_filter($params, fn($v) => $v !== '' && $v !== null);
    ksort($params, SORT_STRING);
    $str = urldecode(http_build_query($params));
    openssl_sign($str, $sign, $privateKey, OPENSSL_ALGO_SHA256);
    return base64_encode($sign);
}

平台公钥

-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAvXslqtr8QH/6jw06m9gI
votIXkHonRPD4ujCZuzS7yiKEvYq03DDDGXeVMZPTP6Ny66v4sG514ps3Hw0441s
SYB1DAmR9eUz8nTOmGANOXsmgcu9KvIKKY7e4O8uxvUxXVQuHq50m93WXtUsMwtM
FIBW0wPpCfREJQEdwidJ+/Xk9za0Oe9sFVihkLtDab8L/dSylbpLL/8UbZp44rUs
eUSQH5vekfu7MrhnDmGYjXrihsvloJaYjDrlVwnrHkqrXAL38/L5iZzt1fj/nEcj
hcqQ7IRkOPrOw7fGyuqqjBvI2uadD/bxFT5hoX7lrWmohoIfPez2V6ghaWpJNmPS
UwIDAQAB
-----END PUBLIC KEY-----

支付方式列表

实际可用方式以商户所属用户组启用的支付方式为准。

页面跳转支付 POST / GET

请求地址：https://shanhe.site/api/pay/submit

用于用户前台直接发起支付，可用 form 表单跳转或拼接 URL 跳转。

统一下单 POST

请求地址：https://shanhe.site/api/pay/create

服务器后端调用，返回支付链接与二维码内容。

返回参数

{
  "code": 0,
  "msg": "success",
  "trade_no": "20261108123456789012",
  "out_trade_no": "ORDER1730000000",
  "payurl": "https://shanhe.site/pay.php?trade_no=20261108123456789012",
  "qrcode": "https://shanhe.site/pay.php?trade_no=20261108123456789012",
  "timestamp": "1721206072",
  "sign": "Base64...",
  "sign_type": "RSA"
}

订单查询 POST

请求地址：https://shanhe.site/api/pay/query

返回参数

订单退款 POST

请求地址：https://shanhe.site/api/pay/refund

返回参数

退款查询 POST

请求地址：https://shanhe.site/api/pay/refundquery

参数同订单查询，返回 money、refundmoney、status。

关闭订单 POST

请求地址：https://shanhe.site/api/pay/close

参数：pid、trade_no 或 out_trade_no、timestamp、sign、sign_type。 已支付订单不可关闭。

支付结果通知

通知类型：服务器异步通知（notify_url）、页面跳转通知（return_url），请求方式 GET。

查询商户信息 POST

请求地址：https://shanhe.site/api/merchant/info

参数：pid、timestamp、sign、sign_type。

查询订单列表 POST

请求地址：https://shanhe.site/api/merchant/orders

返回 data 数组，元素结构同订单查询。

提交代付 POST

请求地址：https://shanhe.site/api/transfer/submit

代付查询 POST

请求地址：https://shanhe.site/api/transfer/query

参数：pid、trade_no 或 out_trade_no、timestamp、sign、sign_type。 返回 status：0 处理中，1 成功，2 失败。

余额查询 POST

请求地址：https://shanhe.site/api/transfer/balance

返回 money（可用余额）、freeze_money（冻结金额）、settle_status。

枚举值

支付状态

结算方式

设备类型

接口类型（method）