创建推广计划
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/marketing/delivery
1.本次升级主要涉及接口:创建推广计划(alipay.marketing.activity.delivery.create)接口。
2.升级调整详情:
● 为解决部分商家券在支付成功页本店优惠区域无法曝光问题,【指定支付成功页】由原来的可选字段【delivery_target_rule-delivery_merchant_rule】变更为必选字段,新增必选字段:指定支付成功页模式【delivery_merchant_mode】
○ 说明:该能力升级不影响推广支付券。如需推广商家券,请根据上述说明升级相应接口。
错误码
公共错误码
业务错误码
状态码 | 错误码 | 错误描述 | 解决方案 |
---|---|---|---|
400 | SYSTEM_ERROR | 系统繁忙 | 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试 |
400 | BIZ_ERROR | 商户需授权isv代运营关系 | isv与商户进行代运营关系的授权 |
400 | BIZ_ERROR | 业务异常相同操作正在执行中 | 相同调用正在执行中。商户可以用同样请求发起重试,返回第一次调用执行完成结果。 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/marketing/delivery' \
--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 '{
"delivery_booth_code":"PAYMENT_RESULT",
"out_biz_no":"20170101000001654bb46ba",
"delivery_base_info":{
"delivery_name":"本店优惠第十期投放计划",
"delivery_begin_time":"2017-01-01 00:00:01",
"delivery_end_time":"2017-01-01 00:00:01"
},
"delivery_play_config":{
"delivery_single_send_config":{
"delivery_content_info":{
"delivery_content_type":"ACTIVITY",
"delivery_activity_content":{
"activity_id":"20122131234434557567"
},
"delivery_app_content":{
"mini_app_id":"2018052160106010",
"service_code_list":[
"2020030921000303380758"
],
"mini_app_delivery_type":"SERVICE_DIRECT"
},
"delivery_display_info":{
"main_title":"手机租赁免押金",
"sub_title":"随时随地享受社保服务"
}
}
},
"delivery_full_send_config":{
"delivery_floor_amount":"1.00",
"delivery_content_info":{
"delivery_content_type":"ACTIVITY",
"delivery_activity_content":{
"activity_id":"20122131234434557567"
},
"delivery_app_content":{
"mini_app_id":"2018052160106010",
"service_code_list":[
"2020030921000303380758"
],
"mini_app_delivery_type":"SERVICE_DIRECT"
},
"delivery_display_info":{
"main_title":"手机租赁免押金",
"sub_title":"随时随地享受社保服务"
}
}
}
},
"delivery_target_rule":{
"delivery_merchant_rule":{
"delivery_merchant_mode":"MANUAL_INPUT_MERCHANT",
"delivery_merchant_infos":[
{
"merchant_id_type":"PID",
"merchant_id":"2088xxxxx"
}
]
},
"delivery_city_code_rule":{
"city_codes":[
"100100"
],
"all_city":true
},
"delivery_promo_tags":"memberLevel1,memberLevel2"
},
"merchant_access_mode":"SELF_MODE"
}'
响应示例响应示例
{
"delivery_id":"20121231231242353"
}
请求参数
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
返回响应
修改于 2023-11-22 02:25:27