通过应用程序接口

本指南提供了使用 Yuno APIendpoints迁移tokens 的分步流程。按照概述的步骤，您将汇编一份客户及其注册支付方式的列表。

要求

在执行本指南中的步骤之前，请确保您已经安装了.....：

完成了从gateway 账户导入卡片的三个相关步骤。
访问您的应用程序接口凭据在 YunoDashboard上，其中包括
- public-api-key
- private-secret-key
- account_id

在继续阅读本指南之前，请确保您已完成这些步骤并掌握了必要的数据。

通过应用程序接口迁移tokens

步骤 1：创建客户

要开始token 迁移过程，您需要使用 "创建客户"（Create Customer）endpoint 将客户添加到 Yuno 系统。需要注意的是，不能为 Yuno 系统中不存在的客户注册支付方式。如果客户已经存在于 Yuno 中，您可以跳过这一步。

要注册新客户，请提供他们的个人信息。此外，您还必须提供 merchant_customer_id这是系统中使用的客户唯一标识符。

📘
客户补充信息
在创建客户时，某些信息是可选的，但如果提供了这些信息，就能增强用户的payment 体验。非强制性数据包括电话号码、账单地址和送货地址。
如果您选择添加可选信息，请确保同时提供所有必填字段。

完成客户创建流程后，您将收到一封 id 标识用户在 Yuno 系统中的身份。使用此 id enroll 现有payment 方式。

步骤 2：检查客户数据（可选）

在此步骤中，您可以选择验证每个注册客户的信息。使用检索客户 endpoint 来访问客户数据。为此，请提供 id 是在最初创建客户时生成的。

步骤 3：Enroll payment 方式

要完成迁移过程，需要使用第三方保险库或gateway 数据为每位客户注册付款方式。

利用 Enroll Payment 方式 endpoint 来注册支付方法。请记住 customer_id 该request 所需的 id 中创建客户时获得的步骤 1.此外，还包括 provider_data 对象，其中包含外部提供程序的token，如下所示：

curl --request POST \
     --url https://api-sandbox.y.uno/v1/customers/{{customer_id}}/payment-methods \
     --header 'X-Idempotency-Key: <Your X-Idempotency-Key>' \
     --header 'accept: application/json' \
     --header 'charset: utf-8' \
     --header 'content-type: application/json' \
     --header 'private-secret-key: <Your private-secret-key>' \
     --header 'public-api-key: <Your public-api-key>' \
     --data '
{
  "country": "BR",
  "type": "CARD",
  "workflow": "DIRECT",
  "provider_data": {
    "id": "MERCADO_PAGO",
    "payment_method_token": "{{provider_card_token}}"
  },
  "account_id": "{{account_id}}" 
}
'

在endpoint的响应中，您将收到一个 vaulted_token 标识所注册的payment 方式。这 vaulted_token 将用于今后的付款，因此无需额外提供payment 方式的详细信息。

步骤 4：检查注册的payment 方式（可选）

enrollment payment 方式后，您可以使用检索已登记的payment 方式 endpoint。请记住 customer_id 该request 所需的 id 中创建客户时获得的步骤 1.