01 / Fluxo
Preserve a referência empresarial em cada evento
A integração é mais fácil de operar quando os registros de pagamento, jogador ou pedido e liquidação compartilham referências desde o início.
- 01
Criar a sessão
Envie o valor, a moeda, a referência empresarial e o contexto de retorno exigidos usando o formato de solicitação documentado atualmente.
- 02
Apresentar a experiência de pagamento
Direcione o cliente para o checkout ou a rota de pagamento configurada que foi devolvida para aquela sessão.
- 03
Processar os eventos documentados
Valide e trate os tipos de evento e os campos descritos na documentação atual da API.
- 04
Creditar e conciliar
Use a referência de pagamento para conectar o evento, o jogador ou pedido correto, o valor creditado e o registro da liquidação.
02 / Operações
Decisões de integração que afetam as operações
Uma integração útil faz mais do que abrir o checkout. Ela preserva as referências, estados e caminhos de falha necessários ao operador depois do lançamento.
Projeto das referências
Escolha referências estáveis de jogador, pedido ou fatura que possam ser encontradas tanto no sistema do operador quanto no registro da Payfux.
Tratamento de eventos
Processe apenas os campos e estados documentados e preserve a referência recebida para auditoria e conciliação.
Comportamento do retorno
Trate o retorno do cliente como navegação da interface, não como prova final de que um pagamento ou liquidação foi concluído.
Caminho de conciliação
Conecte os registros de pagamento e liquidação nos sistemas do operador para que diferenças possam ser investigadas pela referência.
03 / Requisitos
A documentação atual prevalece
Os exemplos comerciais descrevem a sequência de integração, mas não definem endpoints, payloads, assinaturas, novas tentativas, valores de status ou níveis de serviço de produção.
- Use apenas a autenticação e os campos de solicitação da documentação atual da API fornecida para o ambiente do cliente.
- Não trate o retorno do navegador como evidência autorizada do pagamento; use o status e o modelo de eventos do servidor documentados.
- Teste falhas, duplicidades, atrasos e mudanças de status conforme o comportamento documentado para a integração.
04 / Perguntas
Perguntas dos operadores
Onde estão os esquemas atuais da API da Payfux?
Os esquemas, requisitos de autenticação e campos de solicitação atuais estão na documentação da API da Payfux. Exemplos nas páginas de produto são explicativos e não a substituem.
O retorno do navegador deve marcar um pagamento como concluído?
Não. O retorno do cliente é navegação. O operador deve usar o status de pagamento do servidor e a evidência de eventos documentados para creditar e conciliar.
A Payfux promete uma programação específica de novas tentativas?
Nenhuma programação de novas tentativas é afirmada nesta página. Implemente o comportamento de eventos e recuperação descrito na documentação atual do cliente.
Qual referência empresarial o operador deve enviar?
Use a referência estável de jogador, cliente, fatura ou pedido exigida pela integração documentada e preserve-a no sistema do operador.
Registros de teste e produção são intercambiáveis?
Não. Mantenha separados credenciais, endpoints, registros e conciliação de cada ambiente e siga os controles informados na documentação.
Documentação para desenvolvedores
Comece pelos esquemas atuais de solicitações e eventos
Use a documentação da Payfux para consultar o comportamento exato da integração e depois alinhe as referências aos sistemas do operador.
Ler a documentação