# 服务商分配资源包
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
assignPackage
# 功能描述
- 服务商在购买商品后,可通过本接口为指定的小程序/移动应用分配资源包。
# 注意事项
- 分配资源包为异步任务,接口调用成功后,分配资源包是否最终成功,请以服务端消息推送的分配结果事件为准。
- 建议存储
requestId
,若需取消分配,需与分配时的requestId
保持一致。
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/charge/service-provider/package/assign?access_token=ACCESS_TOKEN
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。access_token可通过getAccessToken接口获得。 |
orderId | string | 是 | 要分配的服务商订单ID,如 DD2970445798112968704 |
skuId | string | 是 | 期望分配给小程序/移动应用的商品SKU ID |
receiverAppId | string | 是 | 要分配的小程序/移动应用AppID |
requestId | string | 是 | 唯一请求 ID,同一次分配请求需唯一,同一订单号同一requestId多次请求等同一次。requestId应为10-64位长的字符串 |
beginTime | number | 否 | 资源生效时间戳(单位:毫秒),部分商品支持 |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
# 调用示例
示例说明: HTTPS调用
# 请求数据示例
POST https://api.weixin.qq.com/wxa/charge/service-provider/package/assign?access_token=ACCESS_TOKEN
{
"orderId": "DD2970445798112968704",
"skuId": "20000178",
"requestId": "1687254272930",
"receiverAppId": "wxbf98693b6554a24a"
}
# 返回数据示例
{
"errcode": 0
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
10120002 | 参数错误 | |
10120405 | 方法不可用 | 对照文档使用正确的方法请求 |
10120800 | 订单ID不合法 | |
10121001 | 订单ID不合法或订单状态不正确 | 检查订单是否存在且状态正确 |
10121004 | 系统错误 | 请重试 |
10121009 | 重复调用,已分配成功 | |
10121010 | 分配已取消 | |
10121011 | 分配中 | 稍后重试 |
10121012 | 资源包已过期,无法分配 | |
10121013 | 无效资源包 | |
10121014 | requestId已使用 | 更换requestId |
10121020 | 无法将购买的订单分到指定的SKU ID | 检查参数中的skuId是否在已购买资源包可分配的sku列表中 |
10121021 | SKU不存在 | 检查参数skuId |
10121022 | 无法将购买的订单分到指定的账号 | |
10121023 | 系统错误 | 请重试 |
10121031 | 订单的资源包用量不足,无法分配 | 更换订单或sku |
10121040 | 要分配的账号不符合指定能力的使用条件 | 请查看相应能力的使用文档,检查接入条件 |