腾讯微卡Wiki

# 用户状态查询

# 接口描述

走代扣下单的应用，可能会产生未结单，需要调用此接口查询用户状态，获取用户的签约状态和欠费订单列表。

# 请求方法：

GET(application/json)

# 请求地址：

https://open.wecard.qq.com/cgi-bin/pay/app/user-state?access_token=access_token&sub_appid=sub_appid&user_id=user_id[1]

# 参数说明：

参数名 类型 必填 描述
access_token string Y 应用有效凭证，参考文档
sub_appid string Y 发起支付商户的sub_appid，获取方式参考文档
user_id string Y 用户卡号

# 响应说明：

{
	"code": 0,
	"message": "",
	"data": {
		"contract_status": "",
		"debt_status": "",
		"debt_order_list": [{
			"out_trade_no": "",
			"amount": "",
			"create_time": "",
			"scene": "",
			"pay_channel": "",
			"location": "",
			"acct_sub_appid": ""
		}],
		"overdue_status": "",
		"overdue_repayment_params": [{
			"appid": "",
			"path": "",
			"extra_data": ""
		}]
	}

}
参数名 类型 必填 描述
code int Y 业务状态。0 为成功 其他为失败
message string Y 业务提示
data contract_status int Y 签约状态。0：未签约，1：已签约
debt_status int Y 未结单状态。0：无未结单，1：有未结单，需要请求补缴接口重新支付。
debt_order_list out_trade_no string Y 订单号
amount int Y 未结单状态
create_time string Y 下单时间
scene string Y 支付场景
pay_channel string Y 支付渠道
location string Y 支付商户
acct_sub_appid string N 小钱包账号
overdue_status int Y 垫资状态。0：无垫资订单，1：有垫资订单，需要跳转到微信小程序进行补缴。
overdue_repayment_params appid string Y 微信补缴小程序 appid
path string Y 微信补缴页面
extra_data Object Y 补缴完要返回的小程序信息

# 注意事项

[1] 私有化部署的主体不能使用上面接口地址，需要根据主体私有化部署域名拼上对应的路径，主体私有化网关域名（私有化部署域名+/kong)

← 概述 →