Atualizar cadastro de cartão

curl -X POST "https://api.chargefy.io/v1/setup-intents/seti_RA5Shozu5iFpmQAG" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "metadata": {},
    "payment_method": "pm_kj3z2D8H3xrqaZWk"
  }'

{
  "id": "seti_RA5Shozu5iFpmQAG",
  "object": "setup_intent",
  "canceled_at": null,
  "cancellation_reason": null,
  "client_secret": "seti_RA5Shozu5iFpmQAG_secret_6b0f97b563920b1c5c2084479670e64385c94fff3e59141f",
  "created_at": "2026-05-16T18:30:00Z",
  "customer": "cus_9c1Q94cBNnfmG6LN",
  "last_setup_error": null,
  "latest_attempt": null,
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": "pm_kj3z2D8H3xrqaZWk",
  "payment_method_types": [
    "credit_card"
  ],
  "status": "requires_confirmation",
  "updated_at": "2026-05-16T18:31:00Z",
  "usage": "off_session"
}

Atualiza campos mutáveis de um cadastro de cartão (setup_intent). Use esta chamada para definir o customer, escolher ou remover um payment_method antes da conclusão, ou atualizar metadata.

string

required

ID do setup intent (seti_*).

string

Customer que receberá o método salvo. Não pode ser alterado após estados terminais.

string | null

Payment method salvo (pm_*) a preparar. Envie null para remover o método pendente e voltar para requires_payment_method.

object

Metadata livre. Envie {} para limpar.

curl -X POST "https://api.chargefy.io/v1/setup-intents/seti_RA5Shozu5iFpmQAG" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "metadata": {},
    "payment_method": "pm_kj3z2D8H3xrqaZWk"
  }'

{
  "id": "seti_RA5Shozu5iFpmQAG",
  "object": "setup_intent",
  "canceled_at": null,
  "cancellation_reason": null,
  "client_secret": "seti_RA5Shozu5iFpmQAG_secret_6b0f97b563920b1c5c2084479670e64385c94fff3e59141f",
  "created_at": "2026-05-16T18:30:00Z",
  "customer": "cus_9c1Q94cBNnfmG6LN",
  "last_setup_error": null,
  "latest_attempt": null,
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": "pm_kj3z2D8H3xrqaZWk",
  "payment_method_types": [
    "credit_card"
  ],
  "status": "requires_confirmation",
  "updated_at": "2026-05-16T18:31:00Z",
  "usage": "off_session"
}

Erros e limites relevantes

Situação	Resposta
Nenhum campo compatível enviado	`400 invalid_request`.
Remover o customer com `null`	`400 invalid_request` no parâmetro `customer`.
Definir cartão sem customer	`400 invalid_request` no parâmetro `customer`.
Customer ou cartão não existe	`404 resource_missing`.
Cartão pertence a outro customer	`402 card_error`.
Alterar customer ou cartão após `succeeded`/`canceled`	`409 resource_state_conflict`.

Atualizar para um pm_* existente não consulta o emissor e não faz cobrança ou reserva de limite.

curl -X POST "https://api.chargefy.io/v1/setup-intents/seti_RA5Shozu5iFpmQAG" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "metadata": {},
    "payment_method": "pm_kj3z2D8H3xrqaZWk"
  }'

{
  "id": "seti_RA5Shozu5iFpmQAG",
  "object": "setup_intent",
  "canceled_at": null,
  "cancellation_reason": null,
  "client_secret": "seti_RA5Shozu5iFpmQAG_secret_6b0f97b563920b1c5c2084479670e64385c94fff3e59141f",
  "created_at": "2026-05-16T18:30:00Z",
  "customer": "cus_9c1Q94cBNnfmG6LN",
  "last_setup_error": null,
  "latest_attempt": null,
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": "pm_kj3z2D8H3xrqaZWk",
  "payment_method_types": [
    "credit_card"
  ],
  "status": "requires_confirmation",
  "updated_at": "2026-05-16T18:31:00Z",
  "usage": "off_session"
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Atualizar cadastro de cartão

Erros e limites relevantes

​Erros e limites relevantes

Erros e limites relevantes