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

{
  "id": "pi_123",
  "object": "payment_intent",
  "amount": 7500,
  "amount_capturable": 0,
  "amount_details": {},
  "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-26T14:10:00Z",
  "currency": "brl",
  "customer": "cus_123",
  "invoice": null,
  "last_payment_error": {
    "category": "issuer_declined",
    "code": "payment_failed",
    "message": "Payment failed in sandbox."
  },
  "latest_charge": "ch_123",
  "livemode": false,
  "metadata": {},
  "next_action": null,
  "payment_method": null,
  "payment_method_options": {},
  "payment_method_types": [
    "pix"
  ],
  "setup_future_usage": null,
  "status": "failed",
  "updated_at": "2026-05-26T14:12:00Z"
}
Marca um payment intent de sandbox como failed. A chamada atualiza a tentativa de pagamento, marca a charge como falha e emite os webhooks de falha correspondentes. Se a cobrança nasceu em uma checkout session, você também pode chamar POST /v1/test-helpers/checkout-sessions/{id}/fail.
​
id
string
required
ID do payment intent (pi_*) em test mode.
curl -X POST "https://api.chargefy.io/v1/test-helpers/payment-intents/pi_123/fail" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "id": "pi_123",
  "object": "payment_intent",
  "amount": 7500,
  "amount_capturable": 0,
  "amount_details": {},
  "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-26T14:10:00Z",
  "currency": "brl",
  "customer": "cus_123",
  "invoice": null,
  "last_payment_error": {
    "category": "issuer_declined",
    "code": "payment_failed",
    "message": "Payment failed in sandbox."
  },
  "latest_charge": "ch_123",
  "livemode": false,
  "metadata": {},
  "next_action": null,
  "payment_method": null,
  "payment_method_options": {},
  "payment_method_types": [
    "pix"
  ],
  "setup_future_usage": null,
  "status": "failed",
  "updated_at": "2026-05-26T14:12:00Z"
}