Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.whop.com/llms.txt

Use this file to discover all available pages before exploring further.

Whop Cards apply a set of system rules, card limits, and real-time risk checks to every authorization. This page explains the most common reasons a card transaction is declined, the authorization codes you may encounter, and the automatic risk rules enforced during authorization.

Common transaction decline reasons

Declines can occur for several reasons, including system rules, card limits, and real-time risk checks. When a transaction is declined, a reason describing the cause is recorded with the transaction. This list is not exhaustive. Some declines originate at the card network or processor rather than from a Whop rule, and these take precedence. In those cases the reason may be a generic description such as restricted card, or may not be available at all.

What you can do about a decline

Many declines are expected outcomes you can act on. The table below maps common reasons to their cause and your next step:
Decline reasonWhat it meansWhat you can do
card spending limit exceededThe card’s configured spending limit was reachedReview or adjust the card’s spending controls
account credit limit exceededInsufficient available balance for the transactionAdd funds to your balance before retrying
card locked / card canceled / card not activatedThe card is not in an active stateManage the card’s status (activate or unlock as appropriate)
invalid pin attempt limit exceededToo many incorrect PIN attempts; the card is automatically lockedUnlock the card to restore access, or contact Whop support
transaction declined by risk rulesThe authorization was declined by the fraud risk scoring engineContact Whop support if you believe a transaction was declined in error
restricted countryThe transaction originated in a restricted or sanctioned jurisdictionThese declines follow compliance policy and cannot be overridden
A few additional defaults worth noting:
  • ATM withdrawals are disabled by default.
  • Quasi-cash and certain money-transfer categories are restricted by default.
  • 3D Secure (3DS): a failed 3DS verification can result in a decline.
  • Address Verification (AVS): AVS is supported and configurable per card; mismatches can contribute to a decline.

Authorization codes and their meanings

Whop Cards use specific authorization codes to classify the context and status of each transaction. Here are some commonly encountered codes:
CodeMeaning
00Normal presentment
01Customer not present
02Unattended terminal - card can be retained
03Merchant suspicious
05Customer present, card not present
06Pre-authorized request
07Telephone device required
08Mail/telephone order
09POS security alert
10Customer identity verified
11Suspicious Activity
12Security reasons
13Representation of item
14Public utility terminal
15Customer’s terminal
16Administrative terminal
17Returned item
18No check in envelope - return
19Deposit out of balance - return
20Payment out of balance - return
21Manual reversal
22Terminal error - counted
23Terminal error - not counted
24Deposit out of balance - apply
25Payment out of balance - apply
26Withdrawal error - reversed
27Unattended terminal - card cannot be retained
51Request for account number verification
59E-commerce request through public network
71Card present, magnetic stripe unreadable (U.S. only)

Risk rules enforced during authorization

Whop Cards enforce automatic risk detection rules to prevent high-risk or suspicious transactions. Each rule includes a time window and trigger threshold:
Rule nameDescriptionTime windowTrigger threshold
Blocked CountryDecline all transactions at blocked countriesImmediateN/A
High Risk MCCDecline transactions with high-risk MCCsImmediateN/A
High Risk E-commerceDecline transactions with flagged online merchantsImmediateN/A
E-commerce Rapid TransactionE-commerce transaction burst prevented, more than 2 transactions were attempted within a 5-minute period5 Minutes2 Transactions
Card-present Rapid TransactionCard-present transaction burst prevented, more than 2 transactions were attempted within a 5-minute period5 Minutes2 Transactions
Card-not-present Daily VelocityCard-not-present transaction daily limit reached, more than 11 card-not-present transactions attempted within a 24-hour period24 Hours11 Transactions
Card-Merchant Daily VelocityDecline transactions between the same card and merchant when more than 200 transactions occur within a 24-hour period. Surfaces as transaction declined by risk rules24 Hours200 Transactions
Card-Merchant Authentication 15min Burst VelocityDecline Google temporary-hold (authentication) charges when the same card and merchant exceed 20 transactions within a 14-minute window14 Minutes20 Transactions
AFD Auth HoldFuel (MCC 5542) authorizations below $175 are placed on an over-authorization hold rather than declinedImmediate$175 USD
Gaming LimitDecline single video game/digital goods (MCC 5816/7994) transaction above $2,000Immediate$2,000 USD
Gaming VelocityDecline if more than 25 gaming transactions within a 2-day period2 Days25 Transactions
Ad Services LimitDecline single advertising services (MCC 7311) transaction above $10kImmediate$10,000 USD
Ad Services VelocityDecline if more than 40 advertising services (MCC 7311) transactions within a 24-hour period24 Hours40 Transactions
Adult Content LimitDecline single adult content (MCC 5967) transaction above $200Immediate$200 USD
Adult Content VelocityDecline if more than 10 adult content (MCC 5967) transactions within a 24-hour period24 Hours10 Transactions
CVV SecurityBlock transaction after 4 incorrect CVV attempts within a 24-hour period24 Hours4 Transactions
ATM Withdrawal LimitBlock ATM Withdrawal (MCC 6011) transaction exceeding $250Immediate$250 USD
ATM Withdrawal VelocityBlock ATM Withdrawal (MCC 6011) transaction velocity limit reached, more than 3 transactions were attempted within a 24-hour period24 Hours3 Transactions
High Velocity – EA Sports FCDecline when more than 5 transactions with the same card at Google EA Sports FC occur within a 24-hour period24 Hours5 Transactions
High Velocity – DiscordDecline when more than 10 transactions with the same card at Discord merchants occur within a 7-day period7 Days10 Transactions
High Velocity – Free Fire MAXDecline when more than 10 transactions with the same card at Google Free Fire MAX occur within a 24-hour period24 Hours10 Transactions
Default thresholds are shown above and may change over time as risk rules are updated. Alongside these rules, transactions are also scored by a fraud risk engine; high-risk authorizations are declined with transaction_declined_by_risk_rules.

Blocked categories and merchants

Whop Cards block certain merchant category codes (MCCs) and specific merchants by default. See Blocked categories & merchants for the full lists.

Next steps

Blocked categories & merchants

See the merchant categories and merchants that Whop Cards block by default

Whop Cards

Spend your balance instantly and earn cashback on select merchants