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çãoPOST 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
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çãoGET 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çãoPOST 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 usandocurl:
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çãoGET, 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
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.- Pagamentos por Transferência Bancária
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.

