查询用户券列表
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/trade/v2/fulfillment/query_user_certificates
接口说明
核销工具类小程序才能调用此api
核销工具类小程序需要有对应商家(account_id)的授权关系才能查询
错误码
HTTP 状态码 | 错误码 sub_error_code | 描述 | 排查建议 |
---|---|---|---|
200 | 10000 | 参数错误 | 参数不符合规范。请根据提示检查参数。 |
200 | 13000 | 系统错误,请重试 | 内部错误,重试可解决。 |
请求示例请求 示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/trade/v2/fulfillment/query_user_certificates' \
--header 'access-token: clt.xxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"open_id":"ba253642-0590-40bc-xxx",
"account_id":"12345",
"poi_id":"123",
"page":1,
"page_size":10
}'
响应示例响应示例
{
"data": {
"orders": [
{
"can_use": true,
"certificates": [
{
"amount": {
"original_amount": 20,
"pay_amount": 20,
"merchant_ticket_amount": 0,
"payment_discount_amount": 0,
"coupon_pay_amount": 20
},
"certificate_id": "71817",
"expire_time": 1703260799,
"sku_info": {
"account_id": "12345",
"groupon_type": 1,
"market_price": 20,
"sku_id": "123",
"sold_start_time": 1672123976,
"third_sku_id": "",
"title": "测试商品"
},
"start_time": 1672138509
}
],
"order_id": "80000088"
}
],
"total": 1,
"error_code": 0,
"description": ""
},
"extra": {
"error_code": 0,
"logid": "20221228144816E59CDC04081F5001B2CE",
"now": 1672210096,
"sub_description": "success",
"sub_error_code": 0,
"description": ""
}
}
请求参数
Header 参数
Content-Type
string
必需
示例值:
application/json
access-token
string
必需
示例值:
clt.xxx
Body 参数application/json