Antes de começar
Certifique-se de ter:- Credenciais de API válidas (token de acesso).
Passo 1. Criar pagamento Wallet Fri
Para gerar uma solicitação de pagamento Wallet Fri, envie uma solicitaçãoPOST 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 usandocurl:
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
- Notificação Push: O cliente recebe a solicitação de pagamento diretamente no aplicativo Wallet Fri.
- Notificação do aplicativo: A solicitação de pagamento aparece como uma notificação push no dispositivo móvel.
- Autorização no aplicativo: O cliente abre o aplicativo Wallet Fri para revisar e autorizar o pagamento.
- Verificação de segurança: O cliente insere um PIN ou realiza a autenticação biométrica.
- Confirmação de pagamento: A transação é processada instantaneamente após a autorização.
- 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:- Pagamento bem-sucedido: O cliente recebe a notificação e autoriza o pagamento.
- Autorização expirada: o cliente não respondeu dentro do prazo estipulado.
- 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.
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.

