Tentativa de cadastro

Um setup_attempt registra uma tentativa de salvar o cartão. O setup_intent mostra o estado atual do cadastro; as tentativas preservam o que aconteceu em cada confirmação, inclusive erros anteriores. Uma tentativa nasce somente depois que os parâmetros básicos foram validados e a confirmação começou. Erros como client_secret ausente ou customer inexistente não criam tentativa. O latest_attempt do cadastro aponta para a tentativa mais recente. Para ver o histórico, use GET /v1/setup-attempts.

Data Object

{
  "id": "setatt_L6ZmE4rSCaYzP5wJ",
  "object": "setup_attempt",
  "created_at": "2026-08-07T12:01:00Z",
  "customer": "cus_AAMdwCYQ7FEPFrBX",
  "livemode": false,
  "payment_method": "pm_Be2jZhX6ifbAAP46",
  "payment_method_details": {
    "credit_card": {
      "brand": "visa",
      "exp_month": 12,
      "exp_year": 2030,
      "last4": "4242"
    },
    "type": "credit_card"
  },
  "setup_error": null,
  "setup_intent": "seti_VsaygQA79ZNhy4CQ",
  "status": "succeeded",
  "usage": "off_session"
}

string

Identificador da tentativa. Usa o prefixo setatt_*.

string

Sempre "setup_attempt".

string

Início da tentativa em ISO 8601.

string | null

Customer do cadastro no momento da confirmação.

boolean

true em produção; false no ambiente de teste.

string | null

pm_* usado ou criado. Pode ser null quando o processador recusa o cartão antes que a Chargefy consiga criar o payment method.

object

Snapshot seguro do método naquela tentativa: tipo, bandeira, validade e últimos quatro dígitos. PAN e CVC nunca aparecem.

object | null

Erro da tentativa. Quando presente, usa type, code, message e param quando o erro está ligado a um campo.

string

Cadastro (seti_*) ao qual esta tentativa pertence.

string

Estado final ou atual da tentativa.

Show Valores de status

string

Aguarda a confirmação efetiva.

string

Exige ação do comprador. O processador atual não produz este estado no fluxo de cartão.

string

A confirmação está em andamento.

string

O cartão foi salvo com sucesso.

string

A confirmação falhou; veja setup_error.

string

Outra confirmação ganhou a disputa e esta tentativa não foi processada.

string

Contexto de reutilização copiado do cadastro: off_session ou on_session. Hoje os cadastros da Chargefy usam off_session.

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Tentativa de cadastro

Data Object

​Data Object

Data Object