跳到主要内容

查询订单信息

付款码支付, 调用成功后, 调用该获取支付订单信息

请求地址

/api/v2/cashier/query

公共请求参数

接口协议 - 公共参数

请求参数

参数必填类型说明
pay_no特殊选填String(64)支付订单号, 选一, 建议使用该字段进行查询,
out_trade_no特殊选填String(64)外部系统订单号,选一, 如果第三方使用同一个out_trade_no 发起多笔订单, 只会返回最新一笔
is_freshBoolean此查询是否强制查询支付渠道并刷新订单状态,true:刷新,false:不刷新,默认为false。

响应参数

名称类型说明
pay_noString支付订单号
paymentString支付方式, 例:微信支付
payment_typeString支付方式, 枚举 WXPAY:微信支付, BALANCE: 余额支付, ALIPAY:支付宝支付
statusString支付状态, PAYED_SUCC:成功, PAYING: 支付中, PAYED_REVERSAL: 已撤销, PAYED_FAIL:失败, CANCEL:已取消, TIMEOUT:已超时, UNKNOW: 未知
status_nameString支付状态名称, 例:支付成功
attachString附加信息,原样返回
以下字段在status=PAYED_SUCC时返回
feeint交易总额,单位:分
origin_feeint订单原金额,单位:分
refunded_feeint已退款金额,单位:分
can_refundbool是否能退款
received_feeint商户实收金额,单位:分
user_pay_feeint用户支付金额,单位:分 1
discount_infoJson优惠信息
pay_timeString支付时间,格式"yyyy-MM-dd HH:mm:ss"
user_noString会员号, 仅会员返回
member_phoneString会员手机号, 仅会员返回
member_nameString会员名称, 仅会员返回

优惠信息字段 discount_info

字段名类型说明
mch_discount_feeint商家优惠金额,单位:分, mch_discount_fee = kd_discount_fee + m_discount_fee
mch_discount_descstr商家优惠描述
kd_discount_feeint酷点平台优惠,单位:分
kd_discount_descint酷点平台优惠描述
m_discount_feeint免充值优惠金额,不算到实收金额里,单位:分
y_discount_feeint预充值优惠金额,算到实收金额里,单位:分
p_discount_feeint第三方平台优惠金额,如支付宝红包、支付宝集分宝、补贴等,单位:分

请求示例

:::: tabs

::: tab biz_content

{
"order_no": "300230547599788000"
}

:::

::: tab 原始数据

{
"open_app_id": "kd100020200220",
"timestamp": 1602558156,
"sign_type": "MD5",
"token": "UT89A6C01D2A704608808F4896369FE009",
"biz_content": "{\"order_no\": \"300230547599788000\"}",
"sign": "ce0392a3e2c34e382086f9fe1065d3d7"
}

:::

::::

响应示例

:::: tabs

::: tab result

{
"code": 0,
"data": {
"attach": "",
"discount_info": {
"mch_discount_desc": "",
"mch_discount_fee": 0,
"kd_discount_desc": "",
"kd_discount_fee": 0,
"p_discount_fee": 0,
"y_discount_fee": 0
},
"fee": 100,
"member_name": "Janus",
"member_phone": "18826490000",
"origin_fee": 100,
"pay_no": "600230547601422048",
"pay_time": "2020-10-13 11:00:00",
"payment": "会员钱包支付",
"payment_type": "BALANCE",
"received_fee": 100,
"shop_name": "",
"status": "PAYED_SUCC",
"status_name": "支付成功",
"user_pay_fee": 100
},
"msg": "success",
"succeed": true
}

:::

::: tab 原始数据

{
"result": "{\"code\":0,\"data\":{\"attach\":\"\",\"discount_info\":{\"kd_discount_fee\":0,\"m_discount_fee\":0,\"p_discount_fee\":0,\"y_discount_fee\":0},\"fee\":100,\"member_name\":\"Janus\",\"member_phone\":\"18826490000\",\"order_no\":\"300230547599788000\",\"origin_fee\":100,\"pay_no\":\"600230547601422048\",\"pay_time\":\"2020-10-13 11:00\",\"payment\":\"会员钱包支付\",\"received_fee\":100,\"shop_name\":\"\",\"status\":\"PAYED_SUCC\",\"user_pay_fee\":100},\"msg\":\"success\",\"succeed\":true}",
"sign": "14655d9aefccd4c2b133f49f78566142"
}

::: ::::