Skip to main content
curl -X POST "https://api.chargefy.io/v1/payment-intents/pi_123" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "metadata": {
      "order_id": "id_456"
    },
    "payment_method": "pm_123",
    "payment_method_options": {
      "credit_card": {
        "installments": {
          "count": 3
        }
      }
    }
  }'

{
  "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": "2026-05-16T18:35:00Z"
}
Atualiza um payment_intent antes da confirmação. A resposta direta retorna o objeto completo atualizado; o diff sai apenas no webhook payment.intent.updated.
​
id
string
required
ID do payment intent (pi_*).
​
amount
integer
Novo valor em centavos. Só pode ser alterado antes do processamento.
​
currency
string
Nova moeda. Só pode ser alterada antes do processamento.
​
customer
string
Customer associado (cus_*).
​
payment_method
string
Payment method salvo (pm_*).
​
payment_method_types
array
Métodos permitidos para o intent. Aceita credit_card e pix.
​
payment_method_options
object
Opções por método de pagamento.
​
payment_method_options.credit_card.installments.count
integer
Número de parcelas de cartão antes da confirmação. 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). Quando omitido, usa a configuração da organização.
​
setup_future_usage
string
off_session ou on_session.
​
metadata
object
Metadata livre.
curl -X POST "https://api.chargefy.io/v1/payment-intents/pi_123" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "metadata": {
      "order_id": "id_456"
    },
    "payment_method": "pm_123",
    "payment_method_options": {
      "credit_card": {
        "installments": {
          "count": 3
        }
      }
    }
  }'

​
Resposta

200 OK com o objeto payment_intent completo — mesmo shape de GET /v1/payment-intents/:id. 
{
  "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": "2026-05-16T18:35:00Z"
}

​
Erros comuns

StatuscodeQuando ocorre
404resource_missingO payment intent não existe nesta organização.
409resource_state_conflictO campo não pode ser alterado no status atual.