Ramp: Fetch a transaction — response body — decline details
Fetch a transaction: response body, field decline_details. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Fetch a transaction — response body — decline details
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
amount | JSON | Optional | |
amount (anyOf 1) | number | Alternative | Declined amount, denominated in the transaction’s settlement currency (the transaction’s `currency_code`). |
amount (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
declined_amount | JSON | Required within parent | |
declined_amount (anyOf 1) | Model | Alternative | Expand Fetch a transaction — response body — entity amount currency, value Declined amount with its currency. The currency is the transaction’s settlement currency (matches the transaction’s `currency_code`). The value is signed: declined refunds/credits can be negative. Null when the transaction has no valid settlement currency recorded; the bare `amount` field always carries the raw value. |
declined_amount (anyOf 2) | null | Alternative | |
reason | string | Optional | Known values: AUTHORIZER, AUTHORIZER_AP_CARD_VELOCITY_LIMIT, AUTHORIZER_BUSINESS_LIMIT, AUTHORIZER_BUSINESS_SUSPENDED, AUTHORIZER_BUSINESS_VENDOR_BLACKLIST, AUTHORIZER_CARD_AUTO_LOCK_DATE, AUTHORIZER_CARD_CATEGORY_BLACKLIST, AUTHORIZER_CARD_CATEGORY_WHITELIST, AUTHORIZER_CARD_LIMIT, AUTHORIZER_CARD_MCC_BLACKLIST, AUTHORIZER_CARD_MISSING_POLICY_ITEMS, AUTHORIZER_CARD_NOT_ACTIVATED, AUTHORIZER_CARD_PARTIALLY_ACTIVATED, AUTHORIZER_CARD_START_DATE, AUTHORIZER_CARD_SUSPENDED, AUTHORIZER_CARD_TASK_SANCTION, AUTHORIZER_CARD_TOTAL_ACTIVATION_REQUIRED, AUTHORIZER_CARD_VENDOR_BLACKLIST, AUTHORIZER_CARD_VENDOR_WHITELIST, AUTHORIZER_COMMANDO_MODE, AUTHORIZER_FRAUD, AUTHORIZER_FREEZE_TRANSACTIONS_RISK, AUTHORIZER_GLOBAL_MCC_BLACKLIST, AUTHORIZER_MEMBER_LIMIT, AUTHORIZER_NON_AP_CARD_VELOCITY_LIMIT, AUTHORIZER_OOB_BLOCKED_MERCHANT, AUTHORIZER_OOB_DAILY_BUSINESS_BALANCE, AUTHORIZER_OOB_DAILY_CARD_SPEND, AUTHORIZER_RAMP_AUTHORIZATION_METHODS, AUTHORIZER_RAMP_TRANSACTION_AMOUNT_LIMIT, AUTHORIZER_RAMP_VENDOR_RESTRICTIONS, AUTHORIZER_SPEND_ALLOCATION_ARCHIVED_FUNDS, AUTHORIZER_SPEND_ALLOCATION_MEMBER_SUSPENDED, AUTHORIZER_SPEND_ALLOCATION_SUSPENDED, AUTHORIZER_TRANSACTION_AMOUNT_LIMIT, AUTHORIZER_UNAUTHORIZED_USER, AUTHORIZER_UNDER_TRANSACTION_AMOUNT_LIMIT, AUTHORIZER_USER_LIMIT, AUTHORIZER_USER_SUSPENDED, BLOCKED_COUNTRY, CARD_EXPIRED, CARD_LOST_OR_STOLEN, CARD_TERMINATED, CHIP_FAILURE, FORBIDDEN_CATEGORY, INSECURE_AUTHORIZATION_METHOD, INSUFFICIENT_FUNDS, INVALID_PIN, MISSING_CVV, MISSING_EXPIRATION, MOBILE_WALLET_FAILURE, MOBILE_WALLET_TOKEN_NOT_FOUND, MOBILE_WALLET_TOKEN_TERMINATED, NETWORK_DECLINE_ACCOUNT_VERIFICATION, NETWORK_DECLINE_ADVICE, NETWORK_DECLINE_ADVICE_ACQUIRER_ISSUE, NETWORK_DECLINE_ADVICE_ADDITIONAL_AUTHENTICATION_REQUIRED, NETWORK_DECLINE_ADVICE_FORCED_STIP_BY_ISSUER, NETWORK_DECLINE_ADVICE_ISSUER_LOGGED_OFF, NETWORK_DECLINE_ADVICE_ISSUER_TIMEOUT, NETWORK_DECLINE_ADVICE_ISSUER_UNAVAILABLE, NETWORK_DECLINE_ADVICE_PIN_ERROR, NETWORK_DECLINE_ADVICE_RECURRING_PAYMENT, NETWORK_DECLINE_ADVICE_SELECTIVE_ACCEPTANCE_SERVICE, NETWORK_DECLINE_ADVICE_SUSPECTED_FRAUD_TRANSACTION, NETWORK_DECLINE_ADVICE_TOKEN_PROVISIONING_SERVICE, NETWORK_DECLINE_ADVICE_VISA_PAYMENT_CONTROLS_RULE, NOT_ACTIVE, NOT_ALLOWED, NO_AUTO_ROUTED_LIMITS_AVAILABLE, NO_LINKED_SPEND_ALLOCATION, OFAC_VERIFICATION_NEEDED, OPEN_TO_BUY_LIMIT, OTHER, PIN_BLOCKED, PIN_TRY_LIMIT_EXCEEDED, PROCESSOR_CAP, QUASI_CASH, ROUTED_TO_TERMINATED_SPEND_ALLOCATION, STRIPE_WEBHOOK_TIMEOUT, SUSPECTED_BIN_ATTACK, SUSPECTED_FRAUD, THREE_D_SECURE_REQUIRED, USER_BLOCKED, USER_TERMINATED, WRONG_ADDRESS, WRONG_CVV, WRONG_EXPIRATION, WRONG_POSTAL_CODE |
Referenced models: Fetch a transaction — response body — entity amount currency, value