Evento payment.intent.created

Evento `payment.intent.created`

Disparado quando um payment_intent é criado. Isso pode acontecer via POST /v1/payment-intents, por uma invoice ou por um checkout hospedado que resolve a cobrança para um intent. data.object usa o mesmo shape de GET /v1/payment-intents/:id. Ele é o objeto completo, não um recorte. Este evento não traz data.previous_attributes, porque ainda não existe um estado anterior. Use este evento para registrar a cobrança assim que ela existe no ciclo de vida da Chargefy. Um payment_intent criado ainda não significa pagamento iniciado nem aprovado: ele pode estar aguardando método de pagamento, confirmação ou ação do comprador.

O desfecho financeiro chega em eventos posteriores, como payment.intent.succeeded ou payment.intent.canceled. Use payment.intent.created para preparar o estado local, não para liberar o pedido.

Quando acontece

Situação	Como aparece no payload
Intent criado sem método de pagamento	`status` pode indicar que ainda falta definir o método.
Intent criado com `payment_method` salvo	`payment_method` vem preenchido e o intent fica pronto para confirmação.
Intent criado para PIX ou boleto	`payment_method_types` indica o método permitido; a ação do comprador aparece depois da confirmação em `next_action`.
Valor, parcelas ou repasse foram informados	`amount_details` e `payment_method_options` já vêm calculados no objeto.

Como processar

Registre o id do evento (evt_*) para processar o webhook de forma idempotente.
Faça upsert do payment_intent usando data.object.id (pi_*) como chave.
Use customer, invoice e metadata para correlacionar a cobrança com o seu pedido.
Leia status antes de decidir o próximo passo: intents criados normalmente ainda precisam de confirmação ou método de pagamento.
Não trate latest_charge: null como erro: a charge só nasce quando o intent é confirmado.

Campos importantes

Campo	O que observar
`data.object.status`	Estado inicial do intent depois da criação.
`amount` / `amount_details`	Total em centavos e quebra entre principal, repasse e juros de parcelamento.
`payment_method`	Método salvo associado, quando a criação já recebeu um `pm_*`.
`payment_method_types`	Métodos permitidos para a cobrança, como `credit_card`, `pix` ou `boleto`.
`payment_method_options`	Opções públicas do método, como parcelas de cartão.
`latest_charge`	Normalmente `null` neste evento; passa a apontar para `ch_*` depois da confirmação.
`metadata`	Ecoa os metadados enviados para correlacionar com seu pedido.

Status possíveis

Valor	Descrição
`requires_payment_method`	Falta definir o método de pagamento.
`requires_confirmation`	Pronto para confirmar.
`requires_capture`	Cartão autorizado; falta capturar.
`pending`	Aguardando ação do comprador ou confirmação assíncrona.
`processing`	Pagamento em processamento.
`succeeded`	Pagamento concluído.
`failed`	Pagamento falhou.
`canceled`	Pagamento cancelado.

Exemplo de payload

{
  "id": "evt_CVLSKvjJYJAbWJQB",
  "object": "event",
  "created_at": "2026-05-16T18:34:58Z",
  "data": {
    "object": {
      "id": "pi_mptDuTe2ia6796eQ",
      "object": "payment_intent",
      "amount": 10528,
      "amount_capturable": 0,
      "amount_details": {
        "amount": 10528,
        "installment_interest_amount": 528,
        "principal_amount": 10000,
        "surcharge_amount": 0
      },
      "amount_received": 0,
      "canceled_at": null,
      "cancellation_reason": null,
      "capture_method": "automatic",
      "client_secret": "pi_mptDuTe2ia6796eQ_secret_a7cf8870bd1cb00f7d2e87e3b6f07a1c207185794d1e4762",
      "confirmation_method": "automatic",
      "created_at": "2026-05-16T18:34:58Z",
      "currency": "brl",
      "customer": "cus_w7x5gQpfcK5vQLv5",
      "installment_interest_amount": 528,
      "installments": 3,
      "invoice": "inv_nDAGDghxJ1WaFqm2",
      "last_payment_error": null,
      "latest_charge": null,
      "livemode": true,
      "metadata": {},
      "next_action": null,
      "payment_method": "pm_KAWLMX86qeJBRiFG",
      "payment_method_options": {
        "credit_card": {
          "installments": {
            "amount": 10528,
            "count": 3,
            "has_interest": true,
            "installment_interest_amount": 528,
            "principal_amount": 10000,
            "surcharge_amount": 0
          }
        }
      },
      "payment_method_types": [
        "credit_card"
      ],
      "principal_amount": 10000,
      "status": "requires_confirmation",
      "surcharge_amount": 0,
      "updated_at": "2026-05-16T18:34:58Z"
    }
  },
  "livemode": true,
  "organization": "org_h7k4PY3d7Q6nj87m",
  "request": {
    "id": "req_iAFtzCnbXJw4L416"
  },
  "type": "payment.intent.created"
}

Páginas relacionadas

Objeto Payment Intent

Campos, status, enums, valores e timestamps de data.object.

Criar Payment Intent

Parâmetros que originam o objeto deste evento.

Próximo: succeeded

Evento usado para confirmar o pagamento.

Entrega e assinatura

Headers, verificação, retries, duplicação e ordem.

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Evento payment.intent.created