Lite SDK （支付）

精简版 SDK Lite SDK可完全控制您的支付体验。与 Full SDK不同，该版本允许您查询可用的付款方式，并决定在结账时显示哪些付款方式。客户选择付款方式后，付款流程与Full SDK 的步骤相同。

此外，Lite SDK 还支持注册支付方法，以便将来使用。更多详情，请参阅Lite SDK （注册）。

📘
Lite SDK中的谷歌支付和 Apple 支付
Google Pay 和 Apple Pay 不能作为Lite SDK 的内置支付选项。要使用这些支付方法，您必须使用 mountExternalButtons 方法。具体实现细节请参阅平台专属指南。

使用Lite SDK，您可以

执行付款流程
付款时注册信用卡
使用已登记支付方式的保险库token 完成交易
使用银行识别码（BIN）回调函数执行实时税费计算

使用以下指南实施每个流程：

Payment workflow

使用保险库token的支付工作流程

付款时注册信用卡

Payment workflow

下图展示了完整的payment workflow：

SDK Lite 支付流程

本图说明了使用 SDK Lite 的支付流程，详细介绍了商家客户端、商家服务器、Yuno 服务器和 Yuno SDK 之间的互动。它概述了从启动结账、选择支付方式到创建和完成支付的各个步骤。

组件概述

支付工作流程涉及多个关键组件，它们相互配合才能安全地处理支付。以下是每个组件在流程中的作用：

商户客户

商户客户端代表您的前端应用程序，负责处理用户界面和支付流程。其主要职责包括

启动结账
列出付款方式
用户选择payment 方式
使用结账会话和付款方式启动 SDK
获取token （一次性使用）
启动付款
启动 SDK 以继续付款流程

商户服务器

商家服务器代表您的后台应用程序，负责协调您的前台和 Yuno 服务。它的主要职责包括

创建客户
创建结账会话
申请可用的付款方式
创建payment
通过网络钩子接收付款结果

Yuno 服务器

Yuno 服务器负责处理与支付处理和供应商集成相关的所有后台操作。其主要职责包括

创建客户
创建结账会话
返回可用的付款方式
在付款提供程序中创建付款
接收付款提供商的付款结果

Yuno SDK

Yuno SDK 在客户端管理支付流程，处理用户交互和支付处理。它的主要职责包括

接收用户选择的结账会话和付款方式
回调一次性token
继续付款流程
显示用户完成付款的屏幕
显示付款结果（可选）

完整流程

以下步骤概述了 SDK Lite 支付集成所有组件之间的完整交互流程，详细说明了每个请求和响应如何在系统中移动：

商家服务器：创建客户 --> Yuno 服务器：创建客户
商户客户端：启动结账 --> 商户服务器：创建结账会话
商家服务器：创建结账会话 --> Yuno 服务器：创建结账会话
商户客户端：启动结账 --> 商家客户端：列出付款方式
商户客户端：列出付款方式 --> 商家客户端：用户选择付款方式
商户客户端：用户选择支付方式 --> 商户客户端：使用结账会话和支付方式启动 SDK
商家客户端：使用结账会话和支付方式启动 SDK --> Yuno SDK：接收用户选择的结账会话和支付方式
Yuno SDK：接收用户选择的结账会话和支付方式 --> Yuno SDK：回调一次性token
Yuno SDK：使用一次性token 的回调 --> 商户客户端：商家客户端：获取token （一次性）
商家客户：商家客户端：获取token （一次性使用） --> 商户客户端：启动支付
商户客户端：启动支付 --> 商户客户端：启动 SDK 以继续支付流程
商户客户端：启动 SDK 以继续支付流程 --> Yuno SDK：继续支付流程
Yuno SDK：继续支付流程 --> Yuno SDK：显示用户完成支付的屏幕
商户客户端：启动结账 --> 商户服务器：创建结账会话
商户客户端：列出付款方式 --> 商户服务器：请求可用的付款方式
商户客户端：启动支付 --> 商户服务器：创建付款
商家服务器：创建付款 --> Yuno 服务器：在支付提供商中创建支付
商户服务器：通过 webhook 接收付款结果 --> Yuno 服务器：从支付提供商接收支付结果
Yuno 服务器：从支付提供商接收支付结果 --> Yuno SDK：显示支付结果（可选）

特定平台 SDK 设置

要实施Lite SDK 集成，请遵循以下特定平台指南：

网络

iOS

安卓

使用保险库token的支付工作流程

如果您的客户已经注册了其中一种可用的支付方式，则可以使用注册过程中的Vaultedtoken进行背对背支付。使用这种方法，您无需请求有关支付方式的额外信息。

下图描述了完整的工作流程：

拱顶token 流程

本图说明了使用 SDK Lite 的拱顶token 的支付流程，详细介绍了商家客户端、商家服务器、Yuno 服务器和 Yuno SDK 之间的互动。它概述了从启动结账、使用预存支付方式到创建和完成支付的各个步骤。

组件概述

保险库token 支付工作流程涉及多个关键组件，它们相互配合以安全地处理支付。以下是每个组件在流程中的作用：

商户客户

商户客户端代表您的前端应用程序，负责处理用户界面和支付流程。其主要职责包括

启动结账
渲染付款方式
启动付款
显示付款结果

商户服务器

商家服务器代表您的后台应用程序，负责协调您的前台和 Yuno 服务。它的主要职责包括

创建结账会话
申请可用的付款方式
创建payment
接收付款结果

Yuno 服务器

Yuno 服务器负责处理与支付处理和供应商集成相关的所有后台操作。其主要职责包括

创建结账会话
返回已启用的付款方式
在付款提供程序中创建付款
提供付款结果

完整工作流

以下步骤概述了金库token 支付工作流程中不同组件之间的详细互动顺序：

商户客户端：启动结账 --> 商户服务器：创建结账会话
商家服务器：创建结账会话 --> Yuno 服务器：创建结账会话
商户客户端：渲染付款方式 --> 商户服务器：请求可用的付款方式
商户服务器：请求可用的付款方式 --> Yuno 服务器：返回已启用的付款方式
商户客户端：渲染付款方式 --> 商家客户端：启动付款
商户客户端：启动支付 --> 商户服务器：创建付款
商家服务器：创建付款 --> Yuno 服务器：在支付提供商中创建支付
商家客户端：显示付款结果 --> 商户服务器：接收付款结果
商户服务器：接收付款结果 --> Yuno 服务器：提供付款结果

与支付工作流程不同的是，对于使用保险库token进行的支付，您将使用以前注册过支付方式的现有客户的信息。

此工作流程的步骤与支付工作流程相同，但 SDK 不会收集新的支付详细信息，而是检索已存储的保险库token。有关详细实施步骤，请参阅上述特定平台指南。

付款时注册信用卡

使用 Lite SDK，您可以在同一支付请求中保存信用卡或借记卡，以备将来购买之用，而无需额外的注册集成。

如何获取保险库token

您可以通过两种方式检索保管库token ：

通过应用程序接口： 设置 vault_on_success = true 当使用创建payment endpoint。响应将返回 vaulted_token 客户的银行卡。
通过 SDK 设置： 启用 cardSaveEnable = true 的 SDK 设置中的网络, iOS或安卓.SDK 将显示一个复选框，允许用户保存卡片。

只使用一种方法注册卡。要注册其他支付方式，请参阅Lite SDK （注册）页面。

📘
会员卡注册选项
注册银行卡时只能使用一个选项。要注册其他支付方式，请参阅Lite SDK （注册）页面。

注册付款方式后，可以使用保险库token 执行付款。要访问每个用户注册的支付方式的相关信息，请使用以下endpoints之一：

📘
使用保险库Tokens的最佳做法
即使用户选择了已注册的支付方式，Yuno 也建议使用 SDK 来标记信息，而不是直接在 Yuno 的 API 中使用保险库token 。这种方法有几个好处：

支持 3DS：增强在线支付的安全性。

欺诈筛查：更好地防范欺诈交易。

收集所需信息：必要时，收集提供方要求的其他字段。

要实现这一点，发送 vaultedToken 在安装 SDK 时。SDK 将处理其余事宜。如果支付方法需要额外步骤（如 3DS 挑战），请使用 yuno.continuePayment() 方法。该方法可处理任何所需的重定向，并适用于需要额外客户操作的注册支付方式和普通支付方式。