本文引导您集成银行 SDK，以按照不同维度向买家展示银行类支付方式，并跳转买家至银行类支付方式所支持的 app 或浏览器页面，以实现最佳用户体验。

银行 SDK 提供的主要功能包括：

• 按照支付方式、支付方式类型、支付方式所在国家展示银行类支付方式列表、处理商户和支付方式间页面跳转。
• 根据支付方式能力和买家的支付方式 app 安装情况，智能决策银行类支付方式的跳转情况。
• 支持商户渲染多语言支付页面，目前支持英语、印尼语、泰语三种语言。

集成步骤

银行 SDK 的集成流程如下图所示：

图 1. 银行 SDK 集成流程

集成前提

在您开始集成前，请阅读 集成指南 及 API 概述 文档，了解服务端 API 的集成步骤及 API 的调用注意事项，并确保已完成以下预配置工作：

• 在 开发者中心 已获得 client ID。
• 在 开发者中心 已完成密钥配置。
• 配置支付结果异步通知接收地址。配置方法请参考 接收通知。

集成步骤

您的服务端和客户端会参与到银行 SDK的集成：

• 服务端：发送创建支付会话的接口请求、获取支付结果。
• 客户端：展示支付方式、集成 SDK 包。

按照以下步骤进行集成：

1. 客户端创建 SDK 实例：您的客户端创建支付方式选择页并实现监听支付按钮的点击事件后，需 AMSCashierPayment() 创建 SDK 实例 。
2. 服务端调用支付会话创建接口：
   买家选择支付方式发起支付后，您的服务端使用买家的下单信息向 Antom 服务端发起 支付会话创建 请求。
3. 客户端调用 SDK：
   使用 支付会话创建 请求的响应参数 paymentSessionData，通过 createComponent() 调用 SDK。
4. 买家完成支付：
   买家在对应支付方式页完成支付。
5. 服务端获取支付结果并呈现：
   您的服务端通过接收 支付结果通知 或主动调用 查询支付结果 接口获取支付结果，并在您的支付结果页面向买家呈现。
   
   

更多关于 Web/WAP, Android, 或 iOS 终端类型的集成详情，参见以下相关内容：

• Web/WAP 端快速开始
• Android 端快速开始
• iOS 端快速开始

用户体验

银行 SDK 按照银行聚合类型提供单一银行，银行类型，银行国家三种类型的展示方式。每种展示方式下，当买家进入银行支付流程后，银行 SDK 将根据跳转规则，智能跳转到银行 app，网银，或者银行转账中的某一种继续引导支付。

单一银行展示

银行类支付方式按照单个支付方式的维度进行平铺呈现：

图1. 银行类支付方式按单一银行展示

买家选定支付银行后，进入 Bank payment workflow（银行支付流程）完成支付。

银行类型展示

银行类支付方式按照银行类型聚合的维度进行分类呈现：

图2. 银行类支付方式按银行类型聚合展示

买家选定支付银行后，进入 Bank payment workflow（银行支付流程）完成支付。

银行国家展示

银行类支付方式按国家聚合的维度进行分类呈现：

图3. 银行类支付方式按国家聚合展示

买家选定支付银行后，进入 Bank payment workflow（银行支付流程）完成支付。

银行支付流程

银行SDK将根据支付方式能力和买家的支付方式 app 安装情况，智能决策通过以下三种支付方式之一完成支付：

• 银行app 支付
• 网银支付
• 银行转账支付

银行app支付： 如果该银行类支付方式提供 app 端，并且买家已安装该银行 app，买家将跳转到该支付方式的 app。

图4. 银行app支付方式用户体验图

网银支付： 如果该银行类支付方式提供 app 端，但买家未安装该银行 app，买家将进入该支付方式的在线网银页面。

图5. 网上银行支付方式用户体验图

银行转账支付： 如果该银行类支付方式不支持直接跳转银行app，买家将进入该支付方式的银行转账页面。

图6. 银行转账支付方式用户体验图

支持支付方式

银行 SDK 当前支持以下支付方式：

表 1. 支持支付方式