# 2. Saved Cards

## Saved Card List

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

{% hint style="info" %}
Important: Card transactions are high-security operations. Therefore, you must send the '**apikeyprivate**' and '**apiclientprivate**' parameters in the 'Header' section.

\
[<mark style="color:green;">**CardWallAPI Address**</mark>](https://developer.paywall.one/payment-orchestration-integration-document/environment)
{% endhint %}

**The parameters to be sent to the service are as follows:**

<table><thead><tr><th width="211">Parameter (Headers)</th><th width="93">Type</th><th width="156">Compulsory</th><th width="403">Description</th></tr></thead><tbody><tr><td>apikeyprivate</td><td>string</td><td>Yes</td><td>The Private Key obtained from the merchant's admin panel.</td></tr><tr><td>apiclientprivate</td><td>string</td><td>Yes</td><td>The Private Client obtained from the merchant's admin panel.</td></tr><tr><td>relationalid1</td><td>string</td><td>Yes</td><td>The first associated value of the saved card.</td></tr><tr><td>relationalid2</td><td>string</td><td>No</td><td>The second associated value of the saved card.</td></tr><tr><td>relationalid3</td><td>string</td><td>No</td><td>The third associated value of the saved card.</td></tr><tr><td>includedetails</td><td>boolean</td><td>No</td><td>If you want the card's detailed information (BIN, Type, Brand, Bank, etc.) to be returned, you must send TRUE.</td></tr></tbody></table>

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

<table><thead><tr><th width="184.33333333333331">Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>Name</td><td>string</td><td>The nickname provided during card addition.</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>Identity</td><td>string</td><td>The cardholder's identity number or tax identification number.</td></tr><tr><td>Expired</td><td>boolean</td><td>Indicates whether the card's expiration date has passed or not. If "True" is returned, payments cannot be processed with that card.</td></tr><tr><td>Scope</td><td>int</td><td>It is the parameter that indicates the area in which the card will be used.</td></tr><tr><td>CardTypeId</td><td>int</td><td>It represents the brand of the card, such as MasterCard, Visa, etc.</td></tr><tr><td>CardType</td><td>string</td><td>It returns the card's brand as a string.</td></tr><tr><td>UniqueCode</td><td>string</td><td>It is the card identifier to be used when making a payment with the card. This information changes at regular intervals. Therefore, the UniqueCode information of the saved card should not be stored. A card list should be retrieved from Paywall before each payment.</td></tr></tbody></table>

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

```json
"ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": [
        {
            "Scope": 2,
            "Name": "test kartı",
            "Identity": "",
            "CardBin": "45467121",
            "CardLastFour": "7894",
            "CardHolderName": "Test Kartı",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "Credit",
            "Month": 12,
            "Year": 2025,
            "UniqueCode": "30H4WW7Es/HHB7l8PFvl+XnMQs1h0d2/cX7E5H9LgzOw1Ef0E7whSQ==",
            "Details": {
                "CardBankId": 53,
                "CardBank": "T.C.ZİRAAT BANKASI A.Ş.",
                "CardBrandId": 2,
                "CardBrand": "Visa",
                "CardFamilyId": 7,
                "CardFamily": "Combo",
                "CardKindId": 1,
                "CardKind": "Bireysel Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        },
        {
            "Scope": 2,
            "Name": "test kartı",
            "Identity": "273******602",
            "CardBin": "43550930",
            "CardLastFour": "7894",
            "CardHolderName": "Test Kartı",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "Credit",
            "Month": 12,
            "Year": 2025,
            "UniqueCode": "EzqrWIPvZAewotdQ48DRsrnu/WBfOwvOctM11rOaeEMvYDqGZzpPxA==",
            "Details": {
                "CardBankId": 58,
                "CardBank": "AKBANK T.A.Ş.",
                "CardBrandId": 2,
                "CardBrand": "Visa",
                "CardFamilyId": 4,
                "CardFamily": "Axess",
                "CardKindId": 1,
                "CardKind": "Bireysel Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        }
```

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