Atualizar um pagamento

curl -X POST "https://api.chargefy.io/v1/payment-intents/pi_uLMAEGaKZ5bFaS9N" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "metadata": {},
    "payment_method": "pm_AvSiPvkso69ptszb",
    "payment_method_options": {
      "credit_card": {
        "installments": {
          "count": 3
        }
      }
    }
  }'

{
  "id": "pi_uLMAEGaKZ5bFaS9N",
  "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_uLMAEGaKZ5bFaS9N_secret_b1e5f149754780d0d203ec3976ebf0975c0aec8a2ec25d4d",
  "confirmation_method": "automatic",
  "created_at": "2026-05-16T18:34:58Z",
  "currency": "brl",
  "customer": "cus_iNh2Dv8ptLMWTGxP",
  "installment_interest_amount": 528,
  "installments": 3,
  "invoice": null,
  "last_payment_error": null,
  "latest_charge": null,
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": "pm_AvSiPvkso69ptszb",
  "payment_method_options": {
    "credit_card": {
      "installments": {
        "amount": 10528,
        "count": 3,
        "installment_interest_amount": 528,
        "interest_payer": "buyer",
        "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:35:00Z"
}

{
  "error": {
    "code": "invalid_request",
    "message": "metadata must be an object.",
    "param": "metadata",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid API Key provided: ch_live_***************************************9f2c",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "resource_missing",
    "message": "Payment intent not found.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "resource_state_conflict",
    "message": "amount cannot be updated after the payment intent has been processed.",
    "param": "amount",
    "type": "invalid_request_error"
  }
}

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.

string

obrigatório

ID do payment intent (pi_*).

integer

Novo valor em centavos. Só pode ser alterado antes do processamento.

string

Nova moeda. Só pode ser alterada antes do processamento.

string

Customer associado (cus_*).

string

Payment method salvo (pm_*).

array

Métodos permitidos para o intent. Aceita credit_card e pix.

boolean

Liga ou desliga o repasse de taxa antes da confirmação. Quando true, o comprador cobre a taxa da organização e o total é recalculado; exige exatamente um payment_method_types.

object

Opções por método de pagamento.

integer

Número de parcelas de cartão antes da confirmação. Quando omitido, usa 1.

string

Quem paga o juro do parcelamento: buyer (comprador, juro somado ao total) ou organization (a organização paga; o comprador parcela o valor à vista e o juro sai do líquido da organização). Quando omitido, usa a configuração da organização. has_interest foi removido: enviá-lo retorna 400 com param apontando o campo e a mensagem has_interest was removed; use interest_payer ("buyer" | "organization").

object

Metadata livre.

curl -X POST "https://api.chargefy.io/v1/payment-intents/pi_uLMAEGaKZ5bFaS9N" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "metadata": {},
    "payment_method": "pm_AvSiPvkso69ptszb",
    "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_uLMAEGaKZ5bFaS9N",
  "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_uLMAEGaKZ5bFaS9N_secret_b1e5f149754780d0d203ec3976ebf0975c0aec8a2ec25d4d",
  "confirmation_method": "automatic",
  "created_at": "2026-05-16T18:34:58Z",
  "currency": "brl",
  "customer": "cus_iNh2Dv8ptLMWTGxP",
  "installment_interest_amount": 528,
  "installments": 3,
  "invoice": null,
  "last_payment_error": null,
  "latest_charge": null,
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": "pm_AvSiPvkso69ptszb",
  "payment_method_options": {
    "credit_card": {
      "installments": {
        "amount": 10528,
        "count": 3,
        "installment_interest_amount": 528,
        "interest_payer": "buyer",
        "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:35:00Z"
}

{
  "error": {
    "code": "invalid_request",
    "message": "metadata must be an object.",
    "param": "metadata",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid API Key provided: ch_live_***************************************9f2c",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "resource_missing",
    "message": "Payment intent not found.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "resource_state_conflict",
    "message": "amount cannot be updated after the payment intent has been processed.",
    "param": "amount",
    "type": "invalid_request_error"
  }
}

Erros comuns

Status	`code`	Quando ocorre
`400`	`invalid_request`	`has_interest` enviado em `payment_method_options.credit_card.installments` — o campo foi removido; use `interest_payer` (`buyer` ou `organization`). `param` aponta o campo.
`404`	`resource_missing`	O payment intent não existe nesta organização.
`409`	`resource_state_conflict`	O campo não pode ser alterado no status atual.

Objeto e campos

Shape completo, status, valores e relações.

Evento payment.intent.updated

Objeto atual completo e valores anteriores dos campos alterados.

curl -X POST "https://api.chargefy.io/v1/payment-intents/pi_uLMAEGaKZ5bFaS9N" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "metadata": {},
    "payment_method": "pm_AvSiPvkso69ptszb",
    "payment_method_options": {
      "credit_card": {
        "installments": {
          "count": 3
        }
      }
    }
  }'

{
  "id": "pi_uLMAEGaKZ5bFaS9N",
  "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_uLMAEGaKZ5bFaS9N_secret_b1e5f149754780d0d203ec3976ebf0975c0aec8a2ec25d4d",
  "confirmation_method": "automatic",
  "created_at": "2026-05-16T18:34:58Z",
  "currency": "brl",
  "customer": "cus_iNh2Dv8ptLMWTGxP",
  "installment_interest_amount": 528,
  "installments": 3,
  "invoice": null,
  "last_payment_error": null,
  "latest_charge": null,
  "livemode": true,
  "metadata": {},
  "next_action": null,
  "payment_method": "pm_AvSiPvkso69ptszb",
  "payment_method_options": {
    "credit_card": {
      "installments": {
        "amount": 10528,
        "count": 3,
        "installment_interest_amount": 528,
        "interest_payer": "buyer",
        "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:35:00Z"
}

{
  "error": {
    "code": "invalid_request",
    "message": "metadata must be an object.",
    "param": "metadata",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid API Key provided: ch_live_***************************************9f2c",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "resource_missing",
    "message": "Payment intent not found.",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "resource_state_conflict",
    "message": "amount cannot be updated after the payment intent has been processed.",
    "param": "amount",
    "type": "invalid_request_error"
  }
}

Fundamentos da API

MCP

Objetos de sistema

Webhooks e eventos

SDKs

Atualizar um pagamento

Resposta

Erros comuns

Objeto e campos

Evento payment.intent.updated

​Resposta

​Erros comuns

Objeto e campos

Evento payment.intent.updated

Resposta

Erros comuns