Capturar um pagamento

curl -X POST "https://api.chargefy.io/v1/payment-intents/pi_y2cm3Svi1LuzDFjw/capture" \
  -H "Authorization: Bearer {{ API_KEY }}"

{
  "id": "pi_y2cm3Svi1LuzDFjw",
  "object": "payment_intent",
  "amount": 10528,
  "amount_capturable": 0,
  "amount_details": {
    "amount": 10528,
    "installment_interest_amount": 528,
    "principal_amount": 10000,
    "surcharge_amount": 0
  },
  "amount_received": 10528,
  "canceled_at": null,
  "cancellation_reason": null,
  "capture_method": "manual",
  "client_secret": "pi_y2cm3Svi1LuzDFjw_secret_428985c376eff52d4628ac40e9b0a5e469094cc857fd34fe",
  "confirmation_method": "automatic",
  "created_at": "2026-05-16T18:34:58Z",
  "currency": "brl",
  "customer": "cus_EdzZEVBHuLqkAjEm",
  "installment_interest_amount": 528,
  "installments": 3,
  "invoice": null,
  "last_payment_error": null,
  "latest_charge": "ch_oHtCc2666qFspX3s",
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": "pm_cum6zBHUgab9ZU7f",
  "payment_method_options": {
    "credit_card": {
      "installments": {
        "amount": 10528,
        "count": 3,
        "has_interest": true,
        "installment_interest_amount": 528,
        "principal_amount": 10000,
        "surcharge_amount": 0
      }
    }
  },
  "payment_method_types": [
    "credit_card"
  ],
  "principal_amount": 10000,
  "status": "succeeded",
  "surcharge_amount": 0,
  "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. A captura é total: se enviar amount_to_capture, ele deve ser igual a amount_capturable.

string

required

ID do payment intent (pi_*).

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_y2cm3Svi1LuzDFjw/capture" \
  -H "Authorization: Bearer {{ API_KEY }}"

{
  "id": "pi_y2cm3Svi1LuzDFjw",
  "object": "payment_intent",
  "amount": 10528,
  "amount_capturable": 0,
  "amount_details": {
    "amount": 10528,
    "installment_interest_amount": 528,
    "principal_amount": 10000,
    "surcharge_amount": 0
  },
  "amount_received": 10528,
  "canceled_at": null,
  "cancellation_reason": null,
  "capture_method": "manual",
  "client_secret": "pi_y2cm3Svi1LuzDFjw_secret_428985c376eff52d4628ac40e9b0a5e469094cc857fd34fe",
  "confirmation_method": "automatic",
  "created_at": "2026-05-16T18:34:58Z",
  "currency": "brl",
  "customer": "cus_EdzZEVBHuLqkAjEm",
  "installment_interest_amount": 528,
  "installments": 3,
  "invoice": null,
  "last_payment_error": null,
  "latest_charge": "ch_oHtCc2666qFspX3s",
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": "pm_cum6zBHUgab9ZU7f",
  "payment_method_options": {
    "credit_card": {
      "installments": {
        "amount": 10528,
        "count": 3,
        "has_interest": true,
        "installment_interest_amount": 528,
        "principal_amount": 10000,
        "surcharge_amount": 0
      }
    }
  },
  "payment_method_types": [
    "credit_card"
  ],
  "principal_amount": 10000,
  "status": "succeeded",
  "surcharge_amount": 0,
  "updated_at": "2026-05-16T18:37:00Z"
}

Resultado não confirmado

Se a rede receber a captura, mas a resposta se perder, a API retorna 502 com code: "payment_result_unconfirmed". Não envie outra captura: consulte o Payment Intent e aguarde payment.intent.succeeded antes de decidir o próximo passo.

502

{
  "error": {
    "code": "payment_result_unconfirmed",
    "message": "The payment result is not confirmed yet. Do not submit the operation again.",
    "type": "api_error"
  }
}

Erros definitivos usam o código específico do catálogo, como authorization_expired, charge_already_captured ou capture_method_not_supported, em vez de uma falha genérica do provider.

Webhooks

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

Confirmar com captura manual

Como o intent chega a requires_capture.

Evento de sucesso

Payload completo para liberar o pedido após a captura.

curl -X POST "https://api.chargefy.io/v1/payment-intents/pi_y2cm3Svi1LuzDFjw/capture" \
  -H "Authorization: Bearer {{ API_KEY }}"

{
  "id": "pi_y2cm3Svi1LuzDFjw",
  "object": "payment_intent",
  "amount": 10528,
  "amount_capturable": 0,
  "amount_details": {
    "amount": 10528,
    "installment_interest_amount": 528,
    "principal_amount": 10000,
    "surcharge_amount": 0
  },
  "amount_received": 10528,
  "canceled_at": null,
  "cancellation_reason": null,
  "capture_method": "manual",
  "client_secret": "pi_y2cm3Svi1LuzDFjw_secret_428985c376eff52d4628ac40e9b0a5e469094cc857fd34fe",
  "confirmation_method": "automatic",
  "created_at": "2026-05-16T18:34:58Z",
  "currency": "brl",
  "customer": "cus_EdzZEVBHuLqkAjEm",
  "installment_interest_amount": 528,
  "installments": 3,
  "invoice": null,
  "last_payment_error": null,
  "latest_charge": "ch_oHtCc2666qFspX3s",
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": "pm_cum6zBHUgab9ZU7f",
  "payment_method_options": {
    "credit_card": {
      "installments": {
        "amount": 10528,
        "count": 3,
        "has_interest": true,
        "installment_interest_amount": 528,
        "principal_amount": 10000,
        "surcharge_amount": 0
      }
    }
  },
  "payment_method_types": [
    "credit_card"
  ],
  "principal_amount": 10000,
  "status": "succeeded",
  "surcharge_amount": 0,
  "updated_at": "2026-05-16T18:37:00Z"
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Capturar um pagamento

Resultado não confirmado

Webhooks

Confirmar com captura manual

Evento de sucesso

​Resultado não confirmado

​Webhooks

Confirmar com captura manual

Evento de sucesso

Resultado não confirmado

Webhooks