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

如何建立网关开发文档

作者: 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

    code.txt

    调用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


  • 3.后台用户管理,权限管理等其它操作
  • 业务描述:后台管理用户一般分为:技术支持,客服,财务三种角色。系统可以给不同的角色不配不同的权限。比方说,审核用户的充值,提现只有财务才有权限等。可以根据系统的需要作出自己的调整




(责任编辑:admin)

工作日:9:00-22:00

周 六:9:00-20:00