Pular para o conteúdo principal
A Localpayment permite que comerciantes processem pagamentos instantâneos por meio de carteiras digitais, utilizando o sistema WalletFri da Guatemala. Este guia descreve o processo para iniciar pagamentos com o WalletFri através da API da Localpayment, detalhando os parâmetros necessários, o tratamento de respostas e a interpretação de códigos de status para uma integração perfeita com a popular plataforma de carteira digital da Guatemala.

Antes de começar

Certifique-se de ter:

Passo 1. Criar pagamento Wallet Fri

Para gerar uma solicitação de pagamento Wallet Fri, envie uma solicitação POST ao endpoint Criar Payin com parâmetros específicos do Wallet Fri.

Parâmetros-chave da solicitação

A solicitação requer vários objetos-chave específicos para pagamentos do Wallet Fri: Veja todos os parâmetros disponíveis na solicitação.

Exemplo de solicitação

Abaixo está um exemplo usando curl:
curl

Etapa 2. Lidar com a resposta

Resposta bem-sucedida

Ao criar um pagamento via Wallet Fri, o sistema envia automaticamente uma notificação push para o aplicativo Wallet Fri do cliente. A resposta da API confirma que a solicitação de pagamento foi criada com sucesso e está aguardando autorização do cliente.

Campos de resposta principais

Resposta de erro

Quando a criação de uma solicitação Wallet Fri falhar, você receberá informações detalhadas sobre o erro:

Etapa 3. Processo de Autorização do Cliente

  1. Notificação Push: O cliente recebe a solicitação de pagamento diretamente no aplicativo Wallet Fri.
  2. Notificação do aplicativo: A solicitação de pagamento aparece como uma notificação push no dispositivo móvel.
  3. Autorização no aplicativo: O cliente abre o aplicativo Wallet Fri para revisar e autorizar o pagamento.
  4. Verificação de segurança: O cliente insere um PIN ou realiza a autenticação biométrica.
  5. Confirmação de pagamento: A transação é processada instantaneamente após a autorização.
  6. Atualização de status: Seu sistema recebeu um webhook com o status final do pagamento.

Etapa 4. Acompanhe o status da transação

Acompanhe o progresso dos pagamentos do Wallet Fri 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 Wallet Fri.
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

Use o ambiente de staging para testes:

Cenários de teste do Wallet Fri

Verifique se sua integração lida com esses cenários:
  1. Pagamento bem-sucedido: O cliente recebe a notificação e autoriza o pagamento.
  2. Autorização expirada: o cliente não respondeu dentro do prazo estipulado.
  3. Atualizações de status: gerenciamento de webhooks e consulta de status.

Demonstração

A demonstração a seguir mostra como um cliente paga uma solicitação de pagamento do Wallet Fri no aplicativo, desde a solicitação pendente até o recibo de pagamento.
Animação passo a passo de um cliente pagando uma solicitação Localpayment no aplicativo Wallet Fri, desde a solicitação pendente até o recibo de pagamento

Próximos passos

Após implementar os pagamentos com a Wallet Fri, 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.
Última modificação em 10 de novembro de 2026