---
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: Decline Code 25: Unable to Locate Record on File
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-25.png
---

VI

Visa

# Decline Code 25: Unable to Locate Record on File

hard 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

25

Category

Issuer Response Codes

Response

25

Detailed Response

Unable to locate record on file

hard decline

## Code by card network

| Network | Code | Official wording                |
| ------- | ---- | ------------------------------- |
| Visa    | 25   | Unable to locate record on file |
| V Pay   | 25   | Unable to locate record on file |

This transaction is not retriable

Payments failing with code 25 are hard declines and typically cannot be recovered by retrying. SmartRetry still helps you avoid future hard declines with smarter routing and validation.

But many other declines in your payment flow may still be recoverable. SmartRetry identifies which failed transactions have recovery potential and applies the right strategy to recover them.

[Find out what you can recover \>](/pricing)

## What it means

Decline code 25 is a Visa code: "Unable to locate record on file". 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.

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

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=Decline%20Code%2025%3A%20Unable%20to%20Locate%20Record%20on%20File&url=https%3A%2F%2Fwww.smartretry.com%2Fdecline-code%2F25-unable-to-locate-record "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%2F25-unable-to-locate-record "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%2F25-unable-to-locate-record "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 25: Unable to Locate Record on File","url":"https://www.smartretry.com/decline-code/25-unable-to-locate-record","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/25-unable-to-locate-record","name":"Decline 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-11-20T11:10:05.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":"25","item":"https://www.smartretry.com/decline-code/25-unable-to-locate-record"}]}
```
