---
description: Understand Visa response code 28 (File temporarily unavailable for update or inquiry), its common causes, and how merchants should handle retries safely.
title: Visa Response 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%2F_next%2Fstatic%2Fmedia%2Fog-image.0z0q4_5kazzzo.jpeg
---

[Skip to main content](#main-content)

![Visa](https://cdn.smartretry.com/cdn-cgi/image/width=96,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2Fpayment-providers%2Flogos%2Fvisa.svg)

Visa

# Visa Issuer Response Code 28: File Update File Locked Out

technical declinesoft decline

Last updated: September 25, 2026

## Still letting failed transactions slip through?

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

Email address Let’s talk

Table of Contents

## About 28 \- "File update file locked out"

## Key details

Brand

![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)

Code

28

Category

Issuer Response Codes

Response

28

Detailed Response

File update file locked out

technical declinesoft decline

## What it means

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.

## Classification & retryability

technicalsoftRetryable: conditional

Implement a delayed retry strategy with backoff. Do not attempt rapid immediate retries, as the file lock or unavailability is temporary but may take a short time to clear. If the error persists after multiple spaced attempts, halt automated retries.

## 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 customer

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=Visa%20Issuer%20Response%20Code%2028%3A%20File%20Update%20File%20Locked%20Out&url=https%3A%2F%2Fwww.smartretry.com%2Fdecline-code%2Fvisa-issuer-response-code-28 "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%2Fvisa-issuer-response-code-28 "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%2Fvisa-issuer-response-code-28 "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

Email address Subscribe

## 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)21No action takentechnical declineRead more >](/decline-code/visa-issuer-response-code-21)
* [![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 transactiontechnical declinehard declineRead more >](/decline-code/visa-issuer-response-code-12)
* [![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)19Re-enter transactiontechnical declinesoft declineRead more >](/decline-code/visa-issuer-response-code-19)

## Articles you may find interesting:

[View all](/blog)

[![Turning Payment Declines into Revenue with Context-Aware Retry Logic](https://cdn.smartretry.com/cdn-cgi/image/width=3840,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2Fuploads%2F2026%2F09%2Frecovering-revenue-with-intelligent-retries.jpg) September 25, 2026 Turning Payment Declines into Revenue with Context-Aware Retry Logic Blind retries waste fees and damage issuer trust. By analyzing decline codes and timing reattempts around payroll cycles, payment teams can successfully salvage recurring revenue without customer disruption.](/blog/turning-payment-declines-into-revenue-with-context-aware-retry-logic)[![Why Payments Fail: Decoding Decline Codes and Modernizing Retry Logic](https://cdn.smartretry.com/cdn-cgi/image/width=3840,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2Fuploads%2F2026%2F09%2Fpayment-declines-intelligent-retry-strategies.jpg) September 25, 2026 Why Payments Fail: Decoding Decline Codes and Modernizing Retry Logic Surface-level decline messages conceal critical issuer signals. Discover how intelligent retries, network tokens, and behavioral timing protect MID health and systematically recover lost recurring revenue.](/blog/why-payments-fail-decoding-decline-codes-and-modernizing-retry-logic)[![Decoding Payment Declines: Turning Authorization Failures into Recovered Revenue](https://cdn.smartretry.com/cdn-cgi/image/width=3840,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2Fuploads%2F2026%2F09%2Fresolving-card-authorization-declines-issuer-codes.jpg) September 25, 2026 Decoding Payment Declines: Turning Authorization Failures into Recovered Revenue Blindly retrying failed transactions hurts authorization rates and risks network fines. Discover how decoding issuer responses turns card declines into recovered revenue.](/blog/decoding-payment-declines-turning-authorization-failures-into-recovered-revenue)[![The Real Cost of Payment Declines and How to Recover Lost Revenue](https://cdn.smartretry.com/cdn-cgi/image/width=3840,quality=75,format=auto,fit=cover/https%3A%2F%2Fcdn.smartretry.com%2Fuploads%2F2026%2F09%2Frecovering-failed-payment-declines-revenue-advmo-31a392251911.jpg) September 23, 2026 The Real Cost of Payment Declines and How to Recover Lost Revenue Payment failures cost merchants billions in uncaptured revenue and customer churn. Discover how data-driven retries and response code intelligence help teams recover failed transactions and protect conversion.](/blog/cost-of-payment-declines-recovery)

---

```json
{"@context":"https://schema.org","@type":"Article","headline":"Visa Issuer Response Code 28: File Update File Locked Out","url":"https://www.smartretry.com/decline-code/visa-issuer-response-code-28","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"],"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"],"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/visa-issuer-response-code-28","name":"Visa Issuer Response 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-09-25T07:22:38.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":"Visa","item":"https://www.smartretry.com/decline-code?provider=Visa"},{"@type":"ListItem","position":4,"name":"28","item":"https://www.smartretry.com/decline-code/visa-issuer-response-code-28"}]}
```