---
title: "Using our Stored Card Feature"
slug: "using-our-stored-card-feature"
updated: 2025-02-20T14:11:34Z
published: 2025-02-20T14:11:34Z
canonical: "docs.apcopay.com/using-our-stored-card-feature"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apcopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Using our Stored Card Feature

### Stored Card Feature on the Hosted Payment Page
### 
The Hosted Payment Page includes a stored card feature, allowing users to select a previously saved card from a successful transaction. Users can select a previously used card, enter the **CVV**, and click **Confirm** to complete the transaction.



:::(Info) (Client Account)
 To check for stored cards, include the `ClientAccount` in the payload. This helps us identify if any cards are linked to the account.
:::

---

Below is an example of the payment page when the stored card feature is enabled:


<p align="center">
  <img src="https://cdn.document360.io/358ada76-9dff-4d31-80ba-dad90c84bfa9/Images/Documentation/image%284%29.png" style="border: 1px solid #000;">
</p>

---

### Enabling the Stored Card Feature for Transactions

To enable the stored card feature when processing payments, follow these steps:

#### 1. Include the `ClientAccount` in the Payload

When creating an HPP token, ensure that the `ClientAccount` is included as part of the `Client` object to check for any stored cards linked to the user account.

---

#### 2. User Selects 'Remember Card' on the Payment Page

On the payment page, the user must check the **'Remember Card'** option to store their card for future transactions.

<p align="center">
  <img src="https://cdn.document360.io/358ada76-9dff-4d31-80ba-dad90c84bfa9/Images/Documentation/remembercard.png" alt="remembercard" style="border: 1px solid #000";>
</p>


---

#### 3. Configure the `ShowSavedCards` Option (Optional)

You can specify how many saved cards will be available for the user to select. If set to **'1'**, only the most recent card will be displayed. If `ShowSavedCards` is not specified, the system defaults to showing up to **5** stored cards.

---

#### Example Payload

```json
{
  "TransactionType": "PURC",
  "Amount": 10.01,
  "Currency": "EUR",
  "IsTest": true,
  "OrderReference": "MerchantOrder1-556",
  "UniqueReference": "4b8da4f0-d3b4-44ae-8019-8c66905ffad7",
  "Language": "mt",
  "RedirectionURL": "https://yourURLhere.com/Redirect/",
  "CallBackURL": "https://yourURLhere.com/Listener",
  "FailRedirectionURL": "https://yourURLhere.com/FailRedirect/",
  "Client": {
    "Email": "joe.bloggs@testjb.com",
    "ClientAccount": "A203242",
    "FirstName": "Frictionless",
    "LastName": "Processed",
    "MobileNo": "00441234567",
    "Street": "High Street",
    "City": "Manchester",
    "State": "UK",
     "Country": "GBR",
    "ZIPCode": "MCD12323",
    "DateOfBirth": "1924-12-31",
    "IPAddress": "214.21.134.79"
  },
  "Routing": {
    "ForceBank": "PTEST"
  },
  "Configuration": {
    "CardHolderNameEdit": "true",
    "ShowSavedCards":"1"
  }
}
