Card Added Failure Webhook

The CARD_ADDED_FAILURE webhook is sent when adding a card payment method to a customer fails.

Parameters

Webhook Header Parameters

Webhook Root Parameters

- created_at
- Time that the webhook was created, in Unix time.
  Note
  Inside the data object, some webhooks have another created_at field that refers to a different event.
- data
- Contains the actual data of the webhook.
  For details, see below.
- extended_timestamp
- Time in milliseconds that the webhook was created, in Unix time.
- id
- ID of the webhook. String starting with wh_.
- status
- Status of the webhook. One of the following:
  - NEW
  - CLO - Closed.
  - ERR - Error.
  - RET - Re-sent.
  Note
  Inside the data object, some webhooks have another status field that refers to a different event.
- trigger_operation_id
- ID of the operation that triggered the webhook. UUID.
- type
- Name of the webhook type.
  Note
  The name in the Client Portal is different.

Webhook Data Parameters

- account_name_inquiry
- Data about the account name inquiry (ANI).
  - account_name_inquiry_result
    Result of the account name inquiry. One of the following values:
    match - Indicates that the name provided in the request fully matched the issuing bank's records.
    partial match - Indicates that the name provided in the request partially matched the issuing bank's records.
    no match - Indicates that the name provided in the request did not match the issuing bank's records.
    not performed - Indicates that the account name inquiry was not performed.
    not supported - Indicates that the payment method does not support account name inquiries.
  - account_name_inquiry_details
    Indicates the degree that the name provided in the request matched the issuing bank's records.
    first_name
    Indicates the result of matching the cardholder's given name. One of the following values:
    match - Indicates that the first name provided in the request fully matched the first name in the issuing bank's records.
    partial match - Indicates that the first name provided in the request partially matched the first name in the issuing bank's records.
    no match - Indicates that first the name provided in the request did not match the first name in the issuing bank's records.
    middle_name
    indicates the result of matching the cardholder's middle name. One of the following values:
    match - Indicates that the middle name provided in the request fully matched the middle name in the issuing bank's records.
    partial match - Indicates that the middle name provided in the request partially middle the first name in the issuing bank's records.
    no match - Indicates that the middle name provided in the request did not match the middle name in the issuing bank's records.
    last_name
    indicates the result of matching the cardholder's family name. One of the following values:
    match - Indicates that the last name provided in the request fully matched the family name in the issuing bank's records.
    partial match - Indicates that the last name provided in the request partially matched the family name in the issuing bank's records.
    no match - Indicates that the last name provided in the request did not match the family name in the issuing bank's records.
- acs_check
- Results of the Access Control Server (ACS) check. Possible values:
  - pass
  - fail
  - unavailable
  - unchecked
  Relevant to cards.
- bin_details
- Bank identification details. Includes the following fields:
  bin_number
  BIN number of the bank.
  brand
  The brand of the card. For example, Visa.
  country
  Country of the bank that issued the card.
  type
  The type of the card:
  credit
  debit
  prepaid
- category
- Category of payment method. One of the following:
  bank_redirect
  bank_transfer
  card
  card_redirect
  cash
  ewallet
  ewallet_redirect
- company_name
- Name of the customer's company.
- cvv_check
- Verification of the card’s CVV. Valid values:
  - pass
  - fail
  - unavailable
  - unchecked
- expiration_month
- Month of expiration.
  Relevant to cards.
- expiration_year
- Year of expiration.
  Relevant to cards.
- fingerprint_token
- Hash of the card number, expiration date and CVV.
  Relevant to cards.
- full_name
- Full name of the cardholder, as submitted for account name inquiry (ANI).
  first_name
  The cardholder's given name.
  middle_name
  The cardholder's middle name.
  last_name
  The cardholder's family name.
- id
- ID of the payment method. String starting with card_ or other_.
- image
- A URL to the image of the icon for the type of payment method.
- last4
- Last four digits of the card or IBAN (International Bank Account Number).
- metadata
- A JSON object defined by the client. See Metadata.
- name
- Full name of the customer.
- next_action
- Indicates the next action for completing the payment. One of the following values:
  3d_verification - The next action is 3DS authentication. Relevant only to card payments.
  pending_capture - The next action is pending the capture of the amount. Relevant only to card payments when the amount is not zero.
  pending_confirmation - The next action is pending the confirmation for the payment. Relevant to all payment methods excluding card payment.
  not_applicable - The payment has completed or the next action is not relevant.
- payment_account_reference
- Payment account reference (PAR). A unique identifier for a payment account. Each primary account number (PAN) associated with the same payment account has the same PAR.
  For example, when a card is renewed or replaced, it gets a new PAN but the PAR remains the same.
- supporting_documentation
- Reserved.
- type
- Name of the payment method type. For example, us_mastercard_card.
  To get a list of payment methods for a country, use List Payment Methods by Country.
- webhook_url
- Reserved.

CARD_ADDED_FAILURE Webhook

{
    "token": "wh_7783c2554d1b9c8ba374896f97522438",
    "type": "CARD_ADDED_FAILURE",
    "data": {
        "id": "card_c2195959a55eaf751b8e5fa257c99692",
        "type": "is_visa_pos",
        "category": "pos",
        "metadata": {},
        "image": "",
        "webhook_url": "",
        "supporting_documentation": "",
        "next_action": "not_applicable",
        "name": null,
        "last4": "1111",
        "acs_check": "unchecked",
        "cvv_check": "unchecked",
        "bin_details": {
            "type": "DEBIT",
            "brand": "VISA",
            "level": "CLASSIC",
            "issuer": "CONOTOXIA SP. Z O.O",
            "country": "PL",
            "bin_number": "411111"
        },
        "expiration_year": "35",
        "expiration_month": "12",
        "fingerprint_token": "ocfp_e599f990674473ce6283b245e9ad2467",
        "failure_code": "",
        "failure_reason": "",
        "error_code": "UNKNOWN_PAYMENT_METHOD_FIELD - [3D_REQUIRED]"
    },
    "attempts": [],
    "status": "CLO",
    "last_attempt_at": 1755772278,
    "created_at": 1755772278,
    "next_attempt_at": 0
}

In this section:

Documentation

Card Added Failure Webhook

Note

Parameters

Webhook Header Parameters

Webhook Root Parameters

Note

Note

Note

Webhook Data Parameters

Search results