会员对外文档平台 会员对外文档平台
登录
接口
介绍
  • TOB直充接口

  • TOB激活码直充接口

  • OTT直充接口

  • OTT自动续费接口

  • OTT激活码直充接口

  • 通用接口

  • 内容点播接口

  • 卡券类接口

  • 用户信息接口

  • 会员福利接口

    • 福利直充接口
    • 福利直充校验接口
    • 福利直充退单接口
    • 合作方福利核销接口
    • 合作方福利订单回传接口
  • 合作方客户FV管理

# 福利直充接口

# 简介

# 业务介绍

合作方福利直充标准接口

# 接口定义

# 应用场景

由合作方提供本接口供爱奇艺调用,进行福利直充

# URL

由合作方提供

# 请求方式

参数 说明
Method POST
Content-Type application/x-www-form-urlencoded

# 请求参数

序号 变量名 名称 是否必须 类型 说明
1 customer 商户标识 是 String 固定为iqiyi
2 biz 业务标识 是 String 爱奇艺侧按业务分配
3 orderCode 订单号 是 String 爱奇艺侧业务流水号/订单号
4 item 商品标识 是 String 要开通的商品标识,由合作方定义
5 amount 商品数量 否 Integer 要开通的商品数量,默认为1
6 account 用户账号 是 String 要开通权益的用户账号/手机号
7 sign 接口签名 是 String 调用签名,签名秘钥由合作方提供,签名算法参见:https://developer.vip.iqiyi.com/custom/TOB/subscribeTob.html#MD5

# 返回参数

字段名 类型 说明
code String 返回码
msg String 返回信息
data Object 返回数据

# 返回码定义

A00000、A00001代表处理成功,其他code都表示处理失败。 不同错误原因返回对应错误code。 如没有对应原因的code码,可以使用Q00332,msg中描述错误原因。 若返回非A00000、A00001、Q00206、Q00148的错误码,爱奇艺系统会重试调用。

返回码code 描述 备注
A00000 请求成功 无
A00001 重复处理 处理成功的幂等
Q00114 用户未注册 表示用户未注册,如无用户必须注册的限制则忽略
Q00148 用户异常,无法开通 表示用户因各种限制原因(未注册除外),不能开通权益
Q00206 购买超限 表示用户购买产品次数已超过限制,如无购买限制则忽略
Q00219 无库存 表示产品库存已消耗完,如无库存限制则忽略
Q00332 其他错误 表示直充错误,返回此错误码时,msg中需要明示错误原因
Q00401 活动已结束 表示产品已不在售卖期

# 返回示例

data格式如下:

{
    "orderCode":"100000001", #爱奇艺订单号(String型)
    "bizCode": "200000002", #业务订单号,本次直充对应的订单号,无订单时可使用券码编号等能够唯一区分本次交易的信息(String型)
  "account":"8888888", #到账用户账号(String型)
}

# 在线测试

参数 值 备注
hosts -- 合作方提供接口地址
customer benefit_test
biz benefit
md5Key e85854766ad326f9

← 用户信息解密接口 福利直充校验接口 →