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

{
  "id": "pi_123",
  "object": "payment_intent",
  "amount": 9990,
  "amount_capturable": 0,
  "amount_details": {
    "installment_interest": 0,
    "subtotal": 9990,
    "total": 9990
  },
  "amount_received": 0,
  "canceled_at": "2026-05-16T19:00:00Z",
  "cancellation_reason": "requested_by_customer",
  "capture_method": "automatic",
  "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": null,
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": "pm_123",
  "payment_method_options": {
    "credit_card": {
      "installments": {
        "amount_subtotal": 9990,
        "amount_total": 9990,
        "count": 1,
        "has_interest": true,
        "interest_amount": 0
      }
    }
  },
  "payment_method_types": [
    "credit_card"
  ],
  "setup_future_usage": null,
  "status": "canceled",
  "updated_at": "2026-05-16T19:00:00Z"
}
Cancela um payment_intent que ainda não está concluído.
​
id
string
required
ID do payment intent (pi_*).
​
cancellation_reason
string
duplicate, fraudulent, requested_by_customer ou abandoned.
curl -X POST "https://api.chargefy.io/v1/payment-intents/pi_123/cancel" \
  -H "Authorization: Bearer {{API_KEY}}"

​
Resposta

200 OK com o objeto payment_intent completo — mesmo shape de GET /v1/payment-intents/:id — agora com status: "canceled", canceled_at preenchido e cancellation_reason ecoando o motivo enviado. 
{
  "id": "pi_123",
  "object": "payment_intent",
  "amount": 9990,
  "amount_capturable": 0,
  "amount_details": {
    "installment_interest": 0,
    "subtotal": 9990,
    "total": 9990
  },
  "amount_received": 0,
  "canceled_at": "2026-05-16T19:00:00Z",
  "cancellation_reason": "requested_by_customer",
  "capture_method": "automatic",
  "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": null,
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": "pm_123",
  "payment_method_options": {
    "credit_card": {
      "installments": {
        "amount_subtotal": 9990,
        "amount_total": 9990,
        "count": 1,
        "has_interest": true,
        "interest_amount": 0
      }
    }
  },
  "payment_method_types": [
    "credit_card"
  ],
  "setup_future_usage": null,
  "status": "canceled",
  "updated_at": "2026-05-16T19:00:00Z"
}

​
Erros comuns

StatuscodeQuando ocorre
404resource_missingO payment intent não existe nesta organização.
409resource_state_conflictO payment intent já está concluído ou cancelado.