退费接口

开发中

POST

/realpay/gateway

请求参数

Body 参数application/json

appId

string

appid

必需

appId (平台统一下发)

method

string

方法名

必需

rop.trade.refund

version

string

版本号

必需

charset

string

编码格式

必需

固定值 UTF-8

signType

string

签名code

必需

sign

string

签名

必需

bizContent

object

业务参数

必需

请求参数的集合，json字符串形式

orderNo

string

订单号

必需

商户订单号（支付时使用的orderNo）

batchNo

string

退款批次号

必需

一笔订单可多次退费每次需变更批次号

refundFee

string

退费金额

必需

1.23

tradeDesc

string

退费描述

必需

例：窗口退费

notifyUrl

string | null

回调地址

可选

无特殊需求可不传

operatorName

string | null

操作员

可选

小明

operatorCode

string | null

操作员code

可选

A0001

示例

{
    "appId": "tzzy2093901",
    "method": "rop.trade.refund",
    "version": "1.0",
    "charset": "UTF-8",
    "signType": "RSA",
    "sign": "O2BrQxGZLsuNt9NXNNFAzv10NlgABWavUjlEG/hLcf/Zoy20cTR+Aa3xwDu8Z9M5FfBKbw24NdfBmaQ0ZCHVZv0FvoWlNMhbZHlFtVyOWjMV0nT87ihPdWAedWs/JqGUMJVy/YTmyUzIxBrupKTDQvUZDYeEct+GgharMoCDHfg=",
    "bizContent": "{\"orderNo\":\"2305060936387225542297051003\",\"tradeNo\":\"\",\"batchNo\":\"123\",\"cancelSerialNo\":\"\",\"refundFee\":3.34,\"tradeDesc\":\"互联网医院退款\",\"notifyUrl\":\"\",\"recipeNos\":\"\",\"operatorName\":\"赵凯\",\"operatorCode\":\"921309\"}"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://test-cn.your-api-server.com/realpay/gateway' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "tzzy2093901",
    "method": "rop.trade.refund",
    "version": "1.0",
    "charset": "UTF-8",
    "signType": "RSA",
    "sign": "O2BrQxGZLsuNt9NXNNFAzv10NlgABWavUjlEG/hLcf/Zoy20cTR+Aa3xwDu8Z9M5FfBKbw24NdfBmaQ0ZCHVZv0FvoWlNMhbZHlFtVyOWjMV0nT87ihPdWAedWs/JqGUMJVy/YTmyUzIxBrupKTDQvUZDYeEct+GgharMoCDHfg=",
    "bizContent": "{\"orderNo\":\"2305060936387225542297051003\",\"tradeNo\":\"\",\"batchNo\":\"123\",\"cancelSerialNo\":\"\",\"refundFee\":3.34,\"tradeDesc\":\"互联网医院退款\",\"notifyUrl\":\"\",\"recipeNos\":\"\",\"operatorName\":\"赵凯\",\"operatorCode\":\"921309\"}"
}'

返回响应

🟢200成功

application/json

Body

charset

string

固定

必需

UTF-8

data

object

业务参数

必需

code

string

退款结果code

必需

SUCCESS和ACCEPTSUCCESS均代表成功，其余都为失败code

msg

string

退费描述

必需

成功

outRefundNo

string

退费订单号

必需

tradeNo

string

交易流水号

必需

msgCode

string

接口成功code

必需

例：0 非0data会为空

sign

string

签名

必需

signType

string

签名code

必需

RSA

示例

{
    "charset": "UTF-8",
    "data": {
        "code": "ACCEPTSUCCESS",
        "msg": "OK",
        "outRefundNo": "50300005942023060235204855780",
        "tradeNo": "4200059249202306013551003069"
    },
    "msgCode": "0",
    "sign": "XPFYho6RZRLRPJs4NOArOD90MEz49wa6zkruHrfDN5mpgVuvroGLAlaX+F6P8GDSFbYFtAiY9Ad4RBX4lXpZWnPbigD7NXWWJjQmxyD/37lnEb0bhdfA8NsOgpwmtentnFmu53GLSNBJFdj76YQoSulJmocbLE1kDo94zofsA9w=",
    "signType": "RSA"
}

修改于 2023-06-02 07:24:45

退费查询接口

撤销接口