3. Saved Cards

It is recommended to retrieve stored card data only through your servers (Back-End). Direct access from your applications (End User) is not recomme

Saved card list

GET {{Base Adres}}/paywall/card

Important: Card operations are high-security transactions. Therefore, you must send the 'apikeyprivate' and 'apiclientprivate' parameters in the 'Header' CardWallAPI Address

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

Parameter	Type	Compulsory	Description
apikeyprivate	string	Yes	The Private Key you obtained from the merchant panel.
apiclientprivate	string	Yes	The Private Client you obtained from the merchant panel.
relationalid1	string	Yes	The first associated value of the stored card.
relationalid2	string	No	The second associated value of the stored card.
relationalid3	string	No	The third associated value of the stored card.
includedetails	bool	No	If you want the card details (BIN, Type, Brand, Bank, etc.) to be returned, you must send it as TRUE.
partneridentity	bool	No	For a card registered within the scope of Partnership, the identity information of the Partner account must be provided.

The parameters returned from the service are as follows:

Parameter	Type	Description
Name	string	The alias name provided when adding the card.
CardBin	string	The BIN information of the card.
CardLastFour	string	The last 4 digits of the card.
CardNumber	string	The masked card number. You can list it on your screens.
Expired	boolean	Indicates whether the card’s expiration date has passed or not. If it returns true, payments cannot be made with that card.
CardTypeId	int	Indicates the brand of the card (MasterCard, Visa, etc.).
CardType	string	Returns the card brand as a string.
UniqueCode	string	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.
InsertDateTimeUtc	DateTime	The date when the card was added. It is returned in UTC.

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"
            }
        }
    ]
}