Pular para o conteúdo principal
A Localpayment permite que você processe reembolsos de Métodos de Pagamento Alternativos (APMs) tanto por meio da integração de API quanto pela interface do Business Portal. Este guia cobre o fluxo completo de reembolso para transações APM usando o fluxo de reembolsos que exigem dados.

Antes de começar

Certifique-se de ter:

Credenciais da API

Credenciais de API e token de acesso válidos para autenticação.

Configuração da conta

Configuração adequada da conta para o país de destino e verificação da empresa.

Lista branca de IPs

Adicione os endereços IP do seu servidor à lista de permissões para acesso à API.

Endpoint do webhook

Configure um URL de webhook para receber notificações de pagamento.

Requisitos adicionais para reembolso:

  • Saldo suficiente em sua conta Localpayment para cobrir o valor do reembolso.
  • Função de usuário com permissões de reembolso (consulte a documentação de Funções de Usuário).
  • A transação original deve estar com o status Completed.
  • O externalId da transação de pagamento original.
  • Preencha as informações do beneficiário para reembolsos que exigem dados.

Guia de Implementação

A Localpayment oferece dois métodos para processar reembolsos de APM: integração de API para processamento automatizado e Business Portal para operações manuais.

Processamento de reembolso via API

Processe reembolsos programaticamente através da API REST para fluxos de trabalho automatizados e integração com seus sistemas.

Processamento de reembolsos no Business Portal

Processe reembolsos manualmente através do Business Portal Localpayment com uma interface amigável.Observação: Todos os reembolsos do Business Portal exigem aprovação.

Reembolsos com base em dados necessários para APMs

Os reembolsos de APM são processados como Reembolsos que Exigem Dados, o que significa que você precisa tanto do externalId da transação original quanto das informações completas do beneficiário. Ao contrário dos reembolsos diretos, esse fluxo exige dados adicionais do pagador e do banco, pois os pagamentos via QR envolvem informações específicas do beneficiário que precisam ser verificadas.
Importante:Apenas reembolsos integrais são permitidos para transações APM. Reembolsos parciais não são suportados.

Requisitos específicos de cada país

Os reembolsos de APM têm requisitos e limitações específicos, que variam de acordo com o país e o método de pagamento. Abaixo, estão as principais considerações específicas de cada país:
  • Fluxo de reembolso: Reembolsos que exigem dados e contêm informações completas do beneficiário.
  • Tipos de documentos: Tipos de documentos argentinos suportados (CUIL, DNI, etc.).
  • Processamento: Os reembolsos são processados através das redes bancárias locais da Argentina.

Etapa 1: Processar reembolso via API

Para reembolsar um pagamento APM via API, envie uma solicitação PATCH para o endpoint Reembolso.

Parâmetros-chave da solicitação

A solicitação requer vários parâmetros-chave:

Exemplo de solicitação

Abaixo segue um exemplo de uso do curl:
curl
Veja todos os parâmetros disponíveis na solicitação.

Etapa 2: Lidar com a resposta

Resposta bem-sucedida

Um reembolso processado com sucesso retorna os detalhes da confirmação:

Campos de resposta principais

Resposta de erro

Quando um pedido de reembolso falha, você receberá as seguintes informações de erro:

Cenários de erro comuns


Reembolsos do Business Portal

Os reembolsos de APM também podem ser processados através da interface do Business Portal da Localpayment. Este método oferece um fluxo de trabalho visual para a gestão de reembolsos e é particularmente útil para:
  • Reembolsos ocasionais que não exigem automação por API.
  • Supervisão administrativa onde são necessários fluxos de trabalho de aprovação.
  • Processamento rápido de reembolsos sem necessidade de recursos de desenvolvimento.
Para obter instruções detalhadas sobre como processar reembolsos através do Business Portal, incluindo orientações passo a passo e tutoriais da interface, consulte o Guia de Reembolsos do Business Portal .
Aprovação necessária:Todos os reembolsos iniciados pelo Business Portal da Localpayment exigem aprovação através do fluxo de autorização designado. Certifique-se de ter as permissões de usuário necessárias antes de tentar efetuar reembolsos pelo Business Portal.

Etapa 3: Acompanhe o status do reembolso

Após iniciar um reembolso, acompanhe o seu progresso através destes métodos:

Webhooks (Recomendado)

Receba notificações em tempo real quando o status da transação mudar. Ideal para ambientes de produção.

Endpoint da API de Status

Consultar o status da transação programaticamente. Útil para consultar ou recuperar notificações de webhook perdidas.

Visualização do Business Portal

Interface visual para monitoramento de transações. Ideal para supervisão manual e análise detalhada de transações.

Códigos comuns de status de reembolso

Referência completaConsulte todos os códigos de status em nossa Documentação de Status da Transação.

Testando sua integração

Cenários de teste

Verifique se sua integração lida com esses cenários:
  1. Reembolso bem-sucedido: processe o reembolso com um externalId válido e fundos suficientes.
  2. Fundos insuficientes: Tentativa de reembolso devido ao saldo insuficiente na conta.
  3. Transação inválida: tente reembolsar um externalId inexistente.
  4. Reembolso duplicado: Tentativa de reembolsar uma transação que já foi reembolsada.
  5. Validação de permissões: Teste com usuários que possuem diferentes níveis de permissão.

Próximos passos

Ver o estado da transação

Consulte o status atual das transações e reembolsos usando a API de Status da Transação.

Configurar webhooks

Configure webhooks para receber notificações em tempo real sobre as mudanças de status do reembolso.

Analisar funções de usuário

Gerencie as permissões e funções dos usuários para os recursos de processamento de reembolsos.
Última modificação em 10 de novembro de 2026