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