当前位置:主页 > 雷達支付 > 操作指南 > 图文教程 >

如何建立网关开发文档

作者： admin 发布日期：2016-01-03 09:30 浏览次数：来源：未知

Radar系统的网关的功能主要是给网关用户提供充值，提现功能。因此对于网关系统的建立我们可以分为两部分

一：网关WEB系统

1.用户登录网关系统
业务流程描述：该功能使用RADAR系统的单点登录接口，使用RADAR的用户合法性验证接口。使用这个接口，用户只需要使用RADAR的登录账号、密码就可以登录网关，简化用户操作的难度。
RADAR SSO接口描述
接口名称：RADAR 单点登录接口

事例:
网关url为：http://www.gateway.com
钱包地址为：http://t.radarlab.com
- a.用户登陆状态下跳到网关，直接带token跳转：
- http://www.gateway.com?token=xxxxxxxxxx
- b.网关收到token之后，调用如下接口验证token：
- 之后钱包验证完token返回radar地址：
- - (1)成功返回：
```
{
	"status":"0",
	"adress":"rGn7QTSvqhGudkxpko6TAccmzK32e9d3Sp"
}
								
```
  - (2)失败返回：
```
{
	"status":"1"
}
								
```
- c.用户从网关跳转到钱包登陆：
- http://t.radarlab.com/index.html#/login/aHR0cDovL3d3dy5nYXRld2F5LmNvbQ==,61851db9e075e5437cf77dbdbd675be0f98407fa83fbdfd6
- 其中：url中login/后面的参数为一个字符串，为回调地址(BASE64)以及加密sign字符串的组合，中间用”,”号隔开。
- 比如说回调地址为http://www.gateway.com，那么：
- - (1)首先将url使用BASE64加密下：
  - Base64.encodeBase64String("http://www.gateway.com".getBytes())
    结果为：aHR0cDovL3d3dy5nYXRld2F5LmNvbQ==
  - (2)然后将url使用DES加密生成一个sign串（des密钥延续之前双方接口交互的密钥)，加密结果为：61851db9e075e5437cf77dbdbd675be0f98407fa83fbdfd6.
  - 然后使用逗号组合成一个字符串放到login/后面。
  - 之后在钱包登陆成功后，会继续步骤a、b的流程。
2.用户充值
业务流程描述：用户应根据系统的需求来选择是用第三方支付，还是线下转账。这个功能与一般的电商平台在线支付接口一致。因为网关必须要信任以后才可以网关内转账，因此这里需要调用RADAR网络的 RADAR账户信息查询接口。该接口主要为验证该RADAR地址是否已经信任了对应的网关，只有信任了对应的网关，才可以往该网关充值

查询账户信任（如果用户信任了本网关，则可以在此接口中查询网关余额）

API文档: https://radarlab.org/dev/radard-apis.html#account-lines

查询账户交易记录:

API文档：https://radarlab.org/dev/radard-apis.html#account-tx

查询账户VBC,VRP余额:

API文档：https://radarlab.org/dev/radard-apis.html#account-info

提交转账（此接口用于转账，提交买卖委托，添加账户信任，更多请参考API）

API文档:https://radarlab.org/dev/radard-apis.html#submit

参数说明：调用方式分Websocket和JSON-RPC方式

WebSocket调用接口地址为：ws://api.radarlab.org:5006

JSON-RPC 调用接口地址为：http://api.radarlab.org: 5005

如果要使用雷达转账API，请参考https://github.com/radrbiz/radarj/tree/master/radar-lib

调用RadarJ，生成转账报文代码

使用此code.txt中的代码，生成报文后，在雷达的Submit接口中使用就可以完成转账

3.用户提现
业务流程描述：根据网关提供的提现地址，用户需要把自己RADAR账户里面的余额转账到该提现地址上，系统会自动生成一笔用户提现的记录，金额就是用户的转账金额，财务人员在管理后台进行查询，审核。确认用户已经添加了提现银行卡，并且用户的转账入账，财务通过线下转账的方式，给用户提供的银行卡里转相应金额的钱。

用户登录网关系统

3.2.1 RADAR账户转账记录查询API

接口用途：通过实时的监控网关系统RADAR账号的转入记录，给用户生成提现记录单查询账户交易记录:

API文档：https://radarlab.org/dev/radard-apis.html#account-tx

4.用户查询自己的充值提现记录
业务流程描述：网关系统会根据用户的充值，提现生成相关的记录保存在数据库里。用户可以通过时间条件来查询这些记录，以及状态。
该部门不需要调用RADAR的API，系统自己设计表以及记录状态即可。

二：网关管理后台系统

1.用户存款列表查询、操作
业务描述：用户发起存款以后，系统会生成一个存款的记录，财务人员通过审核用户的存款信息，以确定用户是否真的打款到指定账户。当用户完成打款以后，财务人员可以对此记录进行“审核”操作。审核通过的过程，其实就是通过调用RADAR系统的API，去完成给用户的充值地址进行转账。

参考上面的code.txt生成转账报文，调用submit接口进行转账

API文档:https://radarlab.org/dev/radard-apis.html#submit

2.用户提现列表查询、操作
业务描述：财务人员通过查询每笔用户的提现单，用来判断是否给用户线下打款。只有用户把RADAAR账号里面的提现金额转给系统账号以后，才会出现用户提现单。财务进行审核。

这里需要调用RADAR系统的账户信息查询API

API接口描述如下

API文档：https://radarlab.org/dev/radard-apis.html#account-tx