Yuno 测试Gateway

为了测试一般的银行卡支付，Yuno 提供了Yuno Test PaymentGateway。它可以作为连接使用，但只能在沙盒环境中使用。

与 Yuno 联系

一般信息

集成配置

生产环境

设置 Yuno 测试支付Gateway

1. 完成测试支付Gateway 集成配置。
2. 建立连接后，您必须在路由部分指定 Yuno Test PaymentGateway 为您的银行卡支付提供商。访问 Yuno 控制面板上的 "路由"，选择 "未发布"，找到 "卡 "选项，然后单击 "设置"。

3. 为 卡片.如果您不确定如何创建，请查看 配置动态路由.
   1. 在路由仪表板上，添加触发银行卡支付的条件。例如，您可以使用银行卡品牌或国家作为触发条件。
   2. 在创建的条件中，添加 Yuno Test 支付Gateway。
   3. 对于所有其他支付选项，请选择取消选项。下图展示了一个路由配置示例，其中使用了银行卡品牌条件，接受威士卡和万事达卡品牌的付款。

4. 现在，您需要让卡片可供测试。访问 Yuno 控制面板上的结账生成器。 激活卡片的切换按钮，并使用发布按钮发布结账。

使用创建支付指南了解如何测试银行卡支付。

使用 Yuno 测试Gateway测试银行卡支付

在本页，您将看到使用Yuno TestingGateway 创建银行卡支付的操作指南。

Yuno TestingGateway是 Yuno 用来测试一般银行卡支付的解决方案。它可以作为连接使用。不过，它只能在沙盒环境中使用。

要求

在开始执行本指南所述步骤之前，您需要

• 访问您的 应用程序接口凭据 在 Yuno Dashboard 上，它们由以下部分组成：
  • public-api-key
  • private-secret-key
  • account_id
• 在您的 Yuno Dashboard 账户上设置 Yuno TestingGateway 连接。您可以在 "集成配置 "部分找到连接该网关的分步指南。
• 为 Yuno TestingGateway 创建一个路由，将其定义为您的银行卡支付提供商。您可以在 "设置Yuno TestingGateway "部分找到分步指南。
• 配置结账生成器，使 Yuno TestingGateway 可用。

步骤摘要

创建付款流程通常需要完成以下四个步骤。

1. 创建客户
2. 创建结账会话
3. 创建一次性Token
4. 创建付款

创建payment

1.创建客户

使用 创建客户 注册客户信息。您需要提供个人客户信息。此外，您还需要提供 merchant_customer_id客户的唯一标识符。

📘

客户补充信息

创建客户时，某些信息不是必须提供的，但提供这些信息可以改善用户的支付体验。电话、账单地址和送货地址就是可以提供的非必填数据。如果添加了可选信息，请注意必填字段。

在创建客户流程结束时，您将收到一份 id在 Yuno 系统中识别用户。使用 id 来initialize 结账。

如果您要为先前创建的现有用户创建付款，而该用户已经有一个 id您可以跳过这一步。

2.创建结账会话

客户注册后，您就可以创建一个结账会话。结账是指客户最终完成订单，并开始为他们想要购买的产品或服务付款。因此，在这一阶段，您将提供有关付款金额和创建地点的信息。

🚧

路由条件过滤

创建路由时，可以定义作为筛选器的条件。如果使用国家作为条件，请检查创建结账会话时提供的国家是否在条件列表中。否则，Yuno TestingGateway 可能无法处理银行卡支付。

使用 创建结账会话 endpoint。请注意 customer_id 执行请求所需的 id 中创建客户时收到的 步骤 1.

从请求响应到 创建结账会话 endpoint，您将收到 checkout_session 信息。该信息将用于创建一次性token （OTT）和下一步的支付。

3.创建一次性token (OTT)

OTT 是 Yuno 为保护客户隐私和安全而生成的唯一标识符。它是支付详情的标识符，可防止敏感数据存储在您的服务器上。因此，您可以使用 OTT 让您的客户轻松重复支付，而无需重新输入支付信息，使支付过程更加安全和方便。

在您的生产应用程序中，您将始终从 Yuno SDK 获得 OTT。不过，为了方便您测试付款创建过程，Yuno 提供了 创建 OTT endpoint。您需要提供 checkout_session 收到 步骤 2 并将付款类型定义为 CARD 通过 type 参数。 在响应中，您将收到 one-time-token您将使用它来创建付款。

4.创建付款

您将使用创建付款 endpoint创建付款。下面将深入介绍如何创建付款。

4.1 提供所需的属性

提供与客户相关的信息，包括 checkout_session 从步骤 2 到 checkout.session 和 customer_payer 对象，该对象包含 id 从步骤 1 开始。

创建付款时，某些对象不是必须提供的。但是，如果您提供了这些信息，用户的支付体验将得到改善。如果您希望提供这些信息，请注意必填字段。

4.2 选择捕捉类型

Yuno 提供两种付款采集选项：

• 单步式：授权和采集同时进行。您只需创建付款。授权和采集将自动执行。对于单步式选项，您需要发送 capture 属性为 true 请求。
• 两个步骤：授权和抓取在不同时刻进行。创建付款后，您需要执行授权请求和捕获请求。 capture 作为 false 创建付款后，使用 授权Payment 和 采集授权 以完成该过程。

4.3 确定付款工作流程

创建付款时，您需要告知正在使用 Yuno 的哪个集成。创建付款时，您必须通过 workflow 属性，可以是

• CHECKOUT:如果您使用 Yuno SDK 创建付款。
• DIRECT:如果使用背对背集成。要使用此工作流程，您需要符合 PCI 标准。
• REDIRECT:如果使用背对背集成和提供商重定向。

4.4 提供付款方式信息

通过对象告知付款方式信息 payment_method.在这里，您将提供 one-time-token 通过属性 token 并选择付款 type 等于 CARD在 步骤 3根据 付款类型列表.此外，您还需要在对象上添加卡片信息 detail.card.

在使用 Yuno Test PaymentGateway 测试支付时，您可以使用支付描述或具体的银行卡数据来获得所需的结果。下面将详细介绍每种方法。

📘

Yuno 系统流程

Yuno 系统遵循一个顺序过程，首先检查卡片数据，然后评估所提供的说明。因此，如果卡数据显示的状态与测试付款的描述不一致，Yuno 将优先考虑并反映与卡数据相关的状态。

4.4.1 - 付款说明

要使用付款描述获得所需的付款结果，需要将预期结果定义为所创建付款的描述。例如，如果您正在测试付款并期望得到成功的结果，那么付款描述应为SUCCEEDED"（SUCCEEDED）。您可以在交易代码部分找到所有可用选项。

4.4.2 - 贺卡详情

另一种获得预期支付结果的方法是使用 Yuno 提供的测试卡。在下表中，您可以找到使用 Yuno 测试Gateway时要用到的卡及其数据详情列表。交易响应代码列定义了使用相应卡时返回的支付状态。

4.4.3 - 3DS 测试卡

使用这些卡和OTP代码，通过我们的预览环境，使用Netcetera Demo Merchant (NDM)模拟器测试3DS流程，该模拟器的配置是模拟目录服务器和/或带有预定义方案和测试卡号的ACS。它不能连接外部测试目录服务器和/或 ACS，只能帮助完成用于测试目的的 3DS 流程。

5.查看付款状态

在向 创建Payment您可以通过分析 status 和 sub_status 从答复中删除。检查 Payment 状态 页面，查看创建付款请求后可能收到的所有选项。

根据处理器和付款方式的不同，状态更新可能需要一些时间。因此，您可能需要使用endpoints 来恢复付款状态。要执行这项任务，可以使用按 ID 检索付款或按商家订单号 检索 付款 endpoints。另一种方法是使用 webhooks 在每个事件发生后接收通知。Yuno 建议您使用 Webhooks 来更好地监控异步支付。查看Webhooks指南，了解如何配置 Yuno 提供的 Webhooks 解决方案。