通知送礼领券

我的收藏

接口说明

通知送礼领券

请求参数

参数名称	参数类型	是否必填	参数描述	备注
request_id	string	必填	本次请求id
order_id	string	必填	抖音侧的订单号
from_open_id	string	必填	原券码所有人抖音侧user_id
from_mobile_phone	string	必填	加密，原券码所有人抖音侧绑定手机号	敏感信息解密文档
receive_open_id	string	必填	领取人抖音侧user_id
receive_mobile_phone	string	必填	加密，领取人抖音侧绑定手机号
certificates	list(object)	必填	批量操作的券码列表
.certificate_id	string	必填	抖音侧券码id
.code	string	必填	服务商侧code

请求示例

{
   "request_id": "11111222222",
   "order_id": "11111",
   "from_open_id": "1111111", //原所有人抖音侧open_id
   "from_mobile_phone": "1111", //原所有人抖音侧绑定手机号 
   "receive_open_id": "1111", //新所有人抖音侧open_id
   "receive_mobile_phone": "11111", //加密手机号 
   "certificates": [
      {
         "certificate_id": "1111111", //券码id
         "code":"三方服务商三方码"
      }
   ]
}

响应参数

参数名称	参数类型	是否必填	参数描述	备注
data	object	必填		•这是一个批量接口，服务商需要保证接口操作数据原子性
.error_code	int64	必填	•错误码 0
.description	string	必填	•错误描述
.transfer_type	int64	必填	•转移类型	•1 同步转移成功 ◦表示服务商侧同步操作了数据，保证所有券码被批量领取成功并解锁，该券码在服务商侧可发起核销 •2 转移失败 ◦直接告知转移失败，后续抖音侧不会接受异步回调结果； •3 异步转移pending ◦告知抖音侧，该券码转移任务会异步进行，后续可以通过送礼领取回调接口告知抖音，若x秒之后未回调，抖音侧认为异步转赠失败，通知用户并拒绝后续成功回调；
.fail_reason_code	int64	选填	•失败时的错误码	•404 在三方系统中未找到关联的账号
.fail_reason	string	选填	•转移失败原因	•可同description 。
.certificates	array	可选	•返回失败结果列表
..certificate_id	string	必填	•抖音侧券码id
..new_code	tring	可选	•新code	•如果要同步返回换码场景下必须给到新券码和原券码不能相同
..error_code	int64	必填	•该券码的错误原因
..description	string	必填	•该券码的错误描述

响应示例

{
   "data": {
      "error_code": 0, //认为成功
      "description": "success",
      "transfer_type":1,//转赠类型
      "fail_reason":"失败原因",
      "certificates": [ 
         {
            "certificate_id": "111",
             "new_code":"aaaabbbccc",
            "error_code": 0,
            "description": "11111fwef"
         }
      ]
   }
}