API 文档 · 易支付

快速开始

接入前准备

1. 注册商户并完成资质审核；2. 在商户中心获取 商户号 与 应用密钥；3. 配置 回调地址。

核心接口

POST/api/v1/pay/unifiedorder

统一下单：创建一笔支付订单，返回收银链接或预支付信息。

POST// 请求参数示例
{ "mch_id": "10086",
  "out_trade_no": "202609231530001",
  "subject": "会员充值",
  "amount": 86.00,
  "channel": "ALIPAY",
  "notify_url": "https://merchant.example.com/notify",
  "sign": "c4d6..." }

GET/api/v1/pay/query

查询订单状态：通过商户订单号查询支付结果与支付时间。

POST/api/v1/pay/refund

发起退款：支持全额或部分退款，异步通知退款结果。

POST/api/v1/transfer

商户转账：商户向指定账户发起转账（需另行开通权限）。

POST/api/v1/notify

支付结果回调：易支付向商户 notify_url 异步推送支付结果，商户需验签后返回 success。

签名示例（RSA2）

PHP// PHP 签名示例（其余语言详见 SDK 包）
function sign(array $params, string $privateKey): string {
    ksort($params); // 1. 按字典序排序
    $str = '';
    foreach ($params as $k => $v) {
        if ($v === '' || $k === 'sign') continue;
        $str .= $k . '=' . $v . '&';
    }
    $str = rtrim($str, '&'); // 2. 拼接待签名字符串
    openssl_sign($str, $sign, $privateKey, OPENSSL_ALGO_SHA256); // 3. SHA256 签名
    return base64_encode($sign); // 4. Base64 编码
}

统一下单公共参数

参数	类型	说明	必填
mch_id	String	商户号	是
out_trade_no	String	商户订单号（商户侧唯一）	是
subject	String	商品名称	是
amount	Decimal	支付金额（元）	是
channel	String	支付渠道：ALIPAY / WECHAT / UNIONPAY / QQ	是
notify_url	String	异步回调地址	是
sign	String	签名（RSA2）	是

提示：本页为 API 文档示例，接口地址与签名逻辑为演示说明，不连接真实服务端。完整 SDK 与沙箱环境请在真实对接时向平台获取。

开放 API 文档

接入前准备

核心接口

签名示例（RSA2）

统一下单公共参数