Via API

Este guia fornece um processo passo a passo para migrar tokens usando os endpoints da API Yuno. Ao seguir as etapas descritas, você compilará uma lista de clientes com seus métodos de pagamento registrados.

Requisitos

Antes de prosseguir com as etapas deste guia, certifique-se de que você tenha:

• Concluiu as três etapas relacionadas ao processo de importação de cartões de uma conta de gateway .
• Acessou seu Credenciais da API no Yuno Dashboard, que incluem:
  • public-api-key
  • private-secret-key
  • account_id

Certifique-se de ter concluído essas etapas e de ter os dados necessários antes de continuar com o guia.

Migrar tokens via API

Etapa 1: Criar clientes

Para iniciar o processo de migração token , você usará o endpoint Criar cliente para adicionar clientes ao sistema Yuno. É importante observar que os métodos de pagamento não podem ser registrados para clientes que não existem no sistema Yuno. Se os clientes já estiverem presentes no Yuno, você pode pular esta etapa.

Para registrar novos clientes, forneça suas informações pessoais. Além disso, você deve fornecer as merchant_customer_idque é um identificador exclusivo para o cliente usado em seu sistema.

📘

Informações complementares do cliente

Ao criar um cliente, determinadas informações são opcionais, mas podem aprimorar a experiência de payment do usuário se forem fornecidas. Exemplos de dados não obrigatórios incluem número de telefone, endereço de cobrança e endereço de entrega.

Se você optar por adicionar informações opcionais, certifique-se de que todos os campos obrigatórios exigidos também sejam fornecidos.

Ao concluir o processo de criação do cliente, você receberá uma mensagem id que identifica o usuário no sistema Yuno. Use isso id para enroll os métodos payment existentes.

Etapa 2: Verifique os dados do cliente (opcional)

Nessa etapa, você tem a opção de verificar as informações de cada cliente registrado. Use o botão Recuperar cliente para acessar os dados do cliente. Para fazer isso, forneça o id que foi gerado quando o cliente foi criado inicialmente.

Etapa 3: Enroll um método payment

Para concluir o processo de migração, é necessário registrar os métodos de pagamento de cada cliente usando os dados do cofre ou gateway terceiros.

Utilize o Enroll o métodoPayment para registrar os métodos de pagamento. Lembre-se, o customer_id necessário para essa request é o id obtidos durante a criação do cliente em Etapa 1. Além disso, inclua o provider_data contendo o token do provedor externo, conforme mostrado no trecho de código abaixo:

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}}" 
}
'

Na resposta do endpoint, você receberá um vaulted_token que identifica o método payment registrado. Esse vaulted_token será usado para pagamentos futuros, eliminando a necessidade de detalhes adicionais do método de payment .

Etapa 4: Verifique o método payment registrado (opcional)

Depois que o método payment for registrado, você poderá verificar se enrollment foi bem-sucedido usando o botão recuperar métodos payment registrados endpoint. Lembre-se, o customer_id necessário para essa request é o id obtidos durante a criação do cliente em Etapa 1.