> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> O objeto Request

Um `request` registra uma chamada HTTP recebida pela Chargefy. Use esse objeto
para investigar integrações, respostas de erro, latência e payloads enviados.

## Objeto request

<ResponseExample>
  ```json theme={}
  {
    "id": "req_123",
    "object": "request",
    "actor": {
      "id": "sk_live_123",
      "type": "api_key"
    },
    "api_key": "sk_live_123",
    "completed_at": "2026-05-27T14:09:28Z",
    "created_at": "2026-05-27T14:09:27Z",
    "duration_ms": 184,
    "error": null,
    "ip_address": "203.0.113.10",
    "livemode": true,
    "metadata": {},
    "method": "POST",
    "path": "/v1/payment-intents",
    "query": {},
    "related_objects": [
      {
        "id": "pi_123",
        "object": "payment_intent"
      }
    ],
    "request_body": {
      "amount": 9900,
      "currency": "brl",
      "payment_method_types": [
        "credit_card"
      ]
    },
    "request_body_type": "json",
    "request_headers": {
      "authorization": "[redacted]",
      "content-type": "application/json"
    },
    "request_log_url": "https://dashboard.chargefy.io/request-logs/req_123",
    "response_body": {
      "id": "pi_123",
      "object": "payment_intent",
      "amount": 9900,
      "amount_capturable": 0,
      "amount_details": {},
      "amount_received": 0,
      "canceled_at": null,
      "cancellation_reason": null,
      "capture_method": "automatic",
      "client_secret": "[redacted]",
      "confirmation_method": "automatic",
      "created_at": "2026-05-27T14:09:27Z",
      "currency": "brl",
      "customer": null,
      "invoice": null,
      "last_payment_error": null,
      "latest_charge": null,
      "livemode": true,
      "metadata": {},
      "next_action": null,
      "payment_method": null,
      "payment_method_options": {},
      "payment_method_types": [
        "credit_card"
      ],
      "setup_future_usage": null,
      "status": "requires_payment_method",
      "updated_at": "2026-05-27T14:09:27Z"
    },
    "response_body_type": "json",
    "response_headers": {
      "content-type": "application/json"
    },
    "source": "api",
    "status": "succeeded",
    "status_code": 200,
    "updated_at": "2026-05-27T14:09:28Z",
    "user_agent": "curl/8.7.1"
  }
  ```
</ResponseExample>

<ResponseField name="id" type="string">
  ID único do request (`req_*`).
</ResponseField>

<ResponseField name="object" type="string">
  Sempre `request`.
</ResponseField>

<ResponseField name="actor" type="object">
  Quem originou a chamada.
</ResponseField>

<ResponseField name="api_key" type="string | null">
  ID da API key usada na chamada, quando houver.
</ResponseField>

<ResponseField name="method" type="string">
  Método HTTP recebido.
</ResponseField>

<ResponseField name="path" type="string">
  Path chamado.
</ResponseField>

<ResponseField name="request_body" type="object | array | string | null">
  Body recebido. Credenciais e segredos são redigidos antes de persistir.
</ResponseField>

<ResponseField name="response_body" type="object | array | string | null">
  Body retornado. Credenciais e segredos são redigidos antes de persistir.
</ResponseField>

<ResponseField name="request_log_url" type="string">
  Link para abrir o request no dashboard.
</ResponseField>

<ResponseField name="status" type="string">
  `pending`, `succeeded` ou `failed`.
</ResponseField>

<ResponseField name="status_code" type="integer | null">
  Status HTTP retornado.
</ResponseField>

## Segurança

Headers de autenticação, API keys, tokens, senhas, CVC, números brutos de cartão
e segredos são armazenados como `[redacted]`. Uploads multipart não armazenam o
arquivo binário; apenas metadados do payload.