契约:
post /pai/queryRefundStatus
Request Parameters
queryBaseData
名字 |
类型 |
描述 |
是否可选 |
version |
String(6) |
服务版本号,默认填写:2,其他版本请与和我们联系确认; |
NO |
platform |
String(10) |
最终支付来源,即请求支付的商户(每个渠道)使用何种方式调用开放平台支付 H5/Online/Native SDK/Offline/Android/iOS |
NO |
request_id |
String(64) |
请求信息标识,请求支付的商户(每个渠道)应保持唯一,即:前端发起的一笔支付交易请求流水,非全局的);不同渠道的这个id,可以重复的; |
NO |
out_user_id |
String(64) |
连尚账户相关:union_id...uhid... |
YES 二选一可为空 |
guest_id |
String(64) |
1.CP方给出的:openid ;用openid + unionid 在支付端进行 查询连尚统一账户信息:uhid; 2.游客:传给定值:GUESTER |
YES 二选一可为空 |
client_user_id |
String(64) |
1.游客时:游戏cp方必传该字段;2.cp方定义的用户id;其他接入渠道不是必传项 |
NO |
service_name |
String(32) |
服务名称,创建退款请求服务为:"CreateRefundOrder” |
NO |
language |
Int |
语言 填0=中文 |
NO |
merchant_id |
String(32) |
支付平台商户(渠道)ID,第三方接入开放平台支付前向开放平台支付申请获得(支付平台配置的渠道号,比如:pay001:游戏渠道001) |
NO |
time_stamp |
String(14) |
时间戳(请求时的时间),格式yyyyMMddHHmmss,如 2015年03月29号17点01分36秒 对应字符串为:20180329170136 |
NO |
compress_type |
String(2) |
压缩类型:0(不压缩),1(gzip) |
NO |
queryBizData
名字 |
类型 |
描述 |
是否可选 |
wk_refund_id |
String(64) |
用发起退款交易返回的wk_refund_id |
NO |
out_refund_id |
String(64) |
外部退款单号,第三方自己生成的订单标识(全栈唯一) |
NO |
out_trade_id |
String(64) |
原支付交易订单号 |
NO |
Request Example
{
"queryBaseData":{
"version":"2",
"platform":"Android",
"request_id":"000003",
"out_user_id":"63936102",
"guest_id":"",
"client_user_id":"63936102",
"service_name":"QueryRefundStatus",
"language":0,
"merchant_id":"656848",
"appid":"G0005",
"time_stamp":"20180329170536",
"compress_type":"0"
},
"queryBizData":{
"wk_refund_id":"24537de1261b45d8b57a0aff3c53fe35",
"out_refund_id":"1547020009105",
"out_trade_id":"010915462919552"
}
}
响应契约:
queryBaseResponseData
名字 |
类型 |
描述 |
是否可选 |
version |
String(6) |
服务版本号,与请求时的信息一致 |
NO |
platform |
String(10) |
最终支付来源,即商户使用何种方式调用开放平台支付,与请求时的信息一致 |
NO |
request_id |
String(64) |
信息标识,与请求时的信息一致 |
NO |
out_user_id |
String(64) |
信息标识,与请求时的信息一致 |
NO |
guest_id |
String(64) |
|
NO |
client_user_id |
String(64) |
|
NO |
service_name |
String(32) |
服务名称,与请求时的信息一致 |
NO |
language |
Int |
语言与请求时的信息一致 |
NO |
merchant_id |
String(32) |
开放平台商户ID,与请求时传值一致 |
NO |
time_stamp |
String(14) |
时间戳(返回时的时间) |
NO |
compress_type |
String(2) |
压缩类型:0(不压缩),1(gzip) |
NO |
queryBizResponseData
名字 |
类型 |
描述 |
是否可选 |
result_code |
String(16) |
返回结果 Success 为成功 |
YES |
out_trade_id |
String(64) |
原支付交易订单号 |
YES |
wk_refund_id |
String(64) |
为退款请求中的wk_refund_id |
YES |
refund_cash_amount |
Int |
退款金额(单位:分) |
YES |
refund_status |
String(32) |
99:退款成功,10:退款进行中,20: 退款失败 |
YES |
fail_reason |
Stirng(128) |
退款失败原因 |
YES |
deal_time |
String(16) |
成功退款时间 |
YES |
Request Example
{
"queryBaseResponseData": {
"version": "2",
"platform": "Android",
"request_id": "000003",
"out_user_id": "63936102",
"guest_id": "",
"client_user_id": "63936102",
"service_name": "QueryRefundStatus",
"language": 0,
"merchant_id": "656848",
"appid": "G0005",
"time_stamp": "20190110144030",
"compress_type": "0"
},
"queryBizResponseData": {
"result_code": "SUCCESS",
"refundList": [
{
"refund_status": 99,
"out_trade_id": "010915462919552",
"deal_time": "20190109154656",
"wk_refund_id": "24537de1261b45d8b57a0aff3c53fe35",
"fail_reason": "",
"refund_cash_amount": 1
}
]
}
}