OpenAPI接入指南- 中国银联开放平台

获取产品token

产品token是开放平台每个产品的全局唯一接口调用凭据，应用调用各接口时都需使用产品token，开发者需要进行妥善保存。产品token的存储至少要保留512个字符空间。产品token的有效期目前为2个小时，需定时刷新，重复获取将导致上次获取的产品token失效。

开放平台OpenAPI调用所需的产品token的使用及生成方式说明：

（1）为了保密app_secrect，需要一个产品token获取和刷新的中控服务器。而其他业务逻辑服务器所使用的产品token均来自于该中控服务器，不应该各自去刷新，否则会造成产品token覆盖而影响业务；

（2）目前产品token的有效期通过返回的expire_in来传达，目前是7200秒之内的值。中控服务器需要根据这个有效时间提前去刷新新产品token。

（3）平台现已提供全局token获取接口，地址为：https://openapi.unionpay.com/upapi/token

调用OpenAPI的应用使用app_id和app_secert调用对应产品的token接口来获取产品token。

app_id和app_secret可在开放平台“个人中心-API认证账号”（详见：接入指南）中获得（需要用户先登录开放平台）。

调用接口时，请提前将服务器IP地址添加到用户IP白名单中，否则将无法调用，返回应答码为9901（详见：全局返回码说明）。

接口调用说明

HTTPS请求方式：POST

URL： https://openapi.unionpay.com/upapi/cardbin/token

Content-Type: application/x-www-form-urlencoded

body: app_id={APP_ID}&app_secret={APP_SECRET}

参数说明

中文名称	英文名称	域类型	域长度	默认值	请求要求	备注
用户唯一凭证	app_id	string			M-必填	详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看
用户唯一凭证密钥	app_secret	string			M-必填	详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看

返回说明

正常情况下，开放平台会返回下述JSON数据包给调用方：

{"token":"","expire_in":7200}

参数说明