快速开始

欢迎使用 Jeepay 支付网关 API。本文档描述了代收（支付）、代付（转账）和退款相关的 API 接口，供第三方平台对接使用。

接入流程

通用请求参数

所有 API 请求均需包含以下公共参数：

通用响应格式

{
  "code": 0,        // 0=成功，其他=失败
  "msg": "SUCCESS",  // 状态描述
  "sign": "D6B...",  // 响应签名
  "data": { ... }    // 业务数据
}

签名算法

所有 API 请求和响应均需要进行签名验证，以确保数据安全。

签名示例

假设商户密钥为 abc123，请求参数如下：

mchNo=M1234567890
appId=app_001
mchOrderNo=ORDER_001
amount=10000
currency=PHP
wayCode=ALI_QR
subject=测试商品
body=商品描述
version=1.0
signType=MD5
reqTime=1708416000000

amount=10000&appId=app_001&body=商品描述¤cy=PHP&mchNo=M1234567890&mchOrderNo=ORDER_001&reqTime=1708416000000&signType=MD5&subject=测试商品&version=1.0&wayCode=ALI_QR&key=abc123

sign = MD5(拼接字符串).toUpperCase()
     = "A1B2C3D4E5F6..."

币种列表

当前支持的币种如下。请在请求中使用三位 ISO-4217 币种代码。

统一下单

商户通过该接口创建支付订单，获取支付链接或支付参数。

请求参数

响应参数

请求示例

{
  "mchNo": "M1234567890",
  "appId": "app_001",
  "mchOrderNo": "ORDER_20260220_001",
  "wayCode": "ALI_QR",
  "amount": 10000,
  "currency": "PHP",
  "subject": "充值100元",
  "body": "账户充值",
  "notifyUrl": "https://your-site.com/notify",
  "version": "1.0",
  "signType": "MD5",
  "reqTime": "1708416000000",
  "sign": "A1B2C3D4E5F6..."
}

响应示例

{
  "code": 0,
  "msg": "SUCCESS",
  "sign": "D6B7C8A9...",
  "data": {
    "payOrderId": "P1234567890",
    "mchOrderNo": "ORDER_20260220_001",
    "orderState": 1,
    "payDataType": "payUrl",
    "payData": "https://pay.example.com/cashier/xxx"
  }
}

查询订单

查询支付订单状态，支持通过商户订单号或系统订单号查询。

请求参数

响应参数

关闭订单

关闭未支付的订单，仅支持订单状态为"生成"或"支付中"的订单。

请求参数

支付回调通知

当支付成功后，系统将向商户配置的 notifyUrl 发送异步通知。

通知参数

发起转账

商户通过该接口发起代付（转账）请求，将资金转入指定账户。

请求参数

响应参数

查询转账

查询转账订单状态。

请求参数

转账回调通知

转账完成后，系统将向商户配置的 notifyUrl 地址发送异步通知。

通知参数

发起退款

商户通过该接口对已支付的订单发起退款。

请求参数

响应参数

查询退款

查询退款订单状态。

请求参数

退款回调通知

退款完成后，系统将向商户配置的 notifyUrl 地址发送异步通知。

通知参数

PayPH 兼容 API — 说明

兼容端点与原有 Jeepay API 并行运行，互不影响。下方为各端点说明。

PayPH 兼容 — 签名规则

签名算法与 PayPH 完全一致：

1. 将所有非空参数（不含 sign、不含 clientip、不含 attach）按参数名 ASCII 升序排列
2. 拼接为 key1=value1&key2=value2&...&key=YOUR_SECRET
3. 对拼接字符串计算 MD5，结果转为 小写

签名示例（PHP）

$params = [
    'parter'    => '699ac3a959be3e4c538a2034',
    'value'     => '100.00',
    'type'      => 'GcashWap',
    'orderid'   => 'T20260222001',
    'notifyurl' => 'https://your-site.com/callback',
];
ksort($params, SORT_FLAG_CASE | SORT_STRING);
$str = '';
foreach ($params as $k => $v) {
    if ($v !== '') $str .= "$k=$v&";
}
$str .= 'key=' . $secret;
$sign = md5($str); // 小写

发起代收 — POST /payment/create

请求参数

响应示例

{
    "code": 200,
    "info": "success",
    "param": {
        "payment_url": "https://pay.example.com/cashier/xxxx"
    }
}

代收查询 — POST /pay/query

请求参数

响应示例

{
    "code": "200",
    "state": "200",
    "msg": "支付成功",
    "price": "100.00"
}

state 值：100=处理中，200=支付成功，400=支付失败

发起代付 — POST /pay/transfer

请求参数

响应示例

{
    "code": "200",
    "info": "提交成功"
}

代付查询 — POST /pay/transfer/query

V2 详细版：POST /pay/transfer/query/detail

请求参数

V1 响应示例

{
    "code": "200",
    "info": "success",
    "param": {
        "status": 3,
        "price": "100.00"
    }
}

status 值：1=未处理，2=处理中，3=已支付，4=支付失败

V2 响应示例（detail）

{
    "code": 200,
    "info": "success",
    "param": {
        "status": 3,
        "price": "100.00",
        "fee": "0.00",
        "uporder": "CH20260222001",
        "completion_time": "2026-02-22 19:00:00"
    }
}

商户余额 — POST /payment/query/balance

请求参数

响应示例

{
    "code": 200,
    "info": "success",
    "param": {
        "balance": "5000.00"
    }
}

PayPH 兼容 — 回调通知

通过 PayPH 兼容接口创建的订单，回调通知也将采用 PayPH 格式：

代收回调参数

代付回调参数（额外增加 remark 字段）

回调签名验证

固定字段顺序：opstate={X}&orderid={X}&ovalue={X}&parter={X}&key={SECRET} → MD5 小写

错误码

以下为支付网关可能返回的错误码：