Authorization Declined Webhook

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

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

- 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.
- 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.
- 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.
- 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

{
    "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"
}

In this section:

Documentation

Authorization Declined Webhook

Note

Parameters

Webhook Header Parameters

Webhook Root Parameters

Note

Note

Note

Webhook Data Parameters

Search results