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

{
  "id": "seti_123",
  "object": "setup_intent",
  "canceled_at": null,
  "cancellation_reason": null,
  "client_secret": "seti_123_secret_abc",
  "created_at": "2026-05-16T18:30:00Z",
  "customer": "cus_123",
  "last_setup_error": null,
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": null,
  "payment_method_types": [
    "credit_card"
  ],
  "status": "requires_payment_method",
  "updated_at": null,
  "usage": "off_session"
}
Cria um setup_intent, usado para salvar ou anexar um método de pagamento sem cobrar imediatamente.
​
customer
string
Customer que receberá o método salvo.
​
payment_method
string
Payment method já salvo (pm_*) que será preparado. Quando informado, o setup_intent nasce com status: "requires_confirmation".
​
confirm
boolean
Quando true, cria e confirma o setup intent na mesma chamada.
​
token_id
string
Token de cartão de uso único. Só pode ser enviado junto com confirm: true.
​
card_id
string
ID de cartão já salvo que pertence a este customer. Só pode ser enviado junto com confirm: true. A propriedade é validada antes de salvar; um cartão que não pertence ao customer é recusado. Prefira token_id no fluxo padrão.
​
usage
string
off_session ou on_session. Padrão: off_session.
​
payment_method_types
array
Hoje aceita ["credit_card"].
​
metadata
object
Metadata livre.
curl -X POST "https://api.chargefy.io/v1/setup-intents" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "id": "seti_123",
  "object": "setup_intent",
  "canceled_at": null,
  "cancellation_reason": null,
  "client_secret": "seti_123_secret_abc",
  "created_at": "2026-05-16T18:30:00Z",
  "customer": "cus_123",
  "last_setup_error": null,
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": null,
  "payment_method_types": [
    "credit_card"
  ],
  "status": "requires_payment_method",
  "updated_at": null,
  "usage": "off_session"
}

curl -X POST "https://api.chargefy.io/v1/setup-intents" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "confirm": true,
    "customer": "cus_123",
    "token_id": "tok_123"
  }'