查询推广计划

支持将已配好的优惠券一次提报，投放到支付宝多个渠道。权益越好，流量越多。

错误码

公共错误码

业务错误码

状态码	错误码	错误描述	解决方案
400	SYSTEM_ERROR	db异常	可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试
400	SYSTEM_ERROR	限流异常	可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试
400	BIZ_ERROR	业务异常缺少代运营关系	isv与商户进行代运营关系的授权
400	INVALID_PARAMETER	参数有误参数有误请求参数异常	请求参数异常，请根据具体返回的错误信息排查后，重新设置入参
400	SYSTEM_ERROR	业务异常业务发生未知异常	可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试。

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/marketing/delivery/20121231231242353/query' \ --header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \ --header 'alipay-request-id: $requestid' \ --header 'Content-Type: application/json' \ --data-raw '{ "merchant_access_mode":"AGENCY_MODE" }'

{ "delivery_id":"20121231231242353", "delivery_status":"ACTIVE", "delivery_booth_code":"PUBLIC_UNION", "delivery_error_msg":"素材审核失败：素材存在敏感信息。", "delivery_base_info":{ "delivery_name":"第十期投放计划", "delivery_begin_time":"2017-01-01 00:00:01", "delivery_end_time":"2017-01-01 00:00:01", "delivery_material":{ "delivery_single_material":{ "delivery_image":"A*WXYTAswgww" } } }, "delivery_play_config":{ "delivery_single_send_config":{ "delivery_content_info":{ "delivery_content_type":"ACTIVITY", "delivery_activity_content":{ "activity_id":"20122131234434557567" } }, "delivery_content_config":{ "delivery_send_guide":{ "delivery_guide_url":"alipays://platformapi/startapp?appId=xxxx" } } } }, "delivery_target_rule":{ "delivery_city_code_rule":{ "city_codes":[ "100100" ], "all_city":true }, "delivery_recall_mode":"CITY_RECALL" } }

请求参数

Header 参数

authorization

string

必需

示例值:

ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign

alipay-request-id

string

必需

示例值:

$requestid

Content-Type

string

必需

示例值:

application/json

Body 参数application/json

merchant_access_mode

string

必需

商户接入模式枚举值商户自接入模式: SELF_MODE 服务商代接入模式: AGENCY_MODE

示例

返回响应

🟢200成功

application/json

Body

delivery_booth_code

string

必需

推广的展位编码。枚举值： PAYMENT_RESULT：支付有礼。

delivery_error_msg

string

必需

推广计划错误信息描述，如推广计划审核失败时为审核失败原因。

delivery_base_info

object

推广计划基础信息。

必需

delivery_name

string

必需

推广计划名称。推广计划名称不会对用户进行表达，只用于商户管理使用。长度需要大于等于3，小于等于20。

delivery_begin_time

string

必需

推广计划开始时间。格式为：yyyy-MM-dd HH:mm:ss。

delivery_end_time

string

必需

推广计划结束时间。格式为：yyyy-MM-dd HH:mm:ss。

delivery_play_config

object

必需

推广发放规则。限制：支付送活动和满额送活动，一个推广计划仅支持一种发放规则

delivery_single_send_config

object

可选

支付送活动（支付金额无限制）发放规则信息。

delivery_full_send_config

object

可选

满额送活动发放规则信息

delivery_target_rule

object

必需

推广定向曝光规则。说明：支持指定支付成功页、支付场景规则、自定义规则定向曝光，各规则之间为且关系

delivery_merchant_rule

object

必需

delivery_city_code_rule

object

必需

delivery_promo_tags

string

必需

merchant_access_mode

string

必需

商户接入模式枚举值 SELF_MODE 商户自接入模式 AGENCY_MODE 服务商代接入模式枚举值商户自接入模式: SELF_MODE 服务商代接入模式: AGENCY_MODE 注意事项选择服务商代接入模式需配合 app_auth_token 代调用使用

delivery_id

string

推广计划id

必需

delivery_status

string

必需

推广计划状态。枚举值生效中: ACTIVE 失效状态: INACTIVE 审核中: AUDITING 审核不通过: AUDIT_NO_PASS

查询推广计划

错误码#

公共错误码#

业务错误码#

请求参数

返回响应

错误码

公共错误码

业务错误码