开放平台

发起退款申请

正式环境

https://api.zuifuli.com/api/open

POST

/v2/refund/do

应用场景
商家发起退款申请,退款成功会有异步通知.

请求参数

Query 参数

merchantCode

string

分配的商户Code

必需

sign

string

加签

必需

signType

string

加签类型固定MD5

必需

timestamp

string

请求时间

必需

charset

string

必需

字符类型固定UTF8

nonce

string

随机字符串

必需

tradeNo

string

最福利支付流水

可选

outTradeNo

string

可选

商户订单号,tradeNo 和outTradeNo至少传一个

notifyUrl

string

必需

退款成功异步通知(商家提供)

refundAmt

string

必需

退款金额。单位:人民币元

refundReason

string

退款原因

必需

outRefundNo

string

必需

外部退款单号,幂等去重

extraInfo

string

可选

退款携带的额外参数信息，json 字符串

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zuifuli.com/api/open/v2/refund/do?merchantCode=&sign=&signType=&timestamp=&charset=&nonce=&tradeNo=&outTradeNo=&notifyUrl=&refundAmt=&refundReason=&outRefundNo=&extraInfo='

返回响应

🟢200成功

application/json

Body

code

string

必需

错误码	描述
110001	参数不合法，一般是金额,商户号,退款金额,签名信息,异步通知地址丢失
12006	验签失败
30003	正向交易订单不存在或正向交易订单未支付
30004	重复退款，意味着该退款单号已经退款过一次了。再次退款需要更改退款单号

result

object

必需

refundNo

string

最福利退款流水号

必需

示例

{
    "code": "0",
    "result": {
        "refundNo": "XXXXXXXX"
    }
}

🟠401没有权限

查询交易记录

退款异步通知