---
title: "Authorization Declined Webhook"
source_url: https://docs.rapyd.net/en/authorization-declined-webhook.html
lang: en
---

# Authorization Declined Webhook

The **AUTHORIZATION_DECLINED** webhook is sent when Rapyd declines a request to authorize a transaction by an issued card.

> **Note:**
>
> The endpoint for webhooks is unique for each client. To set up a webhook endpoint, see [Defining a Webhook Endpoint](https://docs.rapyd.net/en/defining-a-webhook-endpoint.md "Defining a Webhook Endpoint").

### Parameters

### Webhook Header Parameters

- - Content-Type
  - Indicates that the data appears in JSON format. Set to **application/json**.
- - salt
  - Random string.
- - signature
  - Signature calculated for each webhook individually.

    See [Webhook Authentication](https://docs.rapyd.net/en/webhook-authentication.md "Webhook Authentication").
- - timestamp
  - Timestamp for the webhook, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds).

### Webhook Root Parameters

- - created_at
  - Time that the webhook was created, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "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](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "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

- - amount
  - Amount of the transaction, in units defined in `currency`. Decimal, including the correct number of decimal places for the currency exponent, as defined in ISO 2417:2015.
- - auth_code
  - Authorization code sent to the merchant.
- - authorization_approved_by
  - Approver of the transaction.
- - authorization_id
  - ID of the authorization. String starting with **cardauth_**.
- - auth_response
  - Response related to an authorization. Contains the following fields:

    - `code` - Indicates success or reason for failure.
    - `message` - Descriptive text.
- - card_authorization
  - ID of the authorization. String starting with **cardauth_**.
- - bin
  - The first 6 digits of the card number.
- - card_id
  - ID of the card. String starting with **card_**.
- - card_program
  - ID of the card program that the card is issued from. String starting with **cardprog_**.
- - card_token
  - ID of the card. String starting with **card_**.
- - card_transaction_id
  - ID of the transaction. String starting with **cit_**.
- - created_at
  - Time of creation of the transaction object, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time").
- - currency
  - Currency of the transaction. Three-letter ISO 4217 code.
- - currency_code
  - Currency of the transaction. Three-letter ISO 4217 code.
- - decline_code
  - Error code for a declined authorization. See [Card Network Error Messages](https://docs.rapyd.net/en/card-network-errors.md "Card Network Errors").
- - financial_impact
  - The financial impact of an adjustment. One of the following:

    - **credit**
    - **debit**
- - fx_rate
  - The exchange rate.
- - id
  - ID of the authorization. String starting with **cardauth_**. Relevant to simulations.ID of the issued card transaction object. String starting with **cit_**.
- - is_remote_auth
  - Indicates whether remote authorization is enabled.
- - issuing_txn_type
  - Type of transaction on the issued card. One of the following:

    - **ADJUSTMENT**
    - **ATM_FEE**
    - **CREDIT**
    - **REFUND**
    - **REVERSAL**
    - **SALE**
- - last4
  - The last 4 digits of the card number.
- - merchant_category_code
  - Four-digit merchant category code (MCC) of the initiator of the transaction, as defined in [ISO 18245](https://www.iso.org/standard/33365.html).
- - merchant_identification_code
  - Reserved.
- - merchant_name_location
  - Name and location of the merchant. Maximum 40 characters..

    TEST MERCHANT
- - org_id
  - ID of the client.
- - original_transaction_id
  - ID of the original issued card transaction. String starting with **cit_**.
- - original_txn_amount
  - Original amount for FX transactions, when `currency` is different from `original_txn_currency`.
- - original_txn_currency
  - Original currency in FX transaction. Three-letter ISO 4217 code.
- - pos_entry_mode
  - The mode of the POS entry. One of the following:

    - **magstripe**
    - **manual_entered**
    - **emv**
    - **emv_standin**
    - **nfc**
    - **network_token**
    - **ecommerce**
    - **3ds_ecommerce**
    - **adjustment**
- - remote_auth_endpoint
  - The URL where the remote authorization is sent.
- - remote_auth_response
  - Response to a successful remote authorization request. Contains the following fields:

    - `authorization_id` - ID of the authorization. String starting with **cardauth_**.
    - `response_code` - Code returned by the client in the response to the remote authorization.
    - `auth_code` - Authorization code returned by the client in the response to the remote authorization.
- - retrieval_reference_number
  - Retrieval reference number for a card transaction.
- - systems_trace_audit_number
  - Reserved.
- - transaction_amount
  - Amount debited from the Rapyd Wallet. Decimal, including the correct number of decimal places for the currency exponent, as defined in ISO 2417:2015.
- - transaction_currency_code
  - Original transaction currency, if different from the currency credited to the Rapyd Wallet. Three-letter ISO 4217 code.
- - transaction_token
  - ID of the transaction. String starting with **cit_**.
- - type
  - Name of the webhook.
- - wallet_transaction_id
  - ID of the wallet transaction. String starting with **wt_**.

- AUTHORIZATION_DECLINED Webhook
- ```json
  {
      "id": "wh_0bb269acc4bc7c70e6d8a2c51d258658",
      "data": {
          "type": "AUTHORIZATION_DECLINED",
          "amount": 100,
          "org_id": "3ec4db3e-ef39-11e9-9ffc-12c4c8fed768",
          "currency": "USD",
          "card_token": "card_371274e1947c3fda45d3078b9baba590",
          "decline_code": "57",
          "issuing_txn_type": "SALE",
          "transaction_token": "",
          "card_authorization": "cardauth_04b907a5b4fab968931494e72112ec58"
      },
      "type": "AUTHORIZATION_DECLINED",
      "status": "NEW",
      "created_at": 1644240356,
      "extended_timestamp": 1644240356934,
      "trigger_operation_id": "f041b647-1fd8-4209-aca7-bf2b298b60bd"
  }
  ```