# 福利直充接口
# 简介
# 业务介绍
合作方福利直充标准接口
# 接口定义
# 应用场景
由合作方提供本接口供爱奇艺调用，进行福利直充
# 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 |