> ## 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.

# Capture a Payment Intent

> Captura um payment intent autorizado com captura manual.

Captura um `payment_intent` em `requires_capture`. Esse estado acontece quando
o intent foi criado com `capture_method: "manual"` e a confirmação autorizou o
cartão sem liquidar a cobrança imediatamente.

Nesta versão, a captura é total: se enviar `amount_to_capture`, ele deve ser
igual a `amount_capturable`.

<ParamField path="id" type="string" required>
  ID do payment intent (`pi_*`).
</ParamField>

<ParamField body="amount_to_capture" type="integer">
  Valor em centavos a capturar. Opcional; por enquanto deve ser igual a
  `amount_capturable`.
</ParamField>

<RequestExample>
  ```bash cURL theme={}
  curl -X POST "https://api.chargefy.io/v1/payment-intents/pi_123/capture" \
    -H "Authorization: Bearer {{API_KEY}}"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={}
  {
    "id": "pi_123",
    "object": "payment_intent",
    "amount": 10528,
    "amount_capturable": 0,
    "amount_details": {
      "installment_interest": 528,
      "subtotal": 10000,
      "total": 10528
    },
    "amount_received": 10528,
    "canceled_at": null,
    "cancellation_reason": null,
    "capture_method": "manual",
    "client_secret": "pi_123_secret_abc",
    "confirmation_method": "automatic",
    "created_at": "2026-05-16T18:34:58Z",
    "currency": "brl",
    "customer": "cus_123",
    "invoice": null,
    "last_payment_error": null,
    "latest_charge": "ch_123",
    "livemode": true,
    "metadata": {},
    "next_action": null,
    "payment_method": "pm_123",
    "payment_method_options": {
      "credit_card": {
        "installments": {
          "amount_subtotal": 10000,
          "amount_total": 10528,
          "count": 3,
          "has_interest": true,
          "interest_amount": 528
        }
      }
    },
    "payment_method_types": [
      "credit_card"
    ],
    "setup_future_usage": null,
    "status": "succeeded",
    "updated_at": "2026-05-16T18:37:00Z"
  }
  ```
</ResponseExample>

## Webhooks

Uma captura bem-sucedida emite `payment.intent.succeeded`. Se o intent estiver
ligado a uma invoice aberta, também emite `invoice.paid`.