集成指南
本指南介绍集成流程的各步骤,请阅读本章节了解与万里汇(WorldFirst)集成的整体过程。
集成流程分为以下几个步骤。
集成准备

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

图2. 集成商获取令牌的接口调用流程
开通 WorldCard
下图为集成API接口来开通 WorldCard 并确认开通结果和卡信息的流程:

图3. 集成商开通 WorldCard 的接口调用流程
查询 WorldCard 信息
下图展示了查询卡信息、卡列表和卡敏感信息需调用的接口:

图4. 集成商查询卡信息的接口调用流程
修改卡状态和交易限额
下图为修改卡状态或卡交易限额所需调用的接口:

图5. 集成商修改卡状态和交易限额的接口调用流程
查询卡账单和账户交易单
如需查询卡账单或万里汇账户交易单,集成商可按需调用下图列出的接口:

图6. 集成商查询卡账单和万里汇账户交易单的接口调用流程
查询万里汇账户余额
如需查询万里汇账户余额,集成商可按需调用下图接口:

图7. 集成商查询万里汇账户余额的接口调用流程
完成验收测试
集成商需联系万里汇技术支持了解验收测试详情。
发布至生产环境
应用通过验收测试后,集成商即可发布至生产环境。