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

订单退款

POST
https://pay.cnyepay.com/api/v2/refund/refundOrder
商户业务系统通过统一退款接口发起退款请求,粤收付支付网关会根据商户发起的支付订单号,找到对应到支付通道发起退款。本接口为统一退款接口,不论哪种支付类型都适用当前接口进行退款操作。

请求参数

Body 参数application/json必填

示例
{
    "orgNo": "88281790564172",
    "mchNo": "88281790564172",
    "sign": "Base64编码的RSA2签名字符串",
    "mchOrderNo": "M1958086561207775233",
    "payOrderId": "P21051801528067686405",
    "mchRefundNo": "21051801528067686405",
    "refundAmount": 5000,
    "refundReason": "退款原因...",
    "orderDate": "2026-09-30"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://pay.cnyepay.com/api/v2/refund/refundOrder' \
--header 'Content-Type: application/json' \
--data '{
    "orgNo": "88281790564172",
    "mchNo": "88281790564172",
    "sign": "Base64编码的RSA2签名字符串",
    "mchOrderNo": "M1958086561207775233",
    "payOrderId": "P21051801528067686405",
    "mchRefundNo": "21051801528067686405",
    "refundAmount": 5000,
    "refundReason": "退款原因...",
    "orderDate": "2026-09-30"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 0,
    "msg": "SUCCESS",
    "sign": "string",
    "data": {
        "refundOrderId": "string",
        "mchRefundNo": "string",
        "payAmount": 9000,
        "refundAmount": 2000,
        "state": 0,
        "channelBatchNo": "string",
        "errCode": "string",
        "errMsg": "string"
    }
}
修改于 2026-10-24 04:55:51
上一页
查询支付订单
下一页
查询退款订单
Built with