集成指南
本指南介绍集成流程的各步骤,请阅读本章节了解与万里汇(WorldFirst)集成的整体过程。
集成流程分为以下几个步骤。
集成准备
图1:产品集成及发布流程
阅读集成文档
在与万里汇集成前,集成商需阅读相关文档,了解对应方案的后续集成步骤,包括:
- 概述
- 集成指南
- API参考
制定集成方案
集成商需联系万里汇技术支持并制定集成规划,此过程会确定集成过程中具体的细节,如集成的要求及集成的必选/可选设置。
获取身份验证信息
从万里汇技术团队处获取集成所需信息,包括:
- 环境地址
- Client ID
- 联系万里汇技术支持以交换PSA2密钥对。关于如何生成密钥对,参考:传输报文及加验签
- 万里汇对外域名或IP地址
- 加入万里汇IP白名单(线下集成)
集成开发
集成商可根据具体业务需求,与万里汇团队一起完成开发和集成,集成商可使用万里付卡的API接口实现业务授权、开通万里付卡、查询万里付卡信息、修改卡状态和卡交易限额等功能。
业务授权(按需)
如您需要授权第三方完成代开卡和代付款的业务诉求,可通过配置跳转链接进行token令牌授权。下图展示了实现业务授权的接口调用流程:
图2:集成商获取令牌的接口调用流程
开通万里付卡
下图为集成API接口来开通万里付卡并确认开通结果和卡信息的流程:
图3:集成商开通万里付卡的接口调用流程
查询万里付卡信息
下图展示了查询卡信息、卡列表和卡敏感信息需调用的接口:
图4:集成商查询卡信息的接口调用流程
修改卡状态和交易限额
下图为修改卡状态或卡交易限额所需调用的接口:
图5:集成商修改卡状态和交易限额的接口调用流程
查询卡账单和账户交易单
如需查询卡账单或万里汇账户交易单,集成商可按需调用下图列出的接口:
图6:集成商查询卡账单和万里汇账户交易单的接口调用流程
查询万里汇账户余额
如需查询万里汇账户余额,集成商可按需调用下图接口:
图7:集成商查询万里汇账户余额的接口调用流程
完成验收测试
集成商需联系万里汇技术支持了解验收测试详情。
发布至生产环境
应用通过验收测试后,集成商即可发布至生产环境。