1. 1.接口规范
粤收付开发平台2.0
  • 1.接口规范
    • 1.1 加签验签说明
  • 2.商户进件类接口(待开放)
    • 2.1收单商户
    • 2.2用户
    • 2.3AT配置
    • 2.4交易限额
  • 3.支付交易接口
    • 3.1支付
      • 微信支付
      • 支付宝支付
      • 银联二维码支付
      • 收银台预下单
      • 订单关单
      • 查询支付订单
    • 3.2退款
      • 订单退款
      • 查询退款订单
    • 3.3获取授权/UID
      • 获取渠道用户ID
  • 4.分账类接口
    • 4.1订单分账
      • 请求分账
      • 查询分账
      • 发起分账回退
      • 分账回退查询
    • 4.2余额分账
      • 请求余额分账
      • 查询余额分账
      • 发起余额分账回退
      • 查询余额分账回退
  • 5.代付转账接口
    • 请求代付转账
      POST
    • 查询代付转账
      POST
  • 6.外部设备类接口
    • 6.1扫码POS
      • 公共参数&签名
      • 获取设备参数
      • 设备初始化
      • 设备支付
      • 支付查询
      • 发起退款
      • 退款查询
      • 汇总查询
      • 交易记录查询
  • 7.数据查询类接口(待开放)
  • 8.账务类接口(待开放)
    • 8.1结算提现
    • 8.2对账单
  1. 1.接口规范

1.1 加签验签说明

协议规则#

传输方式:采用HTTPS传输
提交方式:POST 或 GET
内容类型:json
字符编码:UTF-8
签名算法:RSA2

参数规范#

交易金额:默认为人民币交易,单位为分,参数值不能带小数。

RSA2签名算法#

签名生成的通用步骤如下

第一步:参数处理#

所有发送或接收到的JSON数据为集合M,将集合M内非空参数值的参数按参数名ASCII码从小到大排序(字典序),再拼接URL键值对格式(即key1=value1&key2=value2…)得到待签名字串stringA
(其中请求参数sign并不参与签名)。
特别注意以下重要规则:
◆ 参数名ASCII码从小到大排序(字典序);
◆ 如果参数的值为空不参与签名;
◆ 参数名区分大小写;
◆ 验证调用返回或支付中心主动通知签名时,传送的sign参数不参与签名,将生成的签名与该sign值作校验。
◆ 支付中心接口可能增加字段,验证签名时必须支持增加的扩展字段
◆ 注意:RSA2签名时,拼接的字符串末尾不需要添加API密钥,直接对stringA进行签名即可

第二步:RSA2签名#

使用商户的RSA私钥,对stringA进行SHA256withRSA签名,签名结果转换为Base64编码字符串,得到最终的签名值signValue。

签名示例#

1. 请求参数示例#

2. 待签名字符串(注意末尾不加key)#

alipayData={"buyerUserId":"2088712176695639"}&amount=1&body=V2支付宝支付下单测试&clientIp=175.0.227.20&expiredTime=36000&mchNo=88281790564172&mchOrderNo=M1791445631454936518&notifyUrl=https://www.cnyepay.com/notify.htm&orderDate=2026-10-08&orgNo=88281790564172&returnUrl=https://www.cnyepay.com/return.htm&subject=V2支付宝支付下单测试&wayCode=A_JSAPI

3. RSA2签名流程#

4. 签名结果示例(Base64编码)#

Za7ySHMLvXC5DqHhC3J8I1gxlxNXLWUnJ4RFxF2qW54BoDoHRC+oTHqDzi7dRHO3k/a9KXcc7ehT0+IWlZOZuzAIvyT7mpulheATVVgetPSEHkmU6Y16xmsvpsPZ2Y7HcyBksDTcJG2fzpHjfqs622XMlRE8ziTVPusb8uYZ1yUmFFHp8bFy9zL+/bX4tidfSCtopK0WzUXlpmF/MS6yHZN8O4H7BYdeE7jzBvkQbz0ZROOjDOvIu2/ccp2geYdfYLMvFoud45c+81+H0T4frj8n8bHQgv6GjvBdbl2YNx1FDCv69D92K2XFbtJjxckvKVoyIE03i1ge2KqWmUhycA==

5. 最终请求参数#

{
        "amount": 1,
        "alipayData": {
                "buyerUserId": "2088712176695639"
        },
        "mchOrderNo": "M1791445631454936518",
        "subject": "V2支付宝支付下单测试",
        "wayCode": "A_JSAPI",
        "sign": "Za7ySHMLvXC5DqHhC3J8I1gxlxNXLWUnJ4RFxF2qW54BoDoHRC+oTHqDzi7dRHO3k/a9KXcc7ehT0+IWlZOZuzAIvyT7mpulheATVVgetPSEHkmU6Y16xmsvpsPZ2Y7HcyBksDTcJG2fzpHjfqs622XMlRE8ziTVPusb8uYZ1yUmFFHp8bFy9zL+/bX4tidfSCtopK0WzUXlpmF/MS6yHZN8O4H7BYdeE7jzBvkQbz0ZROOjDOvIu2/ccp2geYdfYLMvFoud45c+81+H0T4frj8n8bHQgv6GjvBdbl2YNx1FDCv69D92K2XFbtJjxckvKVoyIE03i1ge2KqWmUhycA==",
        "body": "V2支付宝支付下单测试",
        "expiredTime": 36000,
        "orgNo": "M1762500968",
        "appId": "6a83ed2cd1b2eb47b09765d9",
        "clientIp": "175.0.227.20",
        "notifyUrl": "https://www.cnyepay.com/notify.htm",
        "currency": "CNY",
        "returnUrl": "https://www.cnyepay.com/return.htm",
        "mchNo": "M1762500968",
        "orderDate": "2026-10-08"
}

RSA密钥管理#

密钥生成#

建议使用【支付宝开发者工具】生成密钥对

密钥格式#

私钥格式:支持PKCS#8(PRIVATE KEY)格式
公钥格式:标准公钥格式(PUBLIC KEY)
密钥长度:建议使用2048位或以上

密钥配置#

商户私钥:用于生成签名,必须妥善保管,不可泄露
商户公钥:提供给粤收付,用于验证商户签名
粤收付公钥:粤收付提供,用于验证平台返回数据的签名

签名验证#

验证平台返回数据#

当收到支付网关返回的数据时,需要使用平台公钥验证签名:

注意事项#

1.
字符编码:所有参数必须使用UTF-8编码
2.
大小写敏感:参数名和参数值都区分大小写
3.
签名编码:RSA2签名结果必须使用Base64编码
4.
密钥安全:私钥必须安全保管,建议定期更换
5.
空值处理:参数值为null、undefined或空字符串时不参与签名

常见问题#

Q1: RSA2签名失败#

检查私钥格式是否正确(PKCS#8)
确认私钥是否完整,包含头尾标识
验证待签名字符串是否正确拼接

Q2: 签名验证失败#

确认公私钥是否匹配
检查签名字符串拼接规则是否一致
确认签名结果是否正确进行了Base64编码

Q3: 参数排序问题#

必须严格按照ASCII码从小到大排序
使用编程语言的标准排序函数即可
商户完成入网后需要使用管理员邮箱向粤收付发送邮件,邮件内附商户RSA公钥、商户号、商户名称、商户应用ID等信息用于配置,若同步发送了商户RSA私钥将不予配置,且需要更换RSA密钥再次发送新的邮件才予以配置;
粤收付平台公钥请于粤收付商户后台获取用于回调验签;
若商户需要变更商户公钥信息需将新的商户信息、公钥、盖章版密钥变更书给予粤收付方可操作变更。
修改于 2026-10-08 08:44:01
下一页
微信支付
Built with