---
description: Understand Visa response code 28 (File temporarily unavailable for update or inquiry), its common causes, and how merchants should handle retries safely.
title: Decline Code 28: File Update File Locked Out
image: https://cdn.smartretry.com/cdn-cgi/image/width=1200,height=630,quality=85,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2Fuploads%2F2026%2F10%2Fog-decline-code-visa-issuer-response-code-28.png
---

VI

Visa

# Decline Code 28: File Update File Locked Out

soft decline

Last updated: November 20, 2026

## Still letting failed transactions slip through?

SmartRetry turns declines into approvals - automatically, intelligently, and without changing your payment provider.

Table of Contents

## Key details

Brand

Visa

Code

28

Category

Issuer Response Codes

Response

28

Detailed Response

File update file locked out

soft decline

## Code by card network

| Network | Code | Official wording            |
| ------- | ---- | --------------------------- |
| Visa    | 28   | File update file locked out |
| V Pay   | 28   | File update file locked out |

This transaction is retriable

Payments failing with code 28 are often recoverable with the right retry timing and routing. SmartRetry recovers up to 70% of soft declines with smart retries!

Actually, a big part of your declined transactions can be recovered

[Recover your revenue \>](/pricing)

## What it means

Decline code 28 is a Visa code: "File update file locked out". Visa response code 28 indicates that an issuer or network file required to process an update or inquiry is temporarily unavailable or locked out. This is a transient technical system error on the issuing bank or network side, rather than a reflection of the cardholder's account standing. It specifies that the endpoint or file could not be accessed at the exact moment of processing.

## Why does code 28 occur?

* The issuing bank or network is undergoing temporary system maintenance affecting file access.
* A transient technical glitch caused the required file for the update or inquiry to be locked at the moment of processing.
* An internal synchronization issue at the issuer is temporarily blocking data inquiries or updates.

## How to solve 28?

Treat the decline as a temporary system or network error. Wait for a short period to allow the issuer's file lock to clear, then resubmit the transaction using a delayed backoff schedule. If subsequent attempts return the same code, escalate the issue to your payment processor or acquirer with the transaction identifiers and timestamps.

### Solving as a merchant

Pause immediate retries and utilize a delayed retry approach. Do not advise the customer that their card is invalid or prompt them for a replacement card solely based on this code. Instead, monitor your transaction logs, and if the code recurs persistently, contact your acquirer to investigate the endpoint lock or unavailability.

### Solving as a client

Since this is a backend technical issue at the issuer or network level, the customer does not need to take immediate action regarding their card. If the merchant cannot resolve the error after delayed retries, the customer may be asked to provide an alternate payment method to complete the checkout.

💡 Tip from SmartRetry Avoid rapid automated retries, as hammering the issuer during a file lock can prolong the concurrency block. Instead, schedule a multi-hour backoff or temporarily pause batch processing for that specific BIN to give the issuer's database sync time to clear.

[See the full list of Visa's decline codes \>](/payment-providers/visa#statuses)[Find code on Visa's website \>](https://developer.visa.com/request%5Fresponse%5Fcodes)

### Frequently asked questions about this topic

Does Visa response code 28 mean the customer's card is canceled?

No. Code 28 indicates a temporary technical issue where the issuer's file required for the transaction is unavailable or locked. It does not mean the card is invalid, closed, or over its limit.

Should I retry a transaction that declined with code 28?

Yes, this code is conditionally retryable. Because it represents a temporary unavailability or file lock, you should use a delayed retry strategy rather than immediately looping the request.

How do I fix a persistent code 28 error?

If delayed retries continue to fail with this code, stop automated attempts and escalate to your acquirer or processor. Provide them with transaction identifiers and timestamps so they can investigate the persistent file lock with the issuer.

#### Share this article

[![Share on X](https://cdn.smartretry.com/cdn-cgi/image/width=3840,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2F_next%2Fstatic%2Fmedia%2Ftwitter.21z6yr9njnznr.svg)](https://twitter.com/intent/tweet?text=Decline%20Code%2028%3A%20File%20Update%20File%20Locked%20Out&url=https%3A%2F%2Fwww.smartretry.com%2Fdecline-code%2F28-file-locked-out "Share on X")[![Share on Facebook](https://cdn.smartretry.com/cdn-cgi/image/width=3840,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2F_next%2Fstatic%2Fmedia%2Ffacebook.3sbfjbsxa26qg.svg)](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fwww.smartretry.com%2Fdecline-code%2F28-file-locked-out "Share on Facebook")[![Share on LinkedIn](https://cdn.smartretry.com/cdn-cgi/image/width=3840,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2F_next%2Fstatic%2Fmedia%2Flinkedin.09sdc8tnlrn4a.svg)](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fwww.smartretry.com%2Fdecline-code%2F28-file-locked-out "Share on LinkedIn")

Make us your preferred source

![Kyle Regacho](https://cdn.smartretry.com/cdn-cgi/image/width=256,quality=75,format=auto,fit=cover/https%3A%2F%2Fsecure.gravatar.com%2Favatar%2Faa4329c7f45a68c68f2fbccab899d0f43f3740f3f9e92d5c6ea711171fc1a35f%3Fs%3D96%26d%3Dmm%26r%3Dg)

Author

##### Kyle Regacho

[![LinkedIn](https://cdn.smartretry.com/cdn-cgi/image/width=32,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2F_next%2Fstatic%2Fmedia%2Flinkedin.09sdc8tnlrn4a.svg)Find me on Linkedin](https://www.linkedin.com/in/kdregacho/)

Focused on payment recovery, decline codes, and authorization optimization at SmartRetry. Helps payment teams turn failed transactions into recovered revenue

[Read all articles >](/authors/kyle-regacho)

## Join our newsletter!

Real strategies to recover lost revenue - straight to your inbox

## Related codes

* [![Visa](https://cdn.smartretry.com/cdn-cgi/image/width=256,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2Fpayment-providers%2Flogos%2Fvisa.svg)10Approved, partialsoft declineRead more >](/decline-code/10-partial-approval)
* [![Visa](https://cdn.smartretry.com/cdn-cgi/image/width=256,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2Fpayment-providers%2Flogos%2Fvisa.svg)12Invalid transactionhard declineRead more >](/decline-code/12-invalid-transaction)
* [![Visa](https://cdn.smartretry.com/cdn-cgi/image/width=256,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2Fpayment-providers%2Flogos%2Fvisa.svg)13Invalid amounthard declineRead more >](/decline-code/13-invalid-amount)
* [![Visa](https://cdn.smartretry.com/cdn-cgi/image/width=256,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2Fpayment-providers%2Flogos%2Fvisa.svg)14Invalid card numberhard declineRead more >](/decline-code/14-invalid-card-number)

## Articles you may find interesting:

[View all](/blog)

[![When Processing Stops: Navigating Gateway Locks and Account Holds](https://cdn.smartretry.com/cdn-cgi/image/width=3840,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2Fuploads%2F2026%2F11%2Fresolving-payment-gateway-account-holds-guide.jpg) November 22, 2026 When Processing Stops: Navigating Gateway Locks and Account Holds When aggregators freeze processing, standard support tickets fail. Discover how fintech operators diagnose automated underwriting triggers, appeal held funds, and deploy redundant routing to eliminate single points of failure.](/blog/resolving-payment-gateway-locks-holds)[![Fine-Tuning Stripe for Subscriptions: How to Stop Losing Customers to Failed Payments](https://cdn.smartretry.com/cdn-cgi/image/width=3840,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2Fuploads%2F2026%2F11%2Fstripe-subscription-payment-optimization.jpg) November 17, 2026 Fine-Tuning Stripe for Subscriptions: How to Stop Losing Customers to Failed Payments Default billing setups quietly surrender recurring revenue to preventable declines. Discover how adjusting stored credential flags, deploying network tokens, and timing retries protect subscriber retention and improve authorization health.](/blog/optimize-stripe-recurring-payments)[![Understanding CAVV: How 3D Secure Tokens Secure Approvals and Shift Liability](https://cdn.smartretry.com/cdn-cgi/image/width=3840,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2Fuploads%2F2026%2F11%2Fcavv-cardholder-authentication-verification-value-3ds.jpg) November 10, 2026 Understanding CAVV: How 3D Secure Tokens Secure Approvals and Shift Liability Mastering 3D Secure CAVV tokens helps payment teams prevent false declines and secure fraud liability shifts. Learn how cryptographic validation impacts issuer authorization decisions and recurring payment retry performance.](/blog/what-is-cavv-in-3ds)[![Does Numeral Offer Load Balancing for Payment Requests?](https://cdn.smartretry.com/cdn-cgi/image/width=3840,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2Fuploads%2F2026%2F11%2Fnumeral-payment-routing-load-balancing-guide.jpg) November 7, 2026 Does Numeral Offer Load Balancing for Payment Requests? Discover why traditional load balancing fails across banking rails and multi-acquirer setups, and how intelligent routing protects your transaction approval rates.](/blog/numeral-load-balancing-payment-requests)

![SmartRetry - Payment Recovery Platform](https://cdn.smartretry.com/cdn-cgi/image/width=3840,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2F_next%2Fstatic%2Fmedia%2Flogo.3mm2n0hdxl3mi.svg)

## Decline codes tell you why. We fix it.

SmartRetry reads every decline reason and applies the right retry strategy for each one. Your recovery rate goes up without any changes to your payment provider.

---

```json
{"@context":"https://schema.org","@type":"Article","headline":"Decline Code 28: File Update File Locked Out","url":"https://www.smartretry.com/decline-code/28-file-locked-out","inLanguage":"en","author":{"@type":"Organization","@id":"https://www.smartretry.com/#organization","name":"SmartRetry","url":"https://www.smartretry.com","logo":{"@type":"ImageObject","url":"https://cdn.smartretry.com/logo.png","width":{"@type":"QuantitativeValue","value":175,"unitCode":"PX"},"height":{"@type":"QuantitativeValue","value":29,"unitCode":"PX"}},"description":"SmartRetry is a smart payment recovery platform that helps businesses save revenue from failed payment transactions and reduce false declines.","sameAs":["https://x.com/smartretry","https://www.facebook.com/smartretry","https://www.instagram.com/smartretry","https://www.linkedin.com/company/smartretry","https://www.youtube.com/@smartretry","https://github.com/smartretry"],"contactPoint":{"@type":"ContactPoint","contactType":"customer support","availableLanguage":["Hebrew","English"],"url":"https://www.smartretry.com/contact"},"address":{"@type":"PostalAddress","streetAddress":"Menachem Begin","addressLocality":"Tel Aviv-Yafo","addressCountry":"IL"}},"publisher":{"@type":"Organization","@id":"https://www.smartretry.com/#organization","name":"SmartRetry","url":"https://www.smartretry.com","logo":{"@type":"ImageObject","url":"https://cdn.smartretry.com/logo.png","width":{"@type":"QuantitativeValue","value":175,"unitCode":"PX"},"height":{"@type":"QuantitativeValue","value":29,"unitCode":"PX"}},"description":"SmartRetry is a smart payment recovery platform that helps businesses save revenue from failed payment transactions and reduce false declines.","sameAs":["https://x.com/smartretry","https://www.facebook.com/smartretry","https://www.instagram.com/smartretry","https://www.linkedin.com/company/smartretry","https://www.youtube.com/@smartretry","https://github.com/smartretry"],"contactPoint":{"@type":"ContactPoint","contactType":"customer support","availableLanguage":["Hebrew","English"],"url":"https://www.smartretry.com/contact"},"address":{"@type":"PostalAddress","streetAddress":"Menachem Begin","addressLocality":"Tel Aviv-Yafo","addressCountry":"IL"}},"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.smartretry.com/decline-code/28-file-locked-out","name":"Decline Code 28: File Update File Locked Out"},"description":"Understand Visa response code 28 (File temporarily unavailable for update or inquiry), its common causes, and how merchants should handle retries safely.","datePublished":"2026-09-24T11:18:33.000Z","dateModified":"2026-11-20T11:10:07.000Z","keywords":"Visa code 28, decline code 28, file update file locked out, Visa issuer response code, payment retries","about":{"@type":"Thing","name":"Visa Issuer Response Codes 28"}}
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://www.smartretry.com/"},{"@type":"ListItem","position":2,"name":"Decline Code","item":"https://www.smartretry.com/decline-code"},{"@type":"ListItem","position":3,"name":"28","item":"https://www.smartretry.com/decline-code/28-file-locked-out"}]}
```
