Checkout.com · Decline codes
What does Checkout.com 20099 “Other / Unidentified responses” mean?
Checked
Checkout.com 20099 "Other / Unidentified responses" means the payment failed with an answer that does not map to a specific code. Checkout.com treats it as a technical issue and says to request support if it persists. With no reason to go on, the shopper's best move is another attempt or another card.
- Type
- Soft decline (20xxx), technical
- Who declined
- Unclear: an unmapped response
- Retry
- Possibly. Visa category 4 (generic): at most 15 retries in 30 days
- Shopper action
- Try again, or use another card
- Merchant action
- Contact Checkout.com support if it repeats
What PlatformDTC does
PlatformDTC can run a store's own Checkout.com account at checkout and reads 20099 as a refusal another processor may approve. If the store picked PayPal card payments as its backup, the shopper is offered PayPal card fields on the spot; the card-testing guard and the store's block rules still run first. A subscription renewal declined with 20099 gets one more try 48 to 72 hours later with Smart retry on; if the bank refuses again, the customer is emailed a link to add a new card.
Why it happens
The issuer or network sent a response outside the standard set, so Checkout.com reports it as unidentified.
What the shopper can do
Try once more, or switch to a different card or PayPal.
What the store can do
Track how often you see 20099; a rising share is worth a support ticket with payment references.
For developers
The payment comes back with status Declined, response_code 20099 and a response_summary such as "Other / Unidentified responses" (Checkout.com notes the text can vary by endpoint). Checkout.com's Visa table puts this code in category 4, which it pairs with recommendation code 02 (try again later); read processing.recommendation_code on the response.
Frequently asked questions
- What does unidentified mean in Checkout.com 20099?
- The response did not match a known code, so no specific reason is available.
- Can I retry 20099?
- Yes. Visa treats unlisted responses as category 4, at most 15 retries in 30 days.
Sources
- API response codes — Checkout.com
- Visa response codes — Checkout.com
- Mapping to Visa system integrity fee categories — Adyen
Related
- 20096 — A system error stopped the payment. Not the shopper's card.
- 20091 — The shopper's bank could not be reached, so it could not approve the payment.
- 20068 — The bank did not answer in time, so the payment failed.
- 2005C — The bank blocks this kind of transaction on the card.
- 2009G — The cardholder has blocked payments like this on their own card.
- 200N7 — The security code (CVV) entered does not match the card.
- 200P1 — The card hit its daily spending limit.
- 200P9 — The amount is above a limit on the card; a smaller amount could pass.