退款查询接口

接口名称

openapi.payment.order.refund.query

请求方式

POST

请求头

application/json; charset=utf-8

请求业务参数

参数 类型 是否必填 最大长度 描述
order_sn string 否 32 付呗订单号 [二选一必填]
merchant_order_sn string 否 32 第三方订单号 [二选一必填]
refund_sn string 否 32 付呗退款号
merchant_refund_sn string 否 32 第三方退款号[退款号二选一必填]
  • 请求示例:
{
  "biz_content": "{\"trade_no\":\"2017050310033901346103748870\",\"refund_sn\":\"20170503100603639901\"}",
  "method": "openapi.payment.order.refund.query",
  "format": "json",
  "sign_method": "md5",
  "sign": "8B70F450A9D94A1CDE070BB73F3A5768",
  "app_id": "20170224132045932173",
  "nonce": "pp2kiwi",
  "version": "1.0"
}

成功响应参数

参数 类型 是否必填 最大长度 描述
merchant_order_sn string 是 32 第三方订单号
merchant_refund_sn string 是 32 第三方退款号
order_sn string 是 32 付呗订单号
refund_sn string 是 32 付呗退款号
trade_no string 是 32 商户单号
refund_status string 是 32 退款状态,REFUND_PROCESSING退款中、REFUND_SUCCESS退款成功、REFUND_FAILER退款失败
refunder_name string 否 32 退款操作人员名称
refund_time int 否 10 发起退款的时间
refund_money float 否 10 订单退款金额
refund_fee float 是 10 退款手续费（精确到2位小数）
buyer_refund_money float 否 10 顾客实际退款金额
device_no string 否 32 硬件设备号
  • 响应示例:
{
  "result_message": "退款查询成功",
  "data": {
    "order_sn": "20170503100339519319",
    "merchant_order_sn": "201705031493777030425openapi",
    "refund_sn": "20170503100603639901",
    "merchant_refund_sn": "201705031493777175502openapi",
    "refund_status": "REFUND_SUCCESS",
    "trade_no": "2017050310033901346103748870",
    "refunder_name": "张三",
    "refund_time": 1234567890,
    "refund_money": 10,
    "buyer_refund_money": 9,
    "refund_fee": "1.11",
    "device_no": "sn2323277"
  },
  "result_code": 200
}

失败响应参数

参数 类型 是否必填 最大长度 描述
result_message string 是 32 付呗平台错误信息
result_code int 是 3 付呗错误码
sub_code string 否 不定 平台方错误码

results matching ""

    No results matching ""