Skip to main content
curl -X POST "https://api.chargefy.io/v1/payment-intents/pi_123/capture" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "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"
}
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.
​
id
string
required
ID do payment intent (pi_*).
​
amount_to_capture
integer
Valor em centavos a capturar. Opcional; por enquanto deve ser igual a amount_capturable.
curl -X POST "https://api.chargefy.io/v1/payment-intents/pi_123/capture" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "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"
}

​
Webhooks

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