Integração de fluxo direto

Como funciona

Se você for um desenvolvedor, poderá usar nosso Direct Flow para continuar usando seu checkout e se conectar aos nossos serviços usando apenas uma conexão de servidor para servidor.

Sua empresa deve ser certificada pelo PCI para usar nosso serviço de pagamentos com cartão de servidor para servidor. Encaminhe sua certificação AOC ao seu gerente de conta antes de iniciar a implementação.

❗️
Sempre recomendamos usar os SDKs da Yuno em vez das integrações do Direct Flow. Os SDKs da Yuno são compatíveis com PCI e simplificam o processo de pagamento gerenciando todas as complexidades, incluindo prevenção contra fraudes, 3DS e requisitos específicos do provedor de pagamento. O Direct Flow exige que os comerciantes lidem com esses aspectos manualmente, aumentando a complexidade e o risco.

Para cada implementação, recomendamos fazer o pagamento status e sub_status como a principal referência para o estado do pagamento. Um pagamento pode ter diferentes transações associado a ele, portanto, ao se concentrar no pagamento status/sub_statusCom a integração com o sistema de gerenciamento de dados, você pode ter o estado mais recente, independentemente de quantas transações foram feitas, fornecendo informações claras para a tomada de decisões. Com essa integração, você também pode registrar cartões de crédito para compras futuras (também disponível apenas para comerciantes em conformidade com a PCI).

Payment

Etapa 1: Criar um cliente

[Opcional]: A primeira etapa do fluxo de pagamento é criar um cliente. Um cliente terá métodos de pagamento associados. Você pode criar um cliente usando o seguinte endpoint. Como resultado, você receberá o ID do cliente que foi criado no Yuno DB.

Você pode pular essa etapa se já tiver criado o cliente anteriormente.

Essa etapa é opcional porque você pode enviar as informações do cliente diretamente no pagamento sem criar um objeto de cliente no Yuno.

🚧
A criação do cliente é necessária se você quiser gerar um vaulted_token.

Etapa 2: Criar o pagamento

Como você lida com toda a experiência de pagamento com essa integração, será necessário exibir os métodos de pagamento habilitados em sua conta Yuno. Depois que o usuário tiver selecionado o método de pagamento, você poderá criar um pagamento. Um pagamento reúne todos os detalhes cruciais referentes ao pedido, às especificações do cliente, ao valor total, à moeda, aos produtos, aos detalhes de envio e muito mais. Você pode criar um pagamento usando o seguinte endpoint.

Você pode usar o seção de exemplos na referência da API como uma referência. Se o usuário selecionar um método de pagamento previamente inscrito, você poderá usar a função vaulted_token retornado pelo get payment methods para criar o pagamento.

Durante a integração, recomendamos usar o status e o sub_status do pagamento como a principal referência para o estado do pagamento. Um pagamento pode ter diferentes transações associadas a ele, portanto, ao se concentrar no status/sub_status do pagamento, você pode ter o estado mais recente, independentemente de quantas transações foram feitas, fornecendo informações claras para a tomada de decisões.

Fluxo de trabalho DIRETO vs REDIRECTO

Ao usar a integração direta no Yuno, para métodos de pagamento alternativos (PSE, Nequi, MercadoPago, PIX, etc.), você tem duas opções disponíveis workflow opções:

DIRETO: Retornamos a resposta bruta dos provedores para que você possa criar a experiência como quiser com os dados não filtrados.
REDIRECIONAR: Embora também retornemos a resposta direta dos provedores, também oferecemos aos comerciantes a possibilidade de usar um link de redirecionamento fornecido pela Yuno, no qual lidamos com a experiência de pagamento apenas para esse pagamento. Você pode encontrar esse URL na seção payment_method.detail.redirect_url na resposta do pagamento.

Complementos importantes

Webhooks: Recomendamos a configuração de Webhooks em seu painel do Yuno. Os webhooks são a melhor maneira de garantir que seu sistema permaneça atualizado com o progresso e o status do pagamento. Como as notificações de eventos são acionadas automaticamente, seu sistema não precisará fazer solicitações repetidas ao Yuno.
Impressões digitais do dispositivo: As impressões digitais do dispositivo do cliente são usadas para fins de prevenção de fraudes. Elas geralmente são geradas pelo uso de JavaScript de terceiros no checkout. Se você estiver usando uma integração direta e quiser oferecer suporte a provedores de fraude no fluxo de pagamento, poderá usar esse objeto para especificar as informações necessárias. Para integrações que usam o checkout do Yuno, o valor é obtido automaticamente, portanto, não envie esse campo.
- ```
[...]
"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: Use nosso JS apenas para obter o three_d_secure_setup_id e, em seguida, lidar com o pagamento como uma única integração de API. O fluxo de trabalho Direct está disponível apenas para comerciantes em conformidade com o PCI. Ele oferece uma maneira direta de criar um pagamento e validar as informações do usuário, exigindo que o comerciante faça apenas uma solicitação para criar o pagamento. Para implementar com êxito a integração Direct, siga as etapas descritas na seção diretriz de integração e forneça as informações necessárias conforme as instruções. Esse serviço não é necessário para a implementação do 3DS usando o SDK da Yuno.

Enrollment

Etapa 1: Criar um cliente

A primeira etapa do fluxo de pagamento é criar um cliente. Um cliente terá métodos de pagamento associados. Você pode criar um cliente usando o seguinte endpoint. Como resultado, você receberá o ID do cliente que foi criado no Yuno DB.

Você pode pular essa etapa se já tiver criado o cliente anteriormente.

Etapa 2: Registre um método de pagamento

📘
Integração de fluxo direto
Esse recurso está disponível apenas para o registro de cartões para comerciantes em conformidade com o PCI.

Depois de ter seu cliente, você pode registrar o método de pagamento usando a opção endpoint Registrar método de pagamento . Com as informações fornecidas pela Yuno depois que o cliente seleciona o método de pagamento a ser registrado, você poderá salvar essas informações para compras futuras usando o vaulted_token que representa o objeto de método de pagamento criado.