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].
Objeto request
Este é o formato retornado emget e itens de list.
string
Identificador do request. Usa o prefixo
req_*.string
Sempre
"request".object
Quem originou a chamada.
string | null
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_....string | null
Quando a resposta terminou de ser processada.
null enquanto o request ainda
está pending.string
Quando a Chargefy recebeu a chamada.
integer | null
Duração total da chamada em milissegundos.
object | null
Erro público retornado pela API, quando a chamada falhou. Em chamadas de
sucesso, vem
null.string | null
Endereço IP de origem, quando disponível.
boolean
true em produção; false em ambiente de teste.object
Metadados associados ao request log. Quando vazio, retorna
{}.string
Método HTTP recebido, como
GET, POST ou DELETE.string | 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.
string
Path chamado na API, sem domínio.
object
Query string parseada como objeto. Quando não há query, retorna
{}.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.
object | array | string | null
Body recebido, depois de mascarar dados sensíveis. Uploads multipart não
armazenam o arquivo, só metadados seguros.
string | null
Tipo do body recebido, como
json, form, multipart ou text.object
Headers recebidos, com credenciais mascaradas.
string
URL do dashboard para abrir o request log.
object | array | string | null
Body retornado pela API, depois de mascarar dados sensíveis.
string | null
Tipo do body retornado.
object
Headers retornados pela API, com valores sensíveis mascarados quando houver.
string
Superfície que originou o request.
string
Estado do request log.
integer | null
Status HTTP retornado, como
200, 400, 402 ou 500.string | null
Data da última atualização do log.
string | null
User agent informado pelo cliente HTTP.
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.