第三方商品(使用商家级别appkey和appSecret)

前期准备

说明:

  1. 获取签名supplierKey即为签名中的appKey supplierSecret即为签名中的appSecret。
  2. 设置请求地址。

1. 获取第三方商品列表

接口说明

该接口由开发者提供给通兑吧

商家在通兑吧商城后台添加第三方商品,会请求开发者服务器获取商品列表

时序图

API文档

  • 请求类型:GET
  • 签名规则请查询签名算法
  • 请求参数
变量名 是否必填 长度 类型 说明
page 11 int 当前请求页面 默认0 0表示第一页
pageSize 11 int 每页条数 默认100
type 10 string 商品类型 prize商品 coupon优惠券
  • 返回信息
参数 是否必须 类型 说明
code int 返回状态码(参考状态码定义部分)
msg string 返回错误信息, code=0,则为"success"
data objects 响应数据
totalCount int 商品总条数
rows array 商品列表
id string 商品id
name string 商品名称
number int 商品数量
discountType int 优惠券类型 1立减券 2满减券 3折扣券 请求参数type等于coupon传此参数
discountAmount int 优惠券金额 单位分(如果折扣券 此值=折扣*10 例如 8折 discountAmount = 80) 请求参数type等于coupon传此参数
discountCondition int 优惠券条件 满减券传此值 单位分
startAt int 优惠券使用开始时间戳
endAt int 优惠券使用结束时间戳

-返回示例

#商品示例
{
    "code":0,
    "msg": "success",
    "data": {
        "totalCount": 200,
        "rows": [{
            "id": "商品id",
            "name": "商品名称",
            "number": "商品数量"
        },{
            "id": "商品id",
            "name": "商品名称",
            "number": "商品数量"
        }
        ...
        ]
    }
}
#优惠券示例
{
    "code":0,
    "msg": "success",
    "data": {
        "totalCount": 200,
        "rows": [{
            "id": "商品id",
            "name": "商品名称-满减券",
            "number": 100
            "discountType": 2,
            "discountAmount": 100,
            "discountCondition": 10000,
            "startAt": 1609481016,
            "endAt" 1612073016:
        },{
            "id": "商品id",
            "name": "商品名称-立减券",
            "number": 200,
            "discountType": 1,
            "discountAmount": 100,
            "discountCondition": 0,
            "startAt": 1609481016,
            "endAt" 1612073016:
        }
        ...
        ]
    }
}

2. 发放第三方商品通知开发者

时序图

接口说明

该接口由开发者提供给通兑吧

c端用户通过活动获取第三方商品时,请求该接口通知开发者服务器。第三方提供的商品必须保证可以发放给用户, 如果多次发放全部发放失败,则需要人工处理退款或者补偿。

无论接受到的结果如何,只要开发者收到该请求,请返回,无响应或失败, 通兑吧会在之后隔2,5,13,35,97,275,793,2315,6817,20195秒通知一次, 共补发通知10次。

注:出于网络异常的可能性,通兑吧可能会对开发者进行重复通知,开发者务必确保一笔订单不进行重复处理,否则将产生严重bug

API文档

  • 请求类型:GET
  • 签名规则请查询签名算法
  • 请求参数
变量名 是否必填 长度 类型 说明
unionId 32 string 开发者用户唯一标识
orderId 100 string 发奖唯一流水号(长度100)
id 11 string 商品id
number 11 int 商品数量 默认1
  • 返回信息
参数 是否必须 类型 说明
code int 返回状态码(参考状态码定义部分)
msg string 返回错误信息, code=0,则为"success"
data objects 响应数据 成功null

-返回示例

{
    "code":0,
    "msg": "success",
    "data": null
}

results matching ""

    No results matching ""