Pular para o conteúdo principal
Envie fundos via carteira usando a API da Localpayment. Este guia abrange tudo o que você precisa saber sobre como criar payouts, lidar com respostas, gerenciar o status da transação e atender aos requisitos específicos de cada país. Os payouts para carteira permitem que você envie fundos diretamente para a carteira digital do beneficiário. Você pode iniciar essas transferências por meio de: Este guia se concentra na implementação da API, abrangendo todo o fluxo, da inicialização à conclusão.

Antes de começar

Certifique-se de ter:

Etapa 1: Inicializar a transação de payout

Para criar um payout para carteira, envie uma solicitação POST ao endpoint Create a Payout com paymentMethod.type definido como Wallet.

Endpoint

Cabeçalhos obrigatórios

Parâmetros-chave da solicitação

A solicitação requer vários objetos-chave:

Exemplo de solicitação (Bolívia)

curl

Etapa 2: Lidar com a resposta

Resposta bem-sucedida

Uma resposta bem-sucedida inclui informações detalhadas sobre a transação e identificadores de rastreamento:

Campos de resposta principais

Resposta de erro

Quando uma solicitação falhar, você receberá informações detalhadas sobre o erro:

Etapa 3: Rastrear o status da transação

Após efetuar um payout, 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 de status comuns

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

Etapa 4: Aprovação da transação

Para maior segurança, certas transações exigem a aprovação de duas pessoas:
  1. Iniciador: Envia o pedido de payout.
  2. Aprovador: Analisa e confirma a transação.
Este processo pode ser gerenciado através do Business Portal ou dos endpoints da API.
Nota de segurançaOs requisitos de aprovação ajudam a prevenir transações não autorizadas e a garantir a conformidade com as regulamentações locais.

Requisitos específicos de cada país

Os detalhes de implementação variam de país para país. Qualquer país não mencionado explicitamente segue o procedimento padrão sem requisitos especiais. Consulte esses requisitos antes da integração:
Pagamentos YAPE:
  • paymentMethod.code: Defina como 0021.
  • beneficiary.bank.code: Defina como 990.
  • beneficiary.bank.account.alias: Deve conter o número de telefone do beneficiário no formato +591XXXXXXXX (formato internacional completo).
  • Omita os seguintes campos: beneficiary.bank.account.type e beneficiary.bank.account.number.


Testando sua integração

Ambiente de Sandbox

Utilize o ambiente de teste para realizar os procedimentos:

Cenários de teste

Verifique se sua integração lida com esses cenários:
  1. Transação bem-sucedida: Fluxo de payout padrão
  2. Erros de validação: conta bancária inválida, campos ausentes
  3. Atrasos no processamento: transações que levam tempo para serem processadas.
  4. Transações com falha: Fundos insuficientes, beneficiários bloqueados
  5. Atualizações de status: gerenciamento de webhooks e consulta de status.

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.

Precisar 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