> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/tokenization/implement-tokenization/card-tokenization-request/processing-the-decision/decision-engine/data-validation-codes/wallet-reason-codes.md).

# Wallet reason codes

Wallet reason codes describe the recommendation context provided by the token requestor or wallet provider.

The token requestor generates these codes based on end user activity in the wallet application. It can send one or more of these codes in a Tokenization request to the payment network TSP when it recommends step-up authentication.

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="408.5455322265625">Wallet reason codes</th><th width="415.3636474609375">Description</th></tr></thead><tbody><tr><td>ACCOUNT_TOO_NEW_SINCE_LAUNCH</td><td><p>Wallet account too new relatively to the launch.</p><p><br></p><p>NOTE: the threshold is defined by the wallet. Please check with the wallet provider.<br><br><em>Availability: AXP, MDES, VTS</em></p></td></tr><tr><td>ACCOUNT_TOO_NEW</td><td><p>Wallet account too new relatively to the provisioning request.</p><p><br></p><p>NOTE: the threshold is defined by the wallet. Please check with the wallet provider.<br><br><em>Availability: AXP, MDES, VTS</em></p></td></tr><tr><td>ACCOUNT_CARD_TOO_NEW</td><td><p>Wallet account/card pair is newer than the threshold date.</p><p><br></p><p>NOTE: the threshold is defined by the wallet. Please check with the wallet provider.<br><br><em>Availability: AXP, MDES, VTS</em></p></td></tr><tr><td>ACCOUNT_RECENTLY_CHANGED</td><td><p>Changes made to the wallet account data within the date threshold.</p><p><br></p><p>NOTE: the threshold is defined by the wallet. Please check with the wallet provider.<br><br><em>Availability: AXP, MDES, VTS</em></p></td></tr><tr><td>SUSPICIOUS_ACTIVITY</td><td>Suspicious transaction linked to this account.<br><br><em>Availability: AXP, MDES, VTS</em></td></tr><tr><td>INACTIVE_ACCOUNT</td><td>The account did not have activity in the last year.<br><br><em>Availability: AXP, MDES, VTS</em></td></tr><tr><td>HAS_SUSPENDED_TOKENS</td><td>Suspended cards in the secure element.<br><br><em>Availability: AXP, MDES, VTS</em></td></tr><tr><td>DEVICE_RECENTLY_LOST</td><td><p>The device was in lost mode in the last 7 days for longer than the duration threshold.</p><p><br></p><p>NOTE: the threshold is defined by the wallet. Please check with the wallet provider.<br><br><em>Availability: AXP, MDES, VTS</em></p></td></tr><tr><td>TOO_MANY_RECENT_ATTEMPTS</td><td><p>The number of provisioning attempts on the device exceeds the threshold in 72 hours.</p><p><br></p><p>NOTE: the threshold is defined by the wallet. Please check with the wallet provider.<br><br><em>Availability: AXP, MDES, VTS</em></p></td></tr><tr><td>TOO_MANY_RECENT_TOKENS</td><td>Excessive number of different cards attempted provisioning requests on the device in 24 hours.<br><br><em>Availability: AXP, MDES, VTS</em></td></tr><tr><td>TOO_MANY_DIFFERENT_CARDHOLDERS</td><td><p>Provisioning request contains a distinct name in excess of the permitted threshold.</p><p><br></p><p>NOTE: the threshold is defined by the wallet. Please check with the wallet provider.<br><br><em>Availability: AXP, MDES, VTS</em></p></td></tr><tr><td>LOW_DEVICE_SCORE</td><td>The device score is less than 3.<br><br><em>Availability: AXP, MDES, VTS</em></td></tr><tr><td>LOW_ACCOUNT_SCORE</td><td>The wallet account score is less than 4.<br><br><em>Availability: AXP, MDES, VTS</em></td></tr><tr><td>OUTSIDE_HOME_TERRITORY</td><td>Device provisioning location is outside of marketplace store home country.<br><br><em>Availability: AXP, MDES, VTS</em></td></tr><tr><td>UNABLE_TO_ASSESS</td><td>Rules modelling not available at the time of the request processing (back end systems time out).<br><br><em>Availability: AXP, MDES, VTS</em></td></tr><tr><td>HIGH_RISK</td><td>Device is considered at high risk for card provisioning (also known as orange flow).<br><br><em>Availability: AXP, MDES, VTS</em></td></tr><tr><td>LOW_PHONE_NUMBER_SCORE</td><td>The phone number score is less than 3.<br><br><em>Availability: MDES, VTS</em></td></tr><tr><td>WALLET_NAME_DOES_NOT_MATCH_CARD_NAME</td><td>The cardholder name does not match the name registered in the wallet.<br><br><em>Availability: VTS</em></td></tr><tr><td>ACCOUNT_DEVICE_BIND_TOO_NEW</td><td><p>Wallet account to device binding age is below a threshold compared to the tokenization request.</p><p><br></p><p>NOTE: the threshold is defined by the wallet. Please check with the wallet provider.<br><br><em>Availability: AXP, VTS</em></p></td></tr><tr><td>ACCOUNT_ACTIVITY_RECENT</td><td><p>Account activity detected below a certain number of days threshold. This means that a recent account activity was detected.</p><p><br></p><p>NOTE: the threshold is defined by the wallet. Please check with the wallet provider.<br><br><em>Availability: VTS</em></p></td></tr><tr><td>TRANSACTIONS_LAST_12_MONTHS</td><td><p>Number of transactions in the last 12 months below a certain threshold. This means that in the last 12 months a limited number of transactions have been performed.</p><p><br></p><p>NOTE: the threshold is defined by the wallet. Please check with the wallet provider.<br><br><em>Availability: VTS</em></p></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.payments.thalescloud.io/tokenization/implement-tokenization/card-tokenization-request/processing-the-decision/decision-engine/data-validation-codes/wallet-reason-codes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.