🐱 秒切支付 API 接口文档

📋 协议规则

传输方式

参数规范

交易金额

默认为人民币交易，单位为分，参数值不能带小数。

时间参数

所有涉及时间参数均使用精确到毫秒的13位数值，如：1622016572190。时间戳具体是指从格林尼治时间1970年01月01日00时00分00秒起至现在的毫秒数。

🔐 签名算法

签名生成的通用步骤如下：

第一步

设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名进行不区分大小写的自然排序，使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。

第二步

在stringA最后拼接上key[即 StringA +"&key=" + 私钥 ] 得到stringSignTemp字符串，并对stringSignTemp进行MD5运算，再将得到的字符串所有字符转换为大写，得到sign值signValue。

签名示例

如请求支付系统参数如下：

Map<String, Object> paramsMap = new HashMap<>();
paramsMap.put("mchNo", "M1682391685");                   // 商户号
paramsMap.put("appId", "6447428682ca7458118af79f");      // 应用ID
paramsMap.put("mchOrderNo", "mho1694051705945");         // 商户订单号
paramsMap.put("wayCode", "ALI_BAR");                     // 支付方式
paramsMap.put("amount", 1L);                             // 金额，单位分
paramsMap.put("currency", "CNY");                        // 币种，目前只支持cny
paramsMap.put("clientIp", "192.166.1.132");              // 发起支付请求客户端的IP地址
paramsMap.put("subject", "商品标题");                     // 商品标题
paramsMap.put("body", "商品描述");                        // 商品描述
paramsMap.put("notifyUrl", "https://miaoqie.com");   // 异步通知地址
paramsMap.put("reqTime", "1694051706");   			   // 请求时间
paramsMap.put("version", "1.0");   				 	// 接口版本号，固定：1.0
paramsMap.put("signType", "MD5");   				// 签名类型
paramsMap.put("channelExtra", "{\"authCode\":\"284957415846666792\"}");  // 渠道参数
            

待签名值

amount=1&appId=6447428682ca7458118af79f&body=商品描述&channelExtra={"authCode":"284957415846666792"}&clientIp=192.166.1.132¤cy=CNY&mchNo=M1682391685&mchOrderNo=mho1694051705945¬ifyUrl=https://miaoqie.com&reqTime=1694051706&signType=MD5&subject=商品标题&version=1.0&wayCode=ALI_BAR&key=UNpEETkvMpqC9oDLBr9S2X7U92k462h3zhHiy7hj4xbw23PiWhMv6TCAQ2vh8PzynZXZYo9n6puxHkAHG7li6LZi8IpaQrshzydnBll64iKlb4U59ggiyCTaHJeqffiW
            

签名结果

924065BA077FA461A9B06D2E76E9ED3C
            

最终请求支付系统参数

{"amount":1,"mchOrderNo":"mho1694051705945","subject":"商品标题","wayCode":"ALI_BAR","sign":"924065BA077FA461A9B06D2E76E9ED3C","reqTime":"1694051706","body":"商品描述","version":"1.0","channelExtra":"{\"authCode\":\"284957415846666792\"}","appId":"6447428682ca7458118af79f","clientIp":"192.166.1.132","notifyUrl":"https://miaoqie.com","signType":"MD5","currency":"CNY","mchNo":"M1682391685"}
            

📊响应结构

{
  "code": 0,
  "data": {
    ""
  },
  "msg": "SUCCESS",
  "sign": "F4DA202C516D1F33A12F1E547C5004FD"
}
        

返回码

💳 统一支付下单

功能描述

商户通过该接口发起支付订单，支付网关会返回支付参数或支付链接。

接口说明

请求参数

响应参数

请求响应示例数据

{
    "msg":"SUCCESS", 
    "code":0, 
    "data":{
        "payOrderId":"P2000109004570791938", 
        "mchOrderNo":"SN2512131453004600020",
        "payData":"{\"appId\":\"wxebbfb0c332a6888\",\"miniProgramOrgId\":\"gh_9457a12c4443\",\"miniProgramPath\":\"pages/fromAppPay/index\",\"orderId\":\"P2000109004570791938\",\"prePayTn\":\"pages/fromAppPay/index?state=40b7076d-4654-4121-9ea7-db0477293f8d&customerNo=10093333333&goodsName=测试产品&customerRequestNo=P2000109004570791938&orderAmount=0.01&launchSource=MINI_PROGRAM\",\"uniqueOrderNo\":\"301320251214000000303714015306\"}", 
        "payDataType":"wxapp", 
        "orderState":1
    },
    "sign":"3CA9B6690E3DDD5E27826A75A8F2F12A"
}

            

支付方式

channelExtra参数说明

当 wayCode=ALI_JSAPI 时，channelExtra必须传buyerUserId，为支付宝用户ID，channelExtra示例数据如：

{"buyerUserId":"2088102168611111"}

当 wayCode=WX_JSAPI 或 wayCode=WX_LITE 时，channelExtra必须传openid，channelExtra示例数据如：

{"openid": "o6BcIwvSiRpfS8e_UyfQNrYuk2LI"}

🔍 查询支付订单

功能描述

商户通过该接口查询支付订单，支付网关会返回订单最新的数据。

接口说明

请求参数

响应参数

🔔 支付结果通知

功能描述

当订单支付成功时，支付网关会向商户系统发起回调通知。如果商户系统没有正确返回，支付网关会延迟再次通知。

接口说明

通知参数

通知示例数据

{
    "amount": 5,
    "body": "商品描述",
    "clientIp": "192.166.1.132",
    "createdAt": "1622016572190",
    "currency": "cny",
    "extParam": "",
    "ifCode": "yeepay",
    "mchNo": "M1621873433953",
    "appId": "60cc09bce4b0f1c0b83761c9",
    "mchOrderNo": "mho1621934803068",
    "payOrderId": "20210525172643357010",
    "state": 3,
    "subject": "商品标题",
    "wayCode": "WX_H5",
    "sign": "C380BEC2BFD727A4B6845133519F3AD6",
    "channelTrxId": "20210525172643357010",
    "channelUser": "13000000000",
}
            

返回结果

业务系统处理后同步返回给支付中心，返回字符串 success 则表示成功，返回非 success 则表示处理失败，支付中心会再次通知业务系统。

🔒 关闭支付订单

功能描述

商户通过该接口关闭订单，支付网关会对订单完成关闭处理。

接口说明

请求参数

请求示例数据

{
  "payOrderId": "P202106181104177050002",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "sign": "46940C58B2F3AE426B77A297ABF4D31E",
  "signType": "MD5",
  "reqTime": "1624006009",
  "mchNo": "M1623984572",
  "version": "1.0"
}
            

响应参数

💰 发起支付退款

功能描述

商户业务系统通过统一退款接口发起退款请求，支付网关会根据商户发起的支付订单号，找到对应到支付通道发起退款。

接口说明

请求参数

请求示例数据

{
  "payOrderId": "P202106181104177050002",
  "extParam": "",
  "mchOrderNo": "",
  "refundReason": "退款测试",
  "sign": "2762CDB48D5179281DB6C0995E4EEDE0",
  "reqTime": "1624007315",
  "version": "1.0",
  "channelExtra": "",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "mchRefundNo": "mho1624007315478",
  "clientIp": "192.166.1.132",
  "notifyUrl": "https://www.mqiepay.com",
  "refundAmount": 1,
  "signType": "MD5",
  "currency": "CNY",
  "mchNo": "M1623984572"
}
            

响应参数

🔍 查询退款订单

功能描述

商户通过该接口查询退款订单，支付网关会返回订单最新的数据。

接口说明

请求参数

请求示例数据

{
  "refundOrderId": "P202106181105527690009",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "sign": "1484293FCAEAFE11DEC8949DB6B525A9",
  "signType": "MD5",
  "reqTime": "1624008199",
  "mchNo": "M1623984572",
  "version": "1.0"
}
            

响应参数

🔔 退款结果通知

功能描述

当退款完成时(成功或失败)，支付网关会向商户系统发起回调通知。如果商户系统没有正确返回，支付网关会延迟再次通知。

接口说明

通知参数

通知示例数据

{
    "appId": "60cc09bce4b0f1c0b83761c9",
    "channelOrderNo": "2021061822001423031419593035",
    "createdAt": 1623985552769,
    "currency": "cny",
    "extParam": "",
    "mchNo": "M1623984572",
    "mchRefundNo": "mho1623985552430",
    "payAmount": 58,
    "payOrderId": "P202106181104177050002",
    "refundAmount": 4,
    "refundOrderId": "P202106181105527690009",
    "reqTime": "1623985553",
    "sign": "594B2F92F8B4C4A9C5A8A9F4F8B4C4A9",
    "state": 2,
    "successTime": 1623985553000
}
            

返回结果

业务系统处理后同步返回给支付中心，返回字符串 success 则表示成功，返回非 success 则表示处理失败，支付中心会再次通知业务系统。

💰 聚合支付预支付

功能描述

⚠ 仅1.0版本适用。

商户通过该接口发起聚合支付预支付订单，支持多种支付方式的统一预处理。

接口说明

请求参数

请求示例数据

{
  "mchNo": "M1621873433953",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "orderId": "PAY202401010001",
  "openId": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
  "payWay": "WECHAT_OFFIACCOUNT",
  "channel": "WECHAT",
  "scene": "ONLINE",
  "chAppId": "wx*******",
  "reqTime": 1622016572190,
  "version": "1.0",
  "sign": "C380BEC2BFD727A4B6845133519F3AD6",
  "signType": "MD5"
}
            

返回参数

🏦 聚合支付托管支付

功能描述

⚠ 仅1.0版本适用。

商户通过该接口发起聚合支付托管支付订单，支持资金托管和分账功能。

接口说明

请求参数

请求示例数据

{
  "mchNo": "M1621873433953",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "orderId": "PAY202401010002",
  "payWay": "MINI_PROGRAM",
  "channel": "WECHAT",
  "scene": "ONLINE",
  "reqTime": 1622016572190,
  "version": "1.0",
  "sign": "C380BEC2BFD727A4B6845133519F3AD6",
  "signType": "MD5"
}
            

返回参数

接口特色

👤 获取渠道用户ID

功能描述

商户通过该接口获取渠道的用户ID，如微信的openID，支付宝的userId。该接口通过跳转获取到用户ID后，会跳转到商户上传的redirectUrl地址，并传递用户ID参数。

接口说明

请求参数

请求示例数据

{
  "mchNo": "M1621873433953",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "ifCode": "yeepay",
  "redirectUrl": "https://www.mqiepay.com",
  "sign": "A5C93D50743126ED91AA6ED96CDEEEF8",
  "signType": "MD5",
  "reqTime": "1622011236571",
  "version": "1.0"
}
            

返回参数

当获取到渠道用户ID后，会301重定向到跳转地址，传递参数如下：

💸 发起转账订单

功能描述

商户通过该接口发起转账订单，支持微信和支付宝转账。

接口说明

请求参数

请求示例数据

{
  "ifCode": "yeepay",
  "entryType": "YEEPAY_CASH",
  "amount": 1,
  "accountName": "",
  "mchOrderNo": "mho1629106169045",
  "sign": "3EB5A3B81E92DB41677E235363E7DDE3",
  "transferDesc": "测试转账",
  "reqTime": "1629106169",
  "version": "1.0",
  "appId": "60cc3ba74ee0e6685f57eb1e",
  "accountNo": "a6BcIwtTvIqv1zXZohc61biryWok",
  "clientIp": "192.166.1.132",
  "signType": "MD5",
  "currency": "CNY",
  "mchNo": "M1623997351"
}
            

🔍 查询转账订单

功能描述

商户通过该接口查询转账订单，支付网关会返回订单最新的数据。

接口说明

请求参数

返回示例数据

{
    "code": 0,
    "data": {
        "accountNo": "o6BcIwvTvIqf1zXZohc61biryWik",
        "amount": 1,
        "appId": "6113805e42020495c62bd4cb",
        "createdAt": 1628818820011,
        "currency": "CNY",
        "entryType": "YEEPAY_CASH",
        "errCode": "OPENID_ERROR",
        "errMsg": "openid与商户appid不匹配【openid与商户appid不匹配】",
        "ifCode": "yeepay",
        "mchNo": "M1623997351",
        "mchOrderNo": "1628818820",
        "state": 3,
        "transferDesc": "测试",
        "transferId": "T202108130940200100001"
    },
    "msg": "SUCCESS",
    "sign": "A262DBD3D6182E8A0AEC90EF820F2A5A"
}
            

🔔 转账结果通知

功能描述

当转账完成时(成功或失败)，支付网关会向商户系统发起回调通知。如果商户系统没有正确返回，支付网关会延迟再次通知。

接口说明

通知参数

通知示例数据

{
    "accountNo": "o6BcIwvTvIqf1zXZohc61biryWik",
    "amount": 1,
    "appId": "6113805e42020495c62bd4cb",
    "createdAt": 1628818820011,
    "currency": "CNY",
    "entryType": "WX_CASH",
    "errCode": "OPENID_ERROR",
    "errMsg": "openid与商户appid不匹配【openid与商户appid不匹配】",
    "ifCode": "wxpay",
    "mchNo": "M1623997351",
    "mchOrderNo": "1628818820",
    "state": 3,
    "transferDesc": "测试",
    "transferId": "T202108130940200100001"
}
            

返回结果

业务系统处理后同步返回给支付中心，返回字符串 success 则表示成功，返回非 success 则表示处理失败，支付中心会再次通知业务系统。（通知频率为0/30/60/90/120/150,单位：秒）