Cancelar cadastro de cartão

curl -X POST "https://api.chargefy.io/v1/setup-intents/seti_HBKurDs4uU8tk9uy/cancel" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "id": "seti_HBKurDs4uU8tk9uy",
  "object": "setup_intent",
  "canceled_at": "2026-08-06T18:30:00Z",
  "cancellation_reason": "abandoned",
  "client_secret": "seti_HBKurDs4uU8tk9uy_secret_99492c471003a5b63fcff811e4c67b455ed53e8dafe7d211",
  "created_at": "2026-08-06T18:00:00Z",
  "customer": "cus_AAMdwCYQ7FEPFrBX",
  "last_setup_error": null,
  "latest_attempt": null,
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": null,
  "payment_method_types": [
    "credit_card"
  ],
  "status": "canceled",
  "updated_at": "2026-08-06T18:30:00Z",
  "usage": "off_session"
}

{
  "error": {
    "code": "resource_state_conflict",
    "message": "Setup intent cannot be canceled in its current status",
    "type": "invalid_request_error"
  }
}

Cancela um cadastro de cartão (setup_intent) que ainda não foi concluído. Isso não remove cartões já salvos e não cancela cobranças ou assinaturas. Se uma assinatura apontava para este cadastro em pending_setup_intent, a Chargefy remove o vínculo e emite subscription.updated. A assinatura continua no estado atual e sem um novo cartão; inicie outro cadastro se ainda quiser coletá-lo.

string

required

ID do setup intent (seti_*).

string

Motivo do cancelamento, registrado no objeto para consulta posterior.

abandoned — o comprador não concluiu a coleta e o fluxo foi abandonado.
requested_by_customer — o cliente pediu para não salvar o método.
duplicate — o setup intent era duplicado; outro já cobre a mesma coleta.

curl -X POST "https://api.chargefy.io/v1/setup-intents/seti_HBKurDs4uU8tk9uy/cancel" \
  -H "Authorization: Bearer {{API_KEY}}"

Resposta

200 OK com status: "canceled".

{
  "id": "seti_HBKurDs4uU8tk9uy",
  "object": "setup_intent",
  "canceled_at": "2026-08-06T18:30:00Z",
  "cancellation_reason": "abandoned",
  "client_secret": "seti_HBKurDs4uU8tk9uy_secret_99492c471003a5b63fcff811e4c67b455ed53e8dafe7d211",
  "created_at": "2026-08-06T18:00:00Z",
  "customer": "cus_AAMdwCYQ7FEPFrBX",
  "last_setup_error": null,
  "latest_attempt": null,
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": null,
  "payment_method_types": [
    "credit_card"
  ],
  "status": "canceled",
  "updated_at": "2026-08-06T18:30:00Z",
  "usage": "off_session"
}

{
  "error": {
    "code": "resource_state_conflict",
    "message": "Setup intent cannot be canceled in its current status",
    "type": "invalid_request_error"
  }
}

Erros comuns

401 authentication_failed — chave ausente ou inválida.
404 resource_missing — cadastro não encontrado neste ambiente ou organização.
409 resource_state_conflict — o cadastro já está em succeeded ou canceled.

curl -X POST "https://api.chargefy.io/v1/setup-intents/seti_HBKurDs4uU8tk9uy/cancel" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "id": "seti_HBKurDs4uU8tk9uy",
  "object": "setup_intent",
  "canceled_at": "2026-08-06T18:30:00Z",
  "cancellation_reason": "abandoned",
  "client_secret": "seti_HBKurDs4uU8tk9uy_secret_99492c471003a5b63fcff811e4c67b455ed53e8dafe7d211",
  "created_at": "2026-08-06T18:00:00Z",
  "customer": "cus_AAMdwCYQ7FEPFrBX",
  "last_setup_error": null,
  "latest_attempt": null,
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": null,
  "payment_method_types": [
    "credit_card"
  ],
  "status": "canceled",
  "updated_at": "2026-08-06T18:30:00Z",
  "usage": "off_session"
}

{
  "error": {
    "code": "resource_state_conflict",
    "message": "Setup intent cannot be canceled in its current status",
    "type": "invalid_request_error"
  }
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Cancelar cadastro de cartão

Resposta

Erros comuns

​Resposta

​Erros comuns

Resposta

Erros comuns