支付宝小程序:服务信息同步场景参数说明

小编:啊南 769阅读 2020.12.29

小程序服务绑定门店/POI

场景描述: alipay.open.mini.content.sync(小程序商品信息同步)接口小程序服务绑定门店/POI 场景下需参照下表说明入参。

  1. 调用 alipay.open.mini.content.sync(小程序商品信息同步)接口可将小程序服务与其他主体信息(门店、POI 等)进行关系绑定;

  2. 服务绑定 POI 只适用于有高德小程序并投放到高德端的场景,若未对接高德客户端,不建议绑定 POI,绑定后也无场景曝光。

请求参数
参数 类型 必填 描述

content_type

String 小程序服务类型。示例值 SERVICE,最大长度 64。

operation

String

操作。示例值 batchBind,最大长度 64。

content_data

String

小程序服务绑定内容详情,具体见下表。示例值 {"code": "2020041300077000000024065718","type":"SHOP","idList":["3243423432"]},最大长度 10240。

extend_info

String

扩展信息,无需填写。最大长度 10240。

content_data 参数说明
参数 类型 必填 描述

code

String

小程序服务 code。示例值 2020041300077000000024065718,最大长度 64。

type

String

绑定的对象类型,具体见下表枚举。示例值 SHOP,最大长度 32。

idList

List

绑定对象的 id 列表。type 为 SHOP 时传入支付宝门店 shop_id;type 为 POI 时需传入 poiid 。示例值 ["234324234"],最大长度单次 50 个。

小程序服务绑定对象的 Type 枚举

type

描述

SHOP

门店

POI

POI

响应参数
类型 必填 描述

result_data

String 绑定结果。示例值 true,最大长度 10240。
响应示例
{r  "alipay_open_mini_content_sync_response": {r    "code": "10000",r    "msg": "Success",r    "result_data": "true"  },r  "sign": "xx"}
业务错误码
错误码 错误描述 解决方案
BIZ_ERROR 系统异常。

系统超时等异常情况,建议重试,重试仍然失败可联系平台技术支持。

INVALID_PARAMETER

内容类型与操作不能为空。

必填项不允许为空,请检查确认。

INVALID_PARAMETER

小程序服务不存在。

绑定服务必须为创建成功并通过审核服务,请检查确认。

INVALID_PARAMETER

内容类型与操作不正确。 必须是指定的内容类型与操作。

BIZ_ERROR

无权限调用该接口。

接口需要开白名单才能调用,请联系平台处理。

INVALID_PARAMETER 业务入参校验失败。

详细情况请查看错误信息。

INVALID_PARAMETER

content_data 格式不正确。

content_data。必须是 json 格式。

INVALID_PARAMETER

小程序数据绑定类型不合法。

小程序数据绑定类型不合法,请检查确认。

INVALID_PARAMETER

小程序服务不合法。

小程序服务不合法(小程序和服务关系不存在或小程序code非罚),请检查确认。

INVALID_PARAMETER

小程序与门店绑定关系不存在。

小程序与门店关系不存在,请先绑定小程序和门店关系。

小程序服务解绑门店/POI

场景描述: alipay.open.mini.content.sync(小程序商品信息同步)接口取消小程序服务与门店的绑定关系,需参照下表说明入参。

请求参数
参数 类型 是否必填 描述

content_type

String 必选 小程序服务类型。示例值 SERVICE,最大长度 64。

operation

String 必选

操作。示例值 batchUnbinding,最大长度 64。

content_data

String 必选

小程序服务解绑内容详情,具体见下。示例值 {"code": "2020041300077000000024065718","type":"SHOP","idList":["3243423432"]},最大长度 102410。

extend_info

String

可选

扩展信息,无需填写。最大长度 10240。

content_data 参数说明

参数 类型 必填 描述

code

String

小程序服务 code。示例值 2020041300077000000024065718,最大长度 64。

type

String

解绑对象类型,具体见下枚举。示例值 SHOP,最大长度 32。

idList

List

解绑对象的 id 列表。示例值 ["234324234"],最大长度单次 50 个。

小程序服务解绑对象的 Type 枚举

type

描述

SHOP

门店

POI

POI

响应参数
参数 类型 是否必填 描述

result_data

String 必填 解绑结果。示例值 true,最大长度 10240。
响应示例
{  "alipay_open_mini_content_sync_response": {    "code": "10000",    "msg": "Success",    "result_data": "true"  },  "sign": "xx"}
业务错误码
错误码 错误描述 解决方案
BIZ_ERROR 系统异常。

系统超时等异常情况,建议重试,重试仍然失败可联系平台技术支持。

INVALID_PARAMETER

内容类型与操作不能为空。

必填项不允许为空,请检查确认。

INVALID_PARAMETER

内容类型与操作不正确。 必须是指定的内容类型与操作。

BIZ_ERROR

无权限调用该接口。

接口需要开白名单才能调用,请联系平台处理。

INVALID_PARAMETER 业务入参校验失败。

详细情况请查看错误信息。

INVALID_PARAMETER

content_data 格式不正确。

content_data 必须是 json 格式。

INVALID_PARAMETER

小程序数据绑定类型不合法。

小程序数据绑定类型不合法,请检查确认。

?小程序服务门店/POI 绑定关系分页查询

场景描述: alipay.open.mini.content.sync(小程序商品信息同步)接口分页查询小程序服务与门店/POI的绑定关系,需参照下表说明入参。

请求参数
参数 类型 必填 描述

content_type

String

小程序服务类型。示例值 SERVICE,最大长度 64。

operation

String

操作。示例值 pageQueryBindingInfo,最大长度 64。

content_data

String

分页查询条件,具体见下。示例值 {"code":"2489080", "type":"SHOP", "page":1, "pageSize": 10},最大长度 10240。

extend_info

String

扩展信息,无需填写。最大长度 10240。

content_data 参数说明
参数 类型 必填 描述

code

String

小程序服务 code。示例值 2020041300077000000024065718,最大长度 64。

type

String

解绑定的对象类型,具体见下枚举。示例值 SHOP,最大长度 32。

page

int

分页的页码。示例值 1,最大长度 1000。

pageSize

int

分页的单页大小。示例值 50,最大长度 50。

小程序服务绑定对象的 Type 枚举

type

描述

SHOP

门店

POI

POI

响应参数
参数 类型 必填 描述

result_data

String 查询结果。示例值 true,最大长度 10240。
result_data 参数说明
参数 类型 必填 描述

currentPageNum

int

分页查询当前的页码。示例值 1,最大长度 1000。

perPageCount

int

分页查询每页的大小。示例值 50,最大长度 50。

totalCount

long

记录的总数。示例值 100,最大长度 1000。

dataList

String

小程序服务绑定详情列表。示例值具体见下,最大长度 5120。

dataList 参数说明
参数 类型 必填 描述

id

String

小程序服务绑定主体对象 id。示例值 2020041300077000000024065718,最大长度 64。

status

String

小程序服务绑定关系状态,枚举见下。示例值 VALID,最大长度 64。

小程序服务绑定对象的 Type 枚举

type

描述

VALID

生效

INVALID

失效

AUDITING

审核中

AUDIT_REJECT

审核驳回

响应示例
{    "alipay_open_mini_content_sync_response": {        "code": "10000",        "msg": "Success",        "result_data": "{"dataList": [{"id": "2342342342","url": "http://url"}],"currentPageNum": 1,"perPageCount": 10,"totalCount": 100}"    },    "sign": "xx"}
业务错误码
错误码 错误描述 解决方案
BIZ_ERROR 系统异常。

系统超时等异常情况,建议重试,重试仍然失败可联系平台技术支持。

INVALID_PARAMETER

内容类型与操作不能为空。

必填项不允许为空,请检查确认。

INVALID_PARAMETER

内容类型与操作不正确。 必须是指定的内容类型与操作。

BIZ_ERROR

无权限调用该接口。

接口需要开白名单才能调用,请联系平台处理。

INVALID_PARAMETER 业务入参校验失败。

详细情况请查看错误信息。

INVALID_PARAMETER

content_data 格式不正确。

content_data 必须是 json 格式。

INVALID_PARAMETER

小程序数据绑定类型不合法。

小程序数据绑定类型不合法,请检查确认。

关联标签: