支付宝

查询活动可用商户

开发环境

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

GET

/v3/alipay/marketing/activity/{activity_id}/merchant/batchquery

alipay.marketing.activity.merchant

通过此接口可查询活动的可用商户,判断活动是否在某商户可用，来决定是否展示。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://dev-cn.your-api-server.com/v3/alipay/marketing/activity//merchant/batchquery'

响应示例

200 - 示例 1

{
  "activity_id": "2016042700826004508401111111",
  "merchant_infos": [
    {
      "merchant_id": "2088xx",
      "merchant_id_type": "PID"
    }
  ],
  "page_num": 1,
  "page_size": 20,
  "total_size": 200
}

请求参数

Path 参数

activity_id

string

活动id

必需

Query 参数

merchant_id

string

可选

商户PID,默认为当前接口调用商户。

page_num

integer

可选

分页查询页码。限制: 必须为大于0的整数

page_size

integer

可选

分页查询单页数据条数。限制: 1.必须为大于0的整数 2.每页最大值为20

merchant_access_mode

string

商户接入模式

可选

返回响应

🟢200common response

application/json

Body

activity_id

string

活动id

可选

示例值:

2016042700826004508401111111

merchant_infos

array[object (ActivityMerchantInfo) {2}]

可用商户列表

可选

merchant_id

string

可选

商户PID,默认为当前接口调用商户。

示例值:

2088xx

merchant_id_type

string

可选

商户支付宝id类型。

示例值:

PID

page_num

integer

分页查询页码。

可选

示例值:

page_size

integer

可选

分页查询单页数据条数。

示例值:

total_size

integer

可用商户总数量

可选

示例值:

200

🔴500请求失败

券过期消息

查询活动可用小程序