---
title: "CARD_FAILED"
method: POST
path: "card_failed"
---

# CARD_FAILED

`POST card_failed` (webhook)

Fired when a card failed to be updated in a merchant account.

## Payload

- CardFailedWebhook
  - `event` string: Name of the webhook event.
  - `session_id` string, nullable: Unique identifier for the session.
  - `task_id` integer: Unique identifier for the task.
  - `external_user_id` string: Unique identifier for the user.
  - `merchant` object
    - `id` integer: Unique identifier for the merchant.
    - `name` string: Name of the merchant.
  - `data` object
    - `card_id` string: Unique identifier for the card.
    - `bank_account_id` string: Your unique identifier for the bank account, as provided in `bank_account_id` when the session was created. Only present when the session has a bank account.
    - `payment_method_type` 'card' | 'bank_account': Payment method the user chose for this task. `bank_account` when the user chose to switch their bank account, otherwise `card`.
    - `reason` string: Reason for the failure.
    - `metadata` object, nullable: Custom key-value pairs provided during session creation or SDK invocation. Only present if metadata was provided.
  - `timestamp` integer: Unix timestamp of the webhook event in UTC.

---

[API](https://skmtc.dev/knotapi/apis/knot-api.md) - [All operations](https://skmtc.dev/knotapi/apis/knot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/knotapi/apis/knot-api/revisions/f10ecfa12c00?raw)