request registra uma chamada HTTP recebida pela Chargefy. Ele funciona como um log estruturado da integração: quem chamou, qual endpoint foi usado, qual payload entrou, qual resposta saiu, quanto tempo levou e quais objetos ficaram relacionados à chamada.
Use esse objeto para depurar integrações sem depender só de logs internos do seu servidor. Ele ajuda a responder perguntas como: “por que esse pagamento falhou?”, “qual payload enviamos?”, “a API respondeu 400 ou 402?”, “essa tentativa criou qual payment_intent?”, ou “por que um webhook chegou depois?”.
Dados sensíveis são mascarados antes de serem salvos. Headers de autenticação, API keys, tokens, CVC, números brutos de cartão e segredos aparecem como [redacted].
Disponibilidade dos registros
ConsultasGET e HEAD feitas pela API ou pelo MCP, incluindo as recusadas na
borda, ficam disponíveis por 30 dias. O prazo é o mesmo quando a consulta
retorna um erro. As demais requisições, incluindo visitas às páginas hospedadas,
ficam disponíveis por 1 ano (365 dias).
A retirada ocorre diariamente, por dias completos em UTC, depois que o prazo
termina. Os registros retirados deixam de aparecer na listagem e a consulta
pelo ID retorna 404. Os arquivos históricos são de uso interno e não ficam
disponíveis pela API ou pelo console.
Objeto request
Este é o formato retornado emget e itens de list.
ID público da API key usada na chamada, no formato
key_..., quando houver.
Este valor identifica o objeto e não é a credencial secreta ch_....Quando a resposta terminou de ser processada.
null enquanto o request ainda
está pending.Erro público retornado pela API, quando a chamada falhou. Em chamadas de
sucesso, vem
null.Organização para a qual a chamada foi feita. Em operações de plataforma sem
uma única organização-alvo, identifica a organização dona da plataforma.
Objetos públicos ligados à chamada, na ordem em que a Chargefy conseguiu associar. Use para sair do request log para o recurso que foi criado, atualizado ou consultado.
Body recebido, depois de mascarar dados sensíveis. Uploads multipart não
armazenam o arquivo, só metadados seguros.
Use cases
Segurança
O request log é feito para depuração e auditoria, não para armazenar segredo. Nunca dependa dele como fonte autoritativa de dados de cartão, tokens ou credenciais. Esses valores são mascarados como[redacted] antes de serem persistidos ou exibidos pela API.
