Pular para o conteúdo principal
Algumas transações de pagamento exigem autorização adicional antes de serem processadas. Este guia explica quando a autorização é necessária e como aprovar pagamentos por meio de diferentes métodos.

Quando a autorização é necessária

É necessária autorização adicional para pagamentos realizados nessas condições:
  • Payouts via API: criados via API com o parâmetro requireAuth definido como true.
  • Payouts no Business Portal: criados diretamente no Business Portal do Localpayment.

Métodos de autorização

O método para autorizar pagamentos depende de como eles foram criados originalmente: Pagamentos criados no Business Portal Para payouts criados no Business Portal, um segundo usuário com permissões de autorização deve autorizar. Pagamentos criados por API Para pagamentos criados via API, use o endpoint Authorize Payout para aprovar transações programaticamente.

Pré-requisitos

Antes de autorizar pagamentos, certifique-se de que você tem:
  • Uma transação de payout inicializada com status PendingAuth
  • Credenciais de API válidas com permissões de autorização
  • O identificador da transação (internalId ou externalId) ou o intervalo de datas para autorização em lote

Autorização de pagamentos via API

Endpoint

Autenticação

Inclua seu token de acesso nos cabeçalhos da solicitação:

Parâmetros-chave da solicitação

Você pode autorizar pagamentos usando um dos três métodos a seguir:
Escolha um método de autorizaçãoUse um ID de transação específico (internalId ou externalId) para transações individuais, ou um intervalo de datas (dateFrom e dateTo) para autorização em lote.

Exemplos de solicitações


Tratamento de Respostas

Resposta bem-sucedida

Quando a autorização for bem-sucedida, você receberá:

Campos de resposta principais

Respostas de erro

Erros de validação

Melhores práticas

  • Sempre verifique os detalhes da transação antes da autorização.
  • Use HTTPS para todas as requisições de API
  • Armazene os tokens de acesso com segurança.
  • Implemente um tratamento de erros e um registro de logs adequados
  1. Criar Payout: Gere o payout com requireAuth=true
  2. Verificar status: Confirme que o status da transação é PendingAuth
  3. Detalhes da revisão: Validar informações da transação
  4. Autorizar: Chame o endpoint de autorização.
  5. Lidar com a resposta: Processar as respostas de sucesso/erro adequadamente.
  6. Monitorar: Rastrear alterações no status das transações via webhooks

Recursos e próximos passos

Maximize o sucesso da sua integração com estes recursos essenciais.

Integração de Webhook

Configure notificações em tempo real para atualizações do status das transações.

Relatórios do Business Portal

Acesse análises detalhadas, ferramentas de geração de relatórios e recursos de conciliação.

Monitoramento de transações

Aprenda a consultar o status das transações e a implementar um rastreamento abrangente.

Referência da API

Documentação completa dos endpoints com exemplos interativos.

Dica profissionalSempre teste seu fluxo de trabalho em nosso ambiente de sandbox antes de implantá-lo em produção. Isso garante que o tratamento de erros, o processamento de webhooks e o rastreamento de status funcionem corretamente em todos os cenários.

Precisa de ajuda?Entre em contato com nossa equipe de suporte caso encontre algum problema ou precise de ajuda com a integração.

Última modificação em 10 de novembro de 2026