Full SDK

使用 YunoFull SDK,您可以将 Yuno 无缝集成到您的系统中。这种方法简化了集成、维护和操作,无需额外的合规工作。

主要特点

  • 用户体验:Yuno 可管理整个结账流程。
  • 自定义:直接从 Yuno 的仪表板配置付款方式和用户界面元素。
  • 灵活性:无需额外开发即可添加新的支付方式和功能。
  • 单一集成:无论客户选择哪种付款方式,只需一次实施即可支持多种付款方式。

使用full SDK可以做什么

  1. 无缝处理付款。
  2. 在处理付款时注册信用卡。
  3. 使用已注册支付方式的保险库token 。

请按照以下分步指南集成Full SDK:

Payment workflow

Full SDK 提供统一的支付体验,允许客户在一个集成中使用多种支付方式完成交易。下图说明了整个流程:

Full SDK 集成流程

Full SDK 集成流程

本图说明了Full SDK 的全面集成流程,详细介绍了商户客户端、商户服务器、Yuno 服务器和 Yuno SDK 之间的交互。它涵盖了从启动结账到显示最终支付结果的整个支付流程。

商户客户

商家客户端(Merchant Client)代表您与后端服务器和 Yuno SDK 交互的前端应用程序。它处理payment 流程中面向用户的方面,包括

  • 启动结账
  • 通过结账会话启动 SDK
  • 接收一次性token (一次性使用)
  • 启动付款
  • 启动 SDK 以继续付款流程
  • 显示用户完成付款的屏幕
  • 显示付款结果(可选)

商户服务器

商家服务器代表您的后台应用程序,负责处理服务器端操作并与 Yuno 服务器通信。它的主要职责包括

  • 创建客户
  • 创建结账会话
  • 创建payment
  • 通过网络钩子接收付款结果

Yuno 服务器

Yuno 服务器处理与客户管理、结账会话和付款处理相关的所有后台操作。它的主要职责包括

  • 创建客户
  • 创建结账会话
  • 在付款提供程序中创建付款
  • 接收付款提供商的付款结果

Yuno SDK

Yuno SDK 在客户端处理用户界面和支付流程,管理支付方式选择、token 生成和支付完成。它的主要职责包括

  • 接受结账环节
  • 列出付款方式
  • 用户选择payment 方式
  • 回调一次性token
  • 继续付款流程
  • 显示屏幕让用户完成付款
  • 显示付款结果(可选)

流量

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

  1. 商家服务器:创建客户 --> Yuno 服务器:创建客户
  2. 商户客户端:启动结账 --> 商户服务器:创建结账会话
  3. 商家服务器:创建结账会话 --> Yuno 服务器:创建结账会话
  4. 商户客户端:启动结账--> 启动 SDK 以继续支付流程
  5. 商户客户端:启动 SDK 以继续支付流程 --> Yuno SDK:接收结账会话
  6. Yuno SDK:接收结账会话 --> 列出付款方式
  7. Yuno SDK:列出付款方式 --> 用户选择付款方式
  8. Yuno SDK:用户选择支付方式 --> 使用一次性token回调
  9. Yuno SDK:回调一次性token --> 商户客户端:接收一次性token (一次性使用)
  10. 商户客户端:接收一次性token (一次性使用)--> 开始付款
  11. 商户客户端:启动支付--> 启动 SDK 以继续支付流程
  12. 商户客户端:启动 SDK 以继续支付流程 --> Yuno SDK:继续支付流程
  13. Yuno SDK:继续支付流程 --> 显示屏幕让用户完成支付
  14. Yuno SDK:显示用户完成支付的界面 --> 显示支付结果(可选)
  15. 商户客户端:启动支付 --> 商户服务器:创建付款
  16. 商家服务器:创建付款 --> Yuno 服务器:在支付提供商中创建支付

特定平台 SDK 设置

要实施Full SDK 集成,请遵循以下特定平台指南:

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

如果客户已注册付款方式,则可使用注册过程中的保险库token完成交易,而无需再次输入付款详情。

拱顶Token 全图

本图说明了在整个支付流程中处理预存tokens 的过程,显示了商户客户端、商户服务器、Yuno 服务器和 Yuno SDK 之间的交互。它重点介绍了如何使用预存储支付凭证来简化交易。

商户客户

商户客户端是与客户互动的前端应用程序。它的主要职责如下

  • 启动结账
  • 通过结账会话启动 SDK
  • 启动付款
  • 显示付款结果

商户服务器

商家服务器负责后台操作,并与客户和 Yuno 的服务进行通信。它的主要职责包括

  • 创建客户
  • 创建payment
  • 接收付款结果

Yuno 服务器

Yuno 服务器处理核心支付处理功能并管理客户数据。其主要职责包括

  • 创建客户
  • 在付款提供程序中创建付款
  • 提供付款结果

Yuno SDK

Yuno SDK 负责处理用户界面和支付方式选择过程。其主要职责包括

  • 接受结账环节
  • 列出付款方式
  • 用户选择payment 方式
  • 回调一次性token

流动:

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

  1. 商家客户端:启动结账 --> 商户服务器:创建客户
  2. 商家服务器:创建客户 --> Yuno 服务器:创建客户
  3. 商家客户端:用结账会话启动 SDK --> Yuno SDK:接收结账会话
  4. Yuno SDK:接收结账会话 --> 列出付款方式
  5. Yuno SDK:列出付款方式 --> 用户选择付款方式
  6. Yuno SDK:用户选择支付方式-->回调一次性token
  7. Yuno SDK:使用一次性token 回调 --> 商户客户端:启动支付
  8. 商户客户端:启动支付 --> 商户服务器:创建付款
  9. 商家服务器:创建付款 --> Yuno 服务器:在支付提供商中创建支付
  10. 商户客户端:显示付款结果 --> 商户服务器:接收付款结果
  11. 商户服务器:接收付款结果 --> Yuno 服务器:提供付款结果

付款时注册信用卡

有了Full SDK,您就可以保存信用卡/借记卡,以便今后使用相同的支付请求进行购买,而无需注册集成。您可以通过两种方式获得保险库token

  • 通过应用程序接口:设置 vault_on_success = true 当使用 创建payment endpoint。您将收到 vaulted_token 与客户付款人在回复中使用的银行卡相对应。
  • 通过 SDK 设置:设置 cardSaveEnable = true 在 SDK 中的补充功能 (网络, iOS安卓.SDK 将显示一个复选框,供用户选择是否保存该卡以备将来购买之用。如果用户选中该复选框,您将收到 vaulted_token.
📘

会员卡注册选项

注册银行卡时只能使用一个选项。要注册其他支付方式,必须使用 Lite SDK.

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

🚧

使用拱顶token

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

  • 支持 3DS:增强在线支付的安全性。
  • 欺诈筛查:更好地防范欺诈交易。
  • 收集所需信息:必要时,收集提供方要求的其他字段。