合作方福利核销接口

简介

业务介绍

合作方福利核销标准接口

接口定义

应用场景

由爱奇艺提供本接口供合作方调用，进行福利核销

接口域名

环境	域名
生产	openapi.vip.iqiyi.com
测试	test-openapi.vip.iqiyi.com

URL

/rights-proxy-api/benifit/callback/redeemBenifit

请求方式

参数	说明
Method	POST
Content-Type	application/json

Header参数

序号	变量名	名称	是否必须	类型	说明
1	customer	商户标识	是	String	合作方标识（爱奇艺侧分配）

请求参数

序号	变量名	名称	是否必须	类型	说明
1	biz	业务标识	是	String	爱奇艺侧按业务分配
2	orderCode	爱奇艺流水号	是	String	爱奇艺侧跳转/直充/发券时提供的爱奇艺侧业务流水号/订单号(最大长度64位)
3	redeemTime	核销时间	否	Long	时间戳(毫秒)
4	processType	核销类型	否	Integer	1：预留（可能是销毁等类型），2：核销
5	useChannel	核销渠道	否	String	合作方定义
6	storeId	核销门店ID	否	String	合作方定义
7	item	合作方商品标识	是	String	合作方定义
8	sign	接口签名	是	String	调用签名，签名秘钥由合作方提供，签名算法参见：https://developer.vip.iqiyi.com/custom/TOB/subscribeTob.html#MD5

返回参数

字段名	类型	说明
code	String	返回码
msg	String	返回信息

测试环境及参数

参数	值	备注
customer	benefit_test
biz	benefit
item	15614192
签名秘钥	e85854766ad326f9

Q1.提示签名错误

1.联系爱奇艺对接人，确认配置的customer、秘钥是否和传入的一致
2.检查参数签名规则是否符合文档约束
3.若以上检查无问题，则提供下完整请求参数、签名前明文串

Q2:提示商品不存在

1.联系爱奇艺对接人，确认配置的商品标识是否和传入的一致

点击此处进行接口调试

在线调试