查询退款接口 - 星富通科技有限公司

功能说明

根据商户编码和退款流水号查询退款单的处理结果，包括退款状态、退款金额、渠道与平台退款流水号等信息。

请求地址

POST /v1/aggregate/payment/charge/refund/get

请求参数

字段	类型	必填	说明
`merchant_code`	string	是	商户编码
`refund_trade_no`	string	是	退款流水号（商户退款单号）

请求示例

{
  "merchant_code": "226801000000865319122",
  "refund_trade_no": "R20231025152300001"
}

响应参数

字段	类型	说明
`trade_state`	string	退款状态，详见 TradeState 枚举
`failure_code`	string	失败码
`failure_msg`	string	失败信息
`trade_no`	string	渠道退款流水号
`platform_trade_no`	string	平台退款流水号
`amount`	object	退款金额，详见下方 Amount 说明
`succeeded_at`	string	退款成功时间，格式：`yyyyMMddHHmmss`；示例值：`20220912111230`

Amount 对象

字段	类型	说明
`total`	int	订单总金额，单位：分
`payer_total`	int	用户支付金额，单位：分（使用优惠券的情况下，等于总金额减优惠券金额）
`currency`	string	订单金额货币类型；`CNY`：人民币，境内商户号仅支持人民币
`payer_currency`	string	用户支付货币类型

响应示例

{
  "trade_state": "00",
  "failure_code": "",
  "failure_msg": "",
  "trade_no": "50300807092023102512345678901",
  "platform_trade_no": "20231025152300000002",
  "amount": {
    "total": 100,
    "payer_total": 100,
    "currency": "CNY",
    "payer_currency": "CNY"
  },
  "succeeded_at": "20231025152300"
}