--- description: Learn the causes and resolution steps for Visa Issuer Response Code 25 (Unable to locate record on file). Discover how to handle this specific data error. title: Visa Issuer Response Code 25 - Unable to Locate Record 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 25: Unable to locate record on file technical declinehard 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 25 \- "Unable to locate record on file" ## 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 25 Category Issuer Response Codes Response 25 Detailed Response Unable to locate record on file technical declinehard decline ## What it means Visa issuer response code 25 indicates that the issuing bank or payment processing system was unable to locate the relevant transaction or account record in its file. It frequently functions as a system or data error indicating that the account number was missing from the inquiry, or that a linked transaction reference was malformed. It is distinct from an invalid account number decline and should primarily be treated as a data formatting or record-location problem. ## Classification & retryability technicalhardRetryable: conditional Do not perform automated blind retries. You may attempt one controlled retry only after manually verifying that the PAN, token, expiration date, and any required original-transaction references are properly populated in the request payload. ## Why does code 25 occur? * The transaction request omitted the account number or other mandatory account data. * An inquiry, reversal, or subsequent message referenced an original transaction ID that could not be found. * The submitted credit card details or network token were not recognized by the issuer's system. * A system error occurred at the processor or network level preventing the location of the account record. ## How to solve 25? First, inspect your gateway and acquirer logs to verify that the request payload was constructed properly, ensuring that the primary account number (PAN), token, or account details were not missing. For reversals or inquiries, confirm that the retrieval reference number or original transaction ID correctly links to an existing transaction. If all data fields are populated correctly and the issue persists, route the technical details to your acquirer for investigation, as this may be a system-level routing or mapping error. ### Solving as a merchant Validate the request payload for missing account data and verify any transaction references linked to previous authorizations. Limit retries to a single attempt after validating the payment method mapping and account data, and offer the customer an alternative payment method if the single retry fails. Do not set up infinite automated retries, which could risk duplicate processing and poor customer experience. ### Solving as a customer Check the credit card information entered for any typos or missing details. If the card details are correct but the payment still fails, try using an alternative payment method or contact the issuing bank to ensure the account is active. 💡Tip from SmartRetry Avoid immediate, automated retries with identical payloads, as unverified reference IDs will trigger recurring declines; instead, gate retries behind automated payload validation or test routing through a secondary acquirer connection if fields appear correct. [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 Is Visa code 25 the same as an invalid account number? No, Visa code 25 is distinct from Visa code 14 (Invalid Account Number). Code 25 typically points to a broader system error where a record, account number, or linked transaction reference was missing or could not be located in the system's file. Can I automatically retry transactions that return Visa code 25? Automated blind retries are not recommended. You should only permit one controlled retry after manually verifying the card data, network token, and original-transaction reference fields to avoid duplicate processing risks. Why did an authorization reversal return Visa code 25? For messages that depend on an earlier transaction, such as reversals or inquiries, code 25 indicates that the original transaction reference (like a retrieval reference number) was either malformed, mismatched, or could not be found in the processor's system. #### 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%2025%3A%20Unable%20to%20locate%20record%20on%20file&url=https%3A%2F%2Fwww.smartretry.com%2Fdecline-code%2Fvisa-issuer-response-code-25 "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-25 "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-25 "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 25: Unable to locate record on file","url":"https://www.smartretry.com/decline-code/visa-issuer-response-code-25","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-25","name":"Visa Issuer Response Code 25: Unable to locate record on file"},"description":"Learn the causes and resolution steps for Visa Issuer Response Code 25 (Unable to locate record on file). Discover how to handle this specific data error.","datePublished":"2026-09-24T11:20:37.000Z","dateModified":"2026-09-25T07:22:37.000Z","keywords":"Visa code 25, Unable to locate record on file, Visa response code 25, Cybersource ESYSTEM RCODE 0, Adyen code 25","about":{"@type":"Thing","name":"Visa Issuer Response Codes 25"}} {"@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":"25","item":"https://www.smartretry.com/decline-code/visa-issuer-response-code-25"}]} ```