开放平台

退款状态查询

正式环境

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

POST

/v2/refund/query

应用场景
商家查询退款处理结果

请求参数

Query 参数

merchantCode

string

分配的商户Code

必需

sign

string

加签

必需

signType

string

加签类型固定MD5

必需

timestamp

string

请求时间

必需

charset

string

必需

字符类型固定UTF8

nonce

string

随机字符串

必需

outRefundNo

string

必需

调用退款接口传入的外部退款单号

refundNo

string

必需

调用退款接口返回的refundNo的值(outRefundNo、refundNo两者取其一填入即可)

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zuifuli.com/api/open/v2/refund/query?merchantCode=&sign=&signType=&timestamp=&charset=&nonce=&outRefundNo=&refundNo='

返回响应

🟢200成功

application/json

Body

code

string

必需

错误码	描述
0	响应正常
110001	参数不合法，一般是商户订单号,外部订单号或者支付流水号等未传
17202	未查询到该退款交易信息，最福利未成功接受退款请求
60003	验签错误

result

object

必需

refundNo

string

最福利退款流水号

必需

outRefundNo

string

外部退款单号

必需

tradeNo

string

最福利支付流水号

必需

outTradeNo

string

外部单号

必需

refundResult

string

必需

退款状态
32:退款中
78:退款成功

refundAmt

string

退款金额单位元

必需

refundTime

string

退款完成时间

可选

示例

{
    "code": "0",
    "result": {
        "refundNo": "",
        "outRefundNo": "",
        "tradeNo": "",
        "outTradeNo": "",
        "refundResult": "",
        "refundAmt": ""
    }
}

退款异步通知

跳转第三方订单详情页面