更新时间:2018-07-19 15:12:20
获取产品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_idstring

M-必填详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看
用户唯一凭证密钥app_secretstring

M-必填详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看



返回说明


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


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


参数说明

中文名称英文名称域类型域长度默认值请求要求备注
应答码respCdstring4
M-必填
应答消息respMsgstring

M-必填
产品tokentoken string

C-依条件必填获取到的凭证; 凭证是字符串
过期时间expire_in int

C-依条件必填凭证有效时间,单位:秒



咨询与服务