Antes de começar
Certifique-se de ter:- Credenciais de API válidas (token de acesso).
Passo 1. Criar pagamento por QR Code
Para gerar um código QR para cobrança de pagamentos, envie uma solicitaçãoPOST ao endpoint Criar Payin com parâmetros específicos de QR Code.
Não é necessário enviar os dados bancários do pagador na solicitação. O cliente seleciona sua conta bancária ao escanear o código QR com o aplicativo do banco.
Parâmetros-chave da solicitação
A solicitação requer vários objetos-chave específicos para pagamentos por QR Code:
Veja todos os parâmetros disponíveis na solicitação.
Exemplo de solicitação
Abaixo está um exemplo usandocurl:
curl
Etapa 2. Lidar com a resposta
Resposta bem-sucedida
A criação bem-sucedida de um pagamento por QR Code inclui os dados do código QR e os detalhes do pagamento:Campos de resposta principais
Resposta de erro
Quando a geração do QR Code falhar, você receberá informações detalhadas sobre o erro:Etapa 3. Exibir o código QR e processar o pagamento
- Exibição de QR Code: Apresente o código QR ao cliente através do canal escolhido.
- Leitura do código QR pelo aplicativo bancário: O cliente escaneia o código QR com o aplicativo móvel do seu banco argentino.
- Autorização de pagamento: O cliente confirma o pagamento em seu ambiente bancário.
- Confirmação em tempo real: o Localpayment recebe notificação de pagamento instantaneamente.
- Atualização de status: Seu sistema recebeu um webhook com a confirmação de pagamento.

Melhores práticas para exibição de QR Code
- Tamanho mínimo de exibição: 250x250 pixels para digitalização em dispositivos móveis.
- Mantenha a proporção de 1:1 sem distorção.
- Garanta alto contraste (escuro sobre fundo claro).
- Adicione uma zona de silêncio (borda branca) ao redor do código QR.
- Inclua um texto alternativo (ex.: “Pagamento por código QR”).
- Exibir instruções de pagamento claras.
- Gerenciar o tempo de vida (TTL) e a expiração.
Etapa 4. Acompanhe o status da transação
Acompanhe o progresso do pagamento por QR Code 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
A API Localpayment fornece vários códigos de status para indicar o progresso e o resultado do pagamento na resposta.Referência completaConsulte todos os códigos de status em nossa Documentação de Status da Transação.
Testando sua integração
Ambiente de Sandbox
Utilize o ambiente de teste para realizar os procedimentos:Cenários de teste de QR
Verifique se sua integração lida com esses cenários:- Pagamento concluído com sucesso: Leitura do código QR e fluxo de pagamento finalizados.
- Expiração de QR Code: Lide com códigos QR expirados de forma adequada.
- Múltiplas tentativas de pagamento: o mesmo código QR foi lido várias vezes.
- Atualizações de status: gerenciamento de webhooks e consulta de status.
Próximos passos
Após implementar pagamentos por QR Code, considere estas funcionalidades adicionais:Reembolsar a transação
Caso necessário, você pode reembolsar o pagamento ao cliente. Consulte a documentação para obter detalhes.
Analisar detalhes da transação
Você pode obter informações detalhadas sobre as transações usando a API Localpayment.

