查询订单可用门店

开发环境

http://dev-cn.your-api-server.com

POST

/api/trade/v2/fulfillment/order_can_use

查询该 order_id 在该门店下是否可用，可用则返回相应信息。
接口说明
核销工具类小程序才能调用此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

order_id

string

必需

抖音内部交易订单号，长度<64byte。

poi_id

string

可选

适用门店poi_id

示例

返回响应

🟢200成功

application/json

Body

data

object

必需

order_id

string

必需

抖音内部交易订单号，长度<64byte。

can_use

boolean

是否可用

必需

certificates

array [object {5}]

可选

此订单的券信息，订单可用时才返回

extra

object (opi数据接入extra)

必需

description

string

错误码描述

必需

error_code

integer

错误码

必需

logid

string

标识请求的唯一id

必需

now

integer

毫秒级时间戳

必需

sub_description

string

子错误码描述

必需

sub_error_code

integer

子错误码

必需

🟠400请求有误

修改于 2023-12-01 06:23:21

查询用户券列表

券核销消息通知

查询订单可用门店

错误码#

请求参数

返回响应

错误码