Skip to main content
curl -X POST "https://api.chargefy.io/v1/payment-intents" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10000,
    "customer": "cus_123",
    "payment_method": "pm_123",
    "payment_method_options": {
      "credit_card": {
        "installments": {
          "count": 3
        }
      }
    },
    "payment_method_types": ["credit_card"]
  }'

{
  "id": "pi_123",
  "object": "payment_intent",
  "amount": 10528,
  "amount_capturable": 0,
  "amount_details": {
    "installment_interest": 528,
    "subtotal": 10000,
    "total": 10528
  },
  "amount_received": 0,
  "canceled_at": null,
  "cancellation_reason": null,
  "capture_method": "automatic",
  "client_secret": "pi_123_secret_abc",
  "confirmation_method": "automatic",
  "created_at": "2026-05-16T18:34:58Z",
  "currency": "brl",
  "customer": "cus_123",
  "invoice": null,
  "last_payment_error": null,
  "latest_charge": null,
  "livemode": true,
  "metadata": {
    "order_id": "id_456"
  },
  "next_action": null,
  "payment_method": "pm_123",
  "payment_method_options": {
    "credit_card": {
      "installments": {
        "amount_subtotal": 10000,
        "amount_total": 10528,
        "count": 3,
        "has_interest": true,
        "interest_amount": 528
      }
    }
  },
  "payment_method_types": [
    "credit_card"
  ],
  "setup_future_usage": null,
  "status": "requires_confirmation",
  "updated_at": null
}
Cria um payment_intent, o objeto que representa o ciclo de vida de uma cobrança. Para cobrar um cartão salvo, informe customer, payment_method e confirme o intent. Para PIX, crie o intent com payment_method_types: ["pix"] e confirme para receber o QR code em next_action. Use payment_intent como objeto canônico da cobrança. Ele pode ser criado diretamente pela API, por uma invoice ou por uma checkout session. Não use uma checkout session como chave de idempotência de pagamento nem como ledger financeiro.
Veja Ciclo de pagamento para entender quando usar checkout.session, payment_intent, invoice e payment_method.
​
amount
integer
required
Valor base em centavos. Quando o comprador paga juros de parcelamento, o amount retornado passa a ser o total cobrado e o valor original fica em amount_details.subtotal.
​
currency
string
Moeda em minúsculas. Padrão: brl.
​
customer
string
Customer associado (cus_*).
​
payment_method
string
Payment method salvo (pm_*). Quando informado, o intent nasce em requires_confirmation.
​
payment_method_types
array
Aceita credit_card e pix. Padrão: ["credit_card"].
​
payment_method_options
object
Opções por método de pagamento.
​
capture_method
string
automatic ou manual. Use manual para autorizar cartão agora e capturar depois com POST /v1/payment-intents/:id/capture.
​
payment_method_options.credit_card.installments.count
integer
Número de parcelas de cartão, de 1 a 12. O máximo também respeita o valor mínimo por parcela. Quando omitido, usa 1.
​
payment_method_options.credit_card.installments.has_interest
boolean
true quando o comprador paga o acréscimo do parcelamento; false quando o lojista absorve o acréscimo (venda sem juros ao comprador). A taxa é definida no plano de parcelamento da organização. Quando omitido, usa a configuração da organização.
​
confirm
boolean
Se true, cria e confirma a cobrança na mesma chamada.
​
setup_future_usage
string
off_session ou on_session, quando o método também será usado no futuro.
​
metadata
object
Metadata livre.
curl -X POST "https://api.chargefy.io/v1/payment-intents" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10000,
    "customer": "cus_123",
    "payment_method": "pm_123",
    "payment_method_options": {
      "credit_card": {
        "installments": {
          "count": 3
        }
      }
    },
    "payment_method_types": ["credit_card"]
  }'

{
  "id": "pi_123",
  "object": "payment_intent",
  "amount": 10528,
  "amount_capturable": 0,
  "amount_details": {
    "installment_interest": 528,
    "subtotal": 10000,
    "total": 10528
  },
  "amount_received": 0,
  "canceled_at": null,
  "cancellation_reason": null,
  "capture_method": "automatic",
  "client_secret": "pi_123_secret_abc",
  "confirmation_method": "automatic",
  "created_at": "2026-05-16T18:34:58Z",
  "currency": "brl",
  "customer": "cus_123",
  "invoice": null,
  "last_payment_error": null,
  "latest_charge": null,
  "livemode": true,
  "metadata": {
    "order_id": "id_456"
  },
  "next_action": null,
  "payment_method": "pm_123",
  "payment_method_options": {
    "credit_card": {
      "installments": {
        "amount_subtotal": 10000,
        "amount_total": 10528,
        "count": 3,
        "has_interest": true,
        "interest_amount": 528
      }
    }
  },
  "payment_method_types": [
    "credit_card"
  ],
  "setup_future_usage": null,
  "status": "requires_confirmation",
  "updated_at": null
}