直接流集成

工作原理

如果您是开发人员，您可以使用我们的 Direct Flow 继续使用您的结账，并只使用服务器到服务器的连接来连接到我们的服务。

贵公司必须通过 PCI 认证，才能使用我们的服务器到服务器银行卡支付服务。在开始实施前，请将您的 AOC 证书转交给您的客户经理。

❗️
我们始终建议使用 Yuno 的 SDK，而不是 Direct Flow 集成。Yuno 的 SDK 符合 PCI 标准，通过管理所有复杂问题（包括欺诈防范、3DS 和支付提供商的特定要求）来简化支付流程。Direct Flow 要求商家手动处理这些方面，从而增加了复杂性和风险。

对于每次实施，我们建议采取以下payment方式 status 和 sub_status 作为 payment状态.一笔payment 可能有不同的交易与之相关联，因此，通过将重点放在payment上 状态/次状态无论进行了多少次交易，您都可以获得最新状态，为您的决策提供清晰的输入。通过集成，您还可以 enroll 信用卡未来购买（也仅适用于符合 PCI 标准的商家）。

Payment

步骤 1：创建客户

[单选]：支付流程的第一步是创建客户。客户将关联付款方式。您可以使用以下 endpoint.结果，您将收到在 Yuno DB 中创建的客户 ID。

如果之前已经创建了客户，则可以跳过此步骤。

这一步是可选的，因为您可以直接在付款中发送客户信息，而无需在 Yuno 中创建客户对象。

🚧
如果您想生成一个 vaulted_token.

第 2 步：创建付款

当您使用此集成处理整个支付体验时，您需要显示您 Yuno 账户中启用的支付方式。用户选择付款方式后，您就可以创建付款。付款会收集有关订单、客户详情、总金额、货币、产品、发货详情等的所有重要详细信息。您可以使用以下方式创建付款 endpoint.

您可以使用示例部分作为参考。如果用户选择了之前注册的付款方式，可以使用 vaulted_token 返回的 get payment methods 服务来创建付款。

在集成过程中，我们建议将payment 状态 和子状态作为payment状态的主要参考。一笔payment 可能与不同的交易相关联，因此通过关注payment 状态/子状态，无论有多少笔交易，您都可以获得最新的状态，从而为决策提供清晰的输入。

直接与间接工作流程

在 Yuno 中使用直接集成时，对于替代付款方式（PSE、Nequi、MercadoPago、PIX 等），您有两种选择 workflow 选项：

直接：我们从提供商处返回原始响应，这样您就可以使用未经过滤的数据构建您喜欢的体验。
重定向:虽然我们也会返回供应商的直接回复，但我们也为商家提供使用由 Yuno 提供的重定向链接的可能性，在该链接中，我们仅处理该付款的支付体验。您可以在 payment_method.detail.redirect_url 字段。

重要附加组件

网络钩子：我们建议您在 Yunodashboard中配置Webhooks。Webhooks 是确保您的系统随时了解payment 进度和状态的最佳方式。由于事件通知是自动触发的，您的系统无需向 Yuno 重复请求。

设备指纹：客户的设备指纹用于防止欺诈。它们通常是在结账时使用第三方 JavaScript 生成的。如果使用Direct 集成并希望在payment 流程中支持欺诈提供商，可以使用此对象指定必要的信息。对于使用 Yuno 结账的集成，该值会自动获取，因此请勿发送此字段。

[...]
"customer_payer": {
    "merchant_customer_id": "1690161049",
    "first_name": "Giovanna",
    "last_name": "Bartell",
    "email": "[email protected]",
     "device_fingerprints": [
        {
            "provider_id": "MERCADO_PAGO",
            "id": "20a6c463-dd0c-4323-9115-03668d178856"
        },
        {
            "provider_id": "CLEARSALE",
            "id": "92d2ea4b-4bf7-494b-aaea-c48276135941"
        }     
  }, 
[...]

three_d_secure_setup_id:仅使用我们的 JS 获取 three_d_secure_setup_id 然后仅以 API 集成的方式处理付款。直接工作流程只适用于符合 PCI 标准的商家。它提供了一种创建支付和验证用户信息的直接方法，商家只需执行一个请求即可创建支付。要成功实施直接集成，请按照以下步骤进行操作整合准则并按指示提供所需信息。使用 Yuno 的 SDK 实施 3DS 不需要这项服务。

Enrollment

步骤 1：创建客户

支付流程的第一步是创建客户。客户将关联付款方式。您可以使用以下 endpoint.结果，您将收到在 Yuno DB 中创建的客户 ID。

如果之前已经创建了客户，则可以跳过此步骤。

步骤 2：注册付款方式

📘
直接流集成
此功能仅适用于为符合 PCI 标准的商家注册卡。

有了客户后，您可以使用注册付款方式endpoint .客户选择要注册的付款方式后，Yuno 将提供相关信息，您可以使用 vaulted_token 表示创建的支付方法对象。