---
title: "Card Issuing Authorization Approved Webhook"
source_url: https://docs.rapyd.net/en/card-issuing-authorization-approved-webhook.html
lang: en
---

# Card Issuing Authorization Approved Webhook

The **CARD_ISSUING_AUTHORIZATION_APPROVED** webhook is sent when Rapyd approves authorization of a transaction made with 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. Relevant to authorizations approved by Rapyd.
- - authorization_approved_by
  - Approver of the transaction when remote authorization is used. See [Remote Authorization](https://docs.rapyd.net/en/remote-authorization.md "Remote Authorization"). One of the following:

    - **Rapyd**
    - **Client**
- - bin
  - The first 6 digits of the card number.
- - card_authorization
  - ID of the card authorization. String starting with **cardauth_**.
- - 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_**.
- - 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
  - The currency of the transaction. Three-letter ISO 4217 code.
- - fx_rate
  - The exchange rate. Relevant to capture (clearing) transactions.
- - id
  - ID of the card transaction. String starting with **cit_**.
- - issuing_txn_type
  - Type of transaction on the issued card. One of the following:

    - **ADJUSTMENT**
    - **ATM_FEE**
    - **CREDIT**
    - **REFUND**
    - **REFUND_ATM_FEE**
    - **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_name_location
  - Name and location of the merchant. Maximum 40 characters.
- - original_transaction_id
  - ID of the original card transaction.
- - 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:

    - **3ds_ecommerce**
    - **adjustment**
    - **ecommerce**
    - **emv**
    - **emv_standin**
    - **magstripe**
    - **manual_entered**
    - **network_token**
    - **nfc**
- - retrieval_reference_number
  - Retrieval reference number for a card transaction. Appears in the response to [List Issued Card Transactions](https://docs.rapyd.net/en/list-issued-card-transactions.md "List Issued Card Transactions").
- - systems_trace_audit_number
  - Reserved.
- - wallet_transaction_id
  - ID of the wallet transaction. String starting with **wt_**.

- CARD_ISSUING_AUTHORIZATION_APPROVED Webhook
- ```json
  {
      "id": "wh_b0a395da21ed2447efa67242685a0d47",
      "data": {
          "id": "cit_0220579d851657b2a46198fce2589d51",
          "bin": "423474",
          "last4": "7505",
          "amount": 20,
          "card_id": "card_013ebcae1c14b05f6eaa050635afbdd4",
          "fx_rate": null,
          "currency": "USD",
          "auth_code": "",
          "created_at": 1703657499,
          "card_program": "cardprog_1db1b47d3f3a1a4ff2a6c637ff88f5f7",
          "pos_entry_mode": "",
          "issuing_txn_type": "SALE",
          "card_authorization": "cardauth_3cae98fa8e1697e8ac3697ebfe035b35",
          "original_txn_amount": 19,
          "original_txn_currency": "USD",
          "wallet_transaction_id": "wt_fef46c539d3123932c4316dcdd66ba65",
          "merchant_category_code": "7311",
          "merchant_name_location": "Acme Inc. 1 Main St Queens NY",
          "original_transaction_id": "",
          "authorization_approved_by": "Rapyd",
          "retrieval_reference_number": "",
          "systems_trace_audit_number": ""
      },
      "type": "CARD_ISSUING_AUTHORIZATION_APPROVED",
      "status": "NEW",
      "created_at": 1703657519,
      "extended_timestamp": 1703657519945,
      "trigger_operation_id": "a2c03de7-0a0e-49c0-8c72-f8200c988269"
  }
  ```