退款查询

请求参数

Query 参数

merchantNo

string

收款商户编号

必需

refundRequestId

string

商户退款请求号

必需

orderId

string

必需

商户收款请求号，原支付订单的商户订单号

uniqueOrderNo

string

可选

易宝收款订单号，收款交易对应在易宝的单号

Header 参数

ti-appid

string

必需

天河链开放平台商户Id

示例值:

tichain000000

ti-timestamp

string

必需

时间戳，1970年1月1日0点0分0秒到现在的毫秒数

示例值:

1647751123703

ti-signature

string

必需

API 签名：SHA256(ParamsJson+Timestamp+AppKey)

示例值:

644dbdb0137f1f3add30eca4c9e582da5c6e45d77fea51ab76fbd10ef3442f6b

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://api.tipay.tianhecloud.com/api/v1/yb/trade/query?merchantNo=&refundRequestId=&orderId=' \
--header 'ti-appid: tichain000000' \
--header 'ti-timestamp: 1647751123703' \
--header 'ti-signature: 644dbdb0137f1f3add30eca4c9e582da5c6e45d77fea51ab76fbd10ef3442f6b'

返回响应

🟢200成功

application/json

Body

code

integer

必需

success

boolean

必需

data

object

必需

merchantNo

string

商户编号

必需

orderId

string

订单编号

必需

商户侧订单编号

refundRequestId

string

商户退款请求号

必需

uniqueOrderNo

string

易宝收款订单号

必需

uniqueRefundNo

string

易宝退款订单号

必需

refundAmount

string

退款申请金额

必需

单位:元示例值：12.92

returnMerchantFee

string

退回商户手续费金额

必需

单位:元示例值：1.12

status

string

退款状态

必需

PROCESSING：退款处理中 SUCCESS：退款成功 FAILED：退款失败示例值：SUCCESS

description

string

退款原因

必需

refundRequestDate

string

退款受理时间

必需

示例值：2021-01-01 00:00:00

refundSuccessDate

string

退款成功时间

必需

示例值：2021-01-01 00:00:00

failReason

string

退款失败原因

必需

realRefundAmount

string

实际退款金额

必需

cashRefundFee

string

用户实退金额

必需

示例值：1.23

refundAccountDetail

string

退款资金来源信息

必需

channelReceiverInfo

string

退款入账信息

必需

msg

string

必需

示例

{
    "code": 200,
    "success": true,
    "data": {
        "code": "OPR00000",
        "message": "成功",
        "merchantNo": "1008xxxxxxx",
        "orderId": "bda4e84ef8ee427b830d869d7a6bfd71",
        "refundRequestId": "1b118148eaf54b09a213adcb332d7a19",
        "uniqueOrderNo": "1013202301300000005245245059",
        "uniqueRefundNo": "1002202301300000005245434665",
        "refundAmount": "0.01",
        "returnMerchantFee": "0.00",
        "status": "SUCCESS",
        "description": "用户申请退货并退款",
        "refundRequestDate": "2023-01-30 17:08:14",
        "refundSuccessDate": "2023-01-30 17:08:15",
        "failReason": "",
        "realRefundAmount": "0.01",
        "cashRefundFee": "0.01",
        "refundAccountDetail": "[{\"accountType\":\"SETTLE_ACCOUNT\",\"debitAmount\":0.01}]",
        "channelReceiverInfo": ""
    },
    "msg": "操作成功"
}

接口描述

使用说明

请求参数

示例代码

返回响应

退款查询

接口描述#

使用说明#

请求参数

示例代码

返回响应

接口描述

使用说明