# 3. Saved Cards

## Saved card list

<mark style="color:blue;">`GET`</mark> `{{Base Adres}}/paywall/card`

{% hint style="info" %}
Important: Card operations are high-security transactions. Therefore, you must send the 'apikeyprivate' and 'apiclientprivate' parameters in the 'Header'\
\
[<mark style="color:green;">**CardWallAPI Address**</mark>](/payment-orchestration-integration-document/environment.md)
{% endhint %}

#### The parameters that must be sent to the service are as follows:

<table><thead><tr><th width="211">Parameter</th><th width="93">Type</th><th width="141.48046875">Compulsory</th><th width="403">Description</th></tr></thead><tbody><tr><td>apikeyprivate</td><td>string</td><td>Yes</td><td>The Private Key you obtained from the merchant panel.</td></tr><tr><td>apiclientprivate</td><td>string</td><td>Yes</td><td>The Private Client you obtained from the merchant panel.</td></tr><tr><td>relationalid1</td><td>string</td><td>Yes</td><td>The first associated value of the stored card.</td></tr><tr><td>relationalid2</td><td>string</td><td>No</td><td>The second associated value of the stored card.</td></tr><tr><td>relationalid3</td><td>string</td><td>No</td><td>The third associated value of the stored card.</td></tr><tr><td>includedetails</td><td>bool</td><td>No</td><td>If you want the card details (BIN, Type, Brand, Bank, etc.) to be returned, you must send it as <code>TRUE.</code></td></tr><tr><td>partneridentity</td><td>bool</td><td>No</td><td>For a card registered within the scope of Partnership, the identity information of the Partner account must be provided.</td></tr></tbody></table>

**The parameters returned from the service are as follows:**

<table><thead><tr><th width="184.33333333333331">Parameter</th><th width="281">Type</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>string</td><td>The alias name provided when adding the card.</td></tr><tr><td>CardBin</td><td>string</td><td>The BIN information of the card.</td></tr><tr><td>CardLastFour</td><td>string</td><td>The last 4 digits of the card.</td></tr><tr><td>CardNumber</td><td>string</td><td>The masked card number. You can list it on your screens.</td></tr><tr><td>Expired</td><td>boolean</td><td>Indicates whether the card’s expiration date has passed or not. If it returns true, payments cannot be made with that card.</td></tr><tr><td>CardTypeId</td><td>int</td><td>Indicates the brand of the card (MasterCard, Visa, etc.).</td></tr><tr><td>CardType</td><td>string</td><td>Returns the card brand as a string.</td></tr><tr><td>UniqueCode</td><td>string</td><td>This is the card identifier that must be used when making a payment with the card. This value changes periodically. Therefore, the UniqueCode information of the stored card should not be stored. The card list should be retrieved from Paywall before each payment.</td></tr><tr><td>InsertDateTimeUtc</td><td>DateTime</td><td>The date when the card was added. It is returned in UTC.</td></tr></tbody></table>

{% tabs %}
{% tab title="JSON" %}
{% code lineNumbers="true" %}

```json
{
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": [
        {
            "Name": "Test Card",
            "CardBin": "453144",
            "CardLastFour": "2283",
            "CardHolderName": "Emir Selim Tütüncü",
            "CardNumber": "453144******2283",
            "Expired": false,
            "CardTypeId": 0,
            "CardType": "Visa",
            "Month": 12,
            "Year": 2025,
            "UniqueCode": "VtsSMsRKBLJMZBApXZrlyTLmKwu6SGYiSFl7/Q2n1d0j5Pon9uA6GQ==",
            "InsertDateTimeUtc": "2026-02-19T22:37:44.397415Z",
            "Details": {
                "CardBankId": 77,
                "CardBank": "AKTİF YATIRIM BANKASI A.Ş.",
                "CardBrandId": 2,
                "CardBrand": "Visa",
                "CardFamilyId": 5,
                "CardFamily": "Paraf",
                "CardKindId": 1,
                "CardKind": "Bireysel Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        },
        {
            "Name": "EnesIsbank",
            "CardBin": "552879",
            "CardLastFour": "0008",
            "CardHolderName": "Enes Selman Tütüncü",
            "CardNumber": "552879******0008",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "MasterCard",
            "Month": 9,
            "Year": 2027,
            "UniqueCode": "GG76g2CXnNky6rJEH5UOYYHZZzfONZhWS83O5/Ah5TUmmZ74oF0Ahw==",
            "InsertDateTimeUtc": "2026-02-19T22:37:44.397415Z",
            "Details": {
                "CardBankId": 55,
                "CardBank": "T.HALK BANKASI A.Ş.",
                "CardBrandId": 1,
                "CardBrand": "Master Card",
                "CardFamilyId": 5,
                "CardFamily": "Paraf",
                "CardKindId": 2,
                "CardKind": "Ticari Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        }
        {
            "Name": "thryhrt",
            "CardBin": "552879",
            "CardLastFour": "0008",
            "CardHolderName": "thryhrt",
            "CardNumber": "552879******0008",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "MasterCard",
            "Month": 12,
            "Year": 2030,
            "UniqueCode": "bzkBzQ5bH9KOtZ+wgI4RiVxBH2WYF9QeYC94wCqwAn51vC7wrYR4wA==",
            "InsertDateTimeUtc": "2026-02-19T22:37:44.397415Z",
            "Details": {
                "CardBankId": 55,
                "CardBank": "T.HALK BANKASI A.Ş.",
                "CardBrandId": 1,
                "CardBrand": "Master Card",
                "CardFamilyId": 5,
                "CardFamily": "Paraf",
                "CardKindId": 2,
                "CardKind": "Ticari Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        },
        {
            "Name": "thryhrt",
            "CardBin": "552879",
            "CardLastFour": "0008",
            "CardHolderName": "thryhrt",
            "CardNumber": "552879******0008",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "MasterCard",
            "Month": 12,
            "Year": 2030,
            "UniqueCode": "IiPYc67bYVYrChRnB4ThSVMERFSw5Vt2PUaBcXeKw9HBTwWqXOSbdQ==",
            "InsertDateTimeUtc": "2026-02-19T22:37:44.397415Z",
            "Details": {
                "CardBankId": 55,
                "CardBank": "T.HALK BANKASI A.Ş.",
                "CardBrandId": 1,
                "CardBrand": "Master Card",
                "CardFamilyId": 5,
                "CardFamily": "Paraf",
                "CardKindId": 2,
                "CardKind": "Ticari Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        }
    ]
}
```

{% endcode %}
{% endtab %}
{% endtabs %}


---

# Agent Instructions: 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:

```
GET https://developer.paywall.one/payment-orchestration-integration-document/card-storage-service/card-saving/3.-saved-cards.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.