统一退款

POST

https://pay.cnyepay.com/api/refund/refundOrder

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

请求参数

Body 参数application/json

示例

{
    "mchNo": "M1755581016",
    "appId": "68a40a59e4b0bf61830a5687",
    "reqTime": "1622016572190",
    "version": "1.0",
    "sign": "Base64编码的RSA2签名字符串",
    "signType": "RSA2",
    "payOrderId": "PP1957679439693283330",
    "mchOrderNo": "P1957679439693283330",
    "mchRefundNo": "M27210632100491",
    "refundAmount": 100,
    "currency": "CNY",
    "refundReason": "用户退货",
    "clientIp": "175.0.227.20",
    "notifyUrl": "https://www.cnyepay.com/notify.htm",
    "channelExtra": "string",
    "extParam": "134586944573118714"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://pay.cnyepay.com/api/refund/refundOrder' \
--header 'Content-Type: application/json' \
--data-raw '{
    "mchNo": "M1755581016",
    "appId": "68a40a59e4b0bf61830a5687",
    "reqTime": "1622016572190",
    "version": "1.0",
    "sign": "Base64编码的RSA2签名字符串",
    "signType": "RSA2",
    "payOrderId": "PP1957679439693283330",
    "mchOrderNo": "P1957679439693283330",
    "mchRefundNo": "M27210632100491",
    "refundAmount": 100,
    "currency": "CNY",
    "refundReason": "用户退货",
    "clientIp": "175.0.227.20",
    "notifyUrl": "https://www.cnyepay.com/notify.htm",
    "channelExtra": "string",
    "extParam": "134586944573118714"
}'

返回响应

🟢200成功

application/json

成功响应

Body

示例

{
    "code": 0,
    "msg": "SUCCESS",
    "sign": "string",
    "data": {
        "refundOrderId": "string",
        "mchRefundNo": "string",
        "state": 0,
        "channelOrderNo": "string",
        "errCode": "string",
        "errMsg": "string"
    }
}

修改于 2025-10-27 11:44:42

查询提现详情

发起转账