Payouts

O Yuno Payouts é uma solução de API projetada para simplificar o processo de envio de pagamentos seguros para vários beneficiários, como usuários, comerciantes, provedores e clientes. Com o Yuno Payouts, você pode distribuir fundos com eficiência para vários destinatários, garantindo sua segurança e assumindo o controle total de suas operações de pagamento.

A solução Yuno Payout permite criar solicitações de pagamento sem restrições quanto ao número de registros. Você pode realizar pagamentos para qualquer banco, cartão ou carteira. As opções de pagamento são limitadas apenas pelo provedor que você escolher usar.

Benefícios de usar o Yuno Payouts

Centralização: O serviço Payout economiza tempo e custos ao centralizar todas as suas operações de pagamento em um único local. Você não precisa mais gerenciar pagamentos em vários sistemas ou interfaces.
Informações: Mantenha-se informado sobre os status dos pagamentos com nossas notificações personalizáveis. Você pode receber atualizações em tempo real sobre quaisquer alterações no status da ordem de pagamento, de acordo com suas preferências.
Localização: Ao depositar fundos diretamente nas contas bancárias locais de seus parceiros, você pode pagá-los na moeda de preferência deles, eliminando a necessidade de conversões em moeda estrangeira e poupando-os de taxas e impostos extras.

Como funcionam os pagamentos

Um pagamento no Yuno pode passar por alguns estados diferentes, começando com sua criação. Quando você cria um pagamento, ele recebe automaticamente o status CREATED automaticamente. No entanto, o status CREATED é temporário. À medida que a Yuno verifica e transfere as informações para o provedor, o status do pagamento muda para PENDING.

Quando o pagamento muda para PENDING uma série de ações é executada, definindo se o pagamento será bem-sucedido, se os fundos serão transferidos ou se ele será bloqueado. Abaixo, você encontra a descrição de cada um dos possíveis estados finais:

SUCCEEDED: O provedor valida a transação e os fundos são transferidos com sucesso para a conta do beneficiário. Você receberá uma notificação de confirmação.
REJECTED: O pagamento não foi processado devido a problemas que a Yuno identificou antes de tentar a transferência. Os possíveis motivos para um pagamento rejeitado incluem fundos insuficientes ou detalhes de pagamento incorretos, como um número de conta errado. Você precisará criar um novo pagamento para realizar a transação.
DECLINED: O pagamento foi tentado, mas o provedor se recusou a aceitá-lo. Os motivos para um pagamento recusado incluem uma conta de beneficiário congelada ou fechada ou o fato de a transação ter sido sinalizada como uma possível fraude. Você precisará criar um novo pagamento para realizar a transação.

Saiba mais sobre o status do pagamento na página Status dos pagamentos.

Novos conceitos

Beneficiário: Equivale ao cliente para pagamentos. É o objeto que recebe as informações do beneficiário para o pagamento. Exemplo: Se o pagamento for para pagamentos de salário, o beneficiário seria o funcionário que está recebendo o salário.
Método de saque: Semelhante aos Payins, em que as informações sobre o método de pagamento correspondente devem ser preenchidas para o pagamento, nos payouts, as informações sobre o método de saque a ser usado para o pagamento devem ser preenchidas. Dentro disso, as informações correspondentes devem ser enviadas dependendo da categoria do método de saque, que pode ser cartões, transferências bancárias ou carteiras.

Como usar os pagamentos da Yuno

O recurso Yuno Payouts está disponível por meio da API do Yuno. Você pode usar a API para criar e recuperar informações de pagamento. Para usar a solução Payouts, você precisa atender aos seguintes requisitos:

Você precisa de uma conta Yuno.
Você precisa fazer a integração com a API do Yuno.
Ter uma conta em um provedor externo que ofereça suporte a pagamentos.

Para usar a solução Payouts, você precisará seguir as etapas abaixo:

Configure as credenciais do provedor na seção Seção de conexões em seu painel de controle do Yuno.
1. [Opcional] - E um URL de webhook para receber notificações sobre atualizações nas transações de pagamento.
Crie o pagamento usando o endpoint Create Payout. Você precisa fornecer as informações do beneficiário, o valor e o método de retirada para fazer o pagamento.
A Yuno verificará as informações e enviará a solicitação de pagamento ao provedor. O provedor analisará os fundos disponíveis para autorizar o pagamento.
Para verificar o status atual dos pagamentos, você pode usar uma das seguintes opções:
- O Recuperar Payout por ID informando o endpoint id recebido após a criação do pagamento.
- O Recuperar Payout por referência do comerciante informando o endpoint merchant_reference fornecido ao criar o pagamento.

🚧
Disponibilidade de pagamentos da Yuno
O Yuno Payouts requer uma análise de segurança e risco. Para saber mais sobre o Yuno Payouts, verificar o suporte do provedor ou solicitar a ativação, entre em contato com a equipe de suporte da Yuno.

Pagamentos referenciados

Os pagamentos podem ser feitos para diferentes métodos de pagamento, como contas bancárias e até mesmo cartões, dependendo do provedor. Para pagamentos a um método de pagamento com cartão em que o comerciante não tem as informações do cartão de crédito (por não estar em conformidade com o PCI), a Yuno permite que eles enviem o pagamento se o cartão tiver sido usado anteriormente em um pagamento. Isso é chamado de "Pagamento referenciado".

Para poder usar isso, você precisará primeiro cobrar o cliente usando uma de nossas soluções compatíveis com PCI (Any Yuno SDK) e, em seguida, fazer um Payout indicando a transação original onde podemos encontrar as informações do cartão de crédito.

"withdrawal_method": {
    "type": "STP_PAYOUT",
    "provider_id": "STP",
    "original_transaction_id":"9104911d-5df9-429e-8488-ad41abea1a4b"
  }