Consultar cadastro de cartão

Retorna um cadastro de cartão (setup_intent). O backend usa a chave secreta e recebe o objeto completo. O navegador pode consultar somente aquele cadastro com uma chave publicável e o client_secret correspondente.

string

required

ID do cadastro (seti_*).

string

Obrigatório quando a autorização usa uma chave publicável pk_*.

string

Com chave secreta, use payment_method ou latest_attempt. Expansões não são aplicadas à resposta limitada do navegador.

curl -X GET "https://api.chargefy.io/v1/setup-intents/seti_2ab925v449GR9W5H?expand[]=latest_attempt" \
  -H "Authorization: Bearer {{API_KEY}}"

const chargefy = Chargefy("pk_test_...");
const setupIntent = await chargefy.retrieveSetupIntent(clientSecret);

Resposta do backend

200

{
  "id": "seti_2ab925v449GR9W5H",
  "object": "setup_intent",
  "canceled_at": null,
  "cancellation_reason": null,
  "client_secret": "seti_2ab925v449GR9W5H_secret_13a8b8532ef159d57366b6935a88258537ea4114c91b24b4",
  "created_at": "2026-08-07T14:09:27Z",
  "customer": "cus_h3Rs12Y1QCs3JgFg",
  "last_setup_error": null,
  "latest_attempt": "setatt_L6ZmE4rSCaYzP5wJ",
  "livemode": false,
  "metadata": {},
  "next_action": null,
  "payment_method": "pm_Y8qT61Jd3JisBNb1",
  "payment_method_types": [
    "credit_card"
  ],
  "status": "succeeded",
  "updated_at": "2026-08-07T14:10:02Z",
  "usage": "off_session"
}

Resposta do navegador

O navegador recebe somente os campos necessários para renderizar e continuar o fluxo. customer, metadata, motivos de cancelamento e latest_attempt ficam fora dessa resposta.

200

{
  "id": "seti_2ab925v449GR9W5H",
  "object": "setup_intent",
  "client_secret": "seti_2ab925v449GR9W5H_secret_13a8b8532ef159d57366b6935a88258537ea4114c91b24b4",
  "created_at": "2026-08-07T14:09:27Z",
  "last_setup_error": null,
  "livemode": false,
  "next_action": null,
  "payment_method": "pm_Y8qT61Jd3JisBNb1",
  "payment_method_types": [
    "credit_card"
  ],
  "status": "succeeded",
  "usage": "off_session",
  "...": "campos server-side omitidos no navegador"
}

Erros comuns

Situação	HTTP	`code`
Credencial ausente ou inválida	`401`	`authentication_failed`
`client_secret` ausente com `pk_*`	`400`	`parameter_missing`
ID, secret, organização ou ambiente não combinam	`404`	`resource_missing`

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Consultar cadastro de cartão

Resposta do backend

Resposta do navegador

Erros comuns

​Resposta do backend

​Resposta do navegador

​Erros comuns

Resposta do backend

Resposta do navegador

Erros comuns