更新时间:2021-04-13 14:41:35
说明

目前仅提供OAuth2.0认证方式沙箱调用,非对称方式沙箱调用建设中,敬请期待

什么是沙箱环境?

沙箱环境是为了方便开发人员调试所提供的测试环境。

开发测试阶段,可在沙箱环境下进行联调,该环境与生产环境互相隔离,同时为了便于用户进行体验,申请沙箱测试后用户可通过【沙箱调用】填写所需要的参数进行接口调用在线演示,了解OpenAPI接口调用的步骤与实现逻辑。

部分产品提供入网测试联调服务,并提供5x8小时的在线坐席为接入方处理联调测试问题。


如何开通Mock沙箱权限?

进入业务产品详情页面,点击【沙箱测试】开通功能权限  

银联卡属性查询详情信息1.png

  

Mock沙箱调用功能入口

1.点击【沙箱调用】进入功能界面(需先点击上方的沙箱测试申请权限)


image.png


2.管理API认证账号-沙箱测试账号信息

  1)登录开放平台后进入个人中心-->我的信息,点击前往“API认证账号”管理,

  2)点击API认证账号的查看详情,生成“API认证账号”和“API认证密钥”,

  3)自行设置“用户签名密钥”或“RSA验签公钥”,并添加自己所需的IP到“用户IP白名单”中去。


  注:RSA验签公钥只需填写RSA生成公钥私钥请务必自己保存好。

2.jpgimage.png


OAuth2.0 沙箱调用演示

1.获取产品Token


(1)填写URL参数:

查看个人的API认证信息,将其复制到相应的文本框内,点击发送请求即可生成。银联卡属性查询沙箱调用详情页1.png

(2)发送请求

发送请求后若出现相关错误,可根据提示或者参考应答码进行调试修改。

例如出现提示:您的IP(xxx.xxx.xxx.xxx)不属于您设置的开发IP列表,只需要将此IP添加到用户IP白名单中即可。

请求成功后便可获得产品Token(有效期目前为2个小时,需定时刷新,重复获取将导致上次获取的产品token失效。)

具体示例如下:

6.png


2.银联卡属性信息查询

(1)切换接口

切换接口信息.png

(2)获取时间戳

法1(推荐):使用当前页面右侧的演示小工具,点击获取时间戳即可自动生成并在下方以及左侧文本框内自动填写相关数据以供后续操作使用

8.png


法2:(JAVA): System.currentTimeMillis();

法3:通过网页审查元素打开console控制台:new Date().getTime()

 9.png

(3)获取签名信息

请求报文签名规则:

a. 报文前拼接签名密钥,后面拼接时间戳(毫秒)字符串:signature + body + ts ;

signature: 签名密钥;body: 请求JSON报文;ts: 时间戳,毫秒 ;     

请求JSON报文体举例:{"cardNo":"6214830215395277"}

(注:数字为所测试的银行卡号)  

b. 使用SHA-256算法计算HASH值;

步骤1:先在页面左侧填写银行卡号

10.png


步骤2:点击获取时间戳

11.png


步骤3:修改签名计算文本框内的[SIGNATURE]为自己设置的用户签名密钥并点击加密

(个人中心-我的信息(页面底部)-API认证账号-用户签名密钥(第三个))

注意:更改时应一并删除[SIGNATURE]的括号

12.png


 

(4)填写参数,发送请求

将上述所求各个参数填入,并点击发送请求,便可得到请求结果,根据所输入的银行卡号,返回该卡号的相关信息:

若你按照上面的流程使用,在这一步中你只需要复制演示小工具右侧加密过的字符串,粘贴到sign栏中并点击发送请求

13.png


请求返回结果如下:

14.png


咨询服务