Pular para o conteúdo principal
Aprenda como fazer seu primeiro pagamento de teste usando a API Localpayment e entenda os conceitos essenciais para executar fluxos de pagamento seguros em seu ambiente de sandbox. Comece fazendo seu primeiro pagamento de teste com a API Localpayment no ambiente sandbox. Você autenticará suas solicitações, explorará os métodos de pagamento disponíveis, executará um pagamento com cartão, gerenciará webhooks e verificará o status final da transação.

Visão geral

O Localpayment Sandbox é uma plataforma de testes completa que espelha nosso ambiente de produção sem processar transações reais. Ele oferece um espaço seguro para testar sua integração em diversos métodos de pagamento, moedas e países antes de entrar em produção.

Ambiente de Sandbox

Utilize nosso endpoint de API sandbox dedicado para todas as atividades de teste.

Dados de teste

Acesse cartões e contas de teste abrangentes para todos os cenários.

Simulação em tempo real

Receba notificações instantâneas via webhook para todas as transações de teste.

Referência da API

Explore nossa documentação completa da API com exemplos.

Antes de começar

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 de webhook

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

Passo 1: Gerar Token de Acesso

Para interagir com a API da Localpayment, você precisa de um token de acesso para autenticação. Esse token é obrigatório para todas as solicitações à API. Para gerar um token de acesso, você precisará fazer uma solicitação POST ao endpoint Gerar um token de acesso com o username e a password da sua conta Localpayment incluídos no corpo da solicitação como um objeto JSON.

Exemplo de solicitação

curl

Resposta bem-sucedida

ImportanteUse o token access da resposta em todas as solicitações subsequentes à API. Inclua-o no cabeçalho Authorization como Bearer <your_access_token>. Os tokens expiram por motivos de segurança - use o token de atualização para obter novos tokens de acesso sem precisar se autenticar novamente.

Etapa 2: Recuperar os métodos de pagamento disponíveis

Antes de criar um pagamento, verifique quais métodos de pagamento estão disponíveis para sua conta e país de destino. Para obter os métodos de pagamento disponíveis, envie uma solicitação GET ao endpoint Obter Métodos de Pagamento Disponíveis, incluindo seu accountNumber como parâmetro de consulta.

Exemplo de solicitação

curl

Resposta bem-sucedida

Para pagamentos com cartão, procure métodos de pagamento em que paymentMethodType seja CreditCard ou DebitCard. Observe o valor de code (por exemplo, 1000 para Visa na Argentina), pois você precisará dele na solicitação de pagamento.

Etapa 3: Criar uma solicitação de pagamento

Agora você está pronto para criar seu primeiro pagamento de teste. Usaremos um pagamento com cartão de crédito para a Argentina como exemplo. Para criar um pagamento com cartão de crédito, envie uma solicitação POST para o endpoint Criar Payin, incluindo seu token access no cabeçalho Authorization.

Campos de solicitação principais

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

Exemplo de solicitação

Veja abaixo um exemplo usando curl:
curl

Resposta bem-sucedida

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

Campos de resposta principais


Etapa 4: Lidar com notificações de webhook

Os webhooks fornecem notificações em tempo real sobre alterações no status das transações. Configure o URL do seu webhook no Business Portal da Localpayment para receber essas notificações.

Exemplo de payload de webhook

Dica de implementação:Seu endpoint de webhook deve retornar imediatamente um status 200 OK ao receber o webhook e, em seguida, processar a notificação de forma assíncrona para evitar timeouts.

Etapa 5: Rastrear o status da transação

Você pode verificar proativamente o status da transação usando o endpoint Obter Status da Transação. Envie uma solicitação GET, substituindo {externalId} pelo seu identificador de transação exclusivo para obter o status da transação.

Exemplo de solicitação

curl

Resposta bem-sucedida

Códigos de status comuns

ImportanteSempre verifique o campo status.code para determinar o resultado da transação. Para a lista completa dos possíveis status da transação, consulte a referência de status completa.

Testando diferentes métodos de pagamento

O Localpayment oferece suporte a vários métodos de pagamento além de cartões de crédito. Cada método possui parâmetros de solicitação e estruturas de resposta específicos. Abaixo, seguem exemplos para transferências bancárias com as principais diferenças destacadas.
As transferências bancárias permitem que os clientes paguem diretamente de suas contas bancárias por meio de sistemas de pagamento locais.

Exemplo de solicitação

Principais diferenças entre os pedidos de transferência bancária

Resposta bem-sucedida

Principais diferenças nas respostas para transferências bancárias


Próximos passos

Explore as opções de Payins

Descubra todos os métodos de pagamento disponíveis, incluindo cartões e APMs.

Explore as opções de Payouts

Saiba mais sobre como enviar pagamentos para contas bancárias e carteiras digitais.

Descubra a cobertura do país

Verifique os métodos de pagamento disponíveis, as moedas e os requisitos específicos para cada país.

Referência da API

Acesse a documentação completa da API com endpoints, parâmetros e exemplos de código.
Última modificação em 10 de novembro de 2026