创建付款

在本页中，您将找到创建付款的操作指南以及完成此任务所需的信息。

要求

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

• 访问您的 应用程序接口凭据 在 Yuno Dashboard 上，它们由以下部分组成：
  • public-api-key
  • private-secrete-key
  • account_id
• 在 Yuno Dashboard 账户上设置连接。
• 为付款方式建立路由，以定义处理方式。
• 配置结账生成器，使您的连接支付可用。

请务必在完成这些要求后再按照创建付款指南进行操作。

📘

探索汤野Postman 作品集

Yuno 提供Postman Collections，您可以用它在本地复制用例。

步骤摘要

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

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

📘

其他付款方式和功能

不同的支付方法（如使用特定钱包或 BNPL）或功能（如分批支付）可能需要在创建支付前执行额外的步骤。

创建payment

步骤 1：创建客户

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

📘

客户补充信息

创建客户时，某些信息不是必须提供的，但提供这些信息可以改善用户的支付体验。电话、账单地址和送货地址就是您可以提供的非必填数据。

如果添加了可选信息，请注意必填字段。

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

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

步骤 2：创建结账会话

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

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

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

步骤 3：创建一次性token (OTT)

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

您的应用程序将始终从 Yuno SDK 获得一次性token 。通过使用 Yuno 的 SDK，我们可以应对不同支付方式可能出现的各种特殊情况。这使我们能够

• 如果在 CARD 途径中选择的提供商需要一些附加字段，则要求提供所注册支付方法的缺失信息。
• 支持欺诈筛查
• 支持 3DS

您可以随时使用列表 Payment 类型 来检查所有可用的付款类型。在 SDK 的响应中，您将收到 one-time-token您将使用它来创建付款。

📘

测试信用卡付款

请记住，要测试信用卡支付，您可以将Yuno Test PaymentGateway设置为 Card route 中的提供商。

步骤 4：创建付款

您将使用endpoint "创建付款 "创建付款。通过 Yuno，您可以使用 3DS 或拆分付款等多种付款方式创建付款。不过，本指南的重点是没有额外身份验证、验证或注册要求的简单支付。

下面将深入介绍如何创建付款。

4.1 提供所需的属性

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

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

4.2 选择捕捉类型

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

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

4.3 附加功能

Yuno 还允许您使用基本付款创建过程中支持的一些附加功能：

• vault_on_success:如果您的客户使用信用卡付款，我们会让您在同一步骤中为客户注册该付款方式，以便其今后购物时使用。
• installments:如果您为客户提供分期付款服务，并且您选择的处理器接受分期付款，您可以将分期付款的金额发送给我们，以便我们创建付款。

这两个字段都可以在付款的付款方式详情部分找到。

ℹ️

生成和接收 vaulted_token 当 vault_on_success = true付款必须通过以下方式引用 Yuno 现有客户 customer_payer.id在支付请求中内联创建或发送客户数据不会在我们这边创建客户，因此不会触发保险库操作。当满足这些条件且支付状态为 SUCCEEDED，"...... vaulted_token 将在支付响应中返回，并可用于未来的交易。

步骤 5：查看付款状态

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

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

📘

测试卡支付

如果您需要测试一般的银行卡支付，Yuno 提供了 Yuno Test PaymentGateway。它可以作为连接使用，但只能在沙盒环境中使用。请查看Yuno Test PaymentGateway 页面了解所有功能，或直接查看如何测试银行卡支付的指南。