1. New Card

It is recommended that you only add new cards through your servers (Back-End). It is not recommended to directly access your applications (End User).

Save New Card

POST {{Base Address}}/paywall/card

Important: Card transactions are highly secure transactions. Therefore, you need to send the 'apikeyprivate' and 'apiclientprivate' parameters in the 'Header' field. CardWallAPI Address

The (HEADERS) parameters that should be sent to the service are as follows:

Parameter	Type	Required	Description
apikeyprivate	string	Yes	Private Key that you have obtained from the merchant panel.
apiclientprivate	string	Yes	Private Client that you have obtained from the merchant panel.

The (BODY) parameters that should be sent to the service are as follows:

Parameter	Type	Required	Description
RelationalId1	string	Yes	Unique information that the card is requested to be associated with.
RelationalId2	string	No	Unique second information to be associated with the card (all information must be sent at the time of listing).
RelationalId3	string	No	The unique third information that the card is requested to be associated with (all information must be sent at the time of listing).
Nickname	string	Yes	Card's nickname (Example: My high limit card).
HolderName	string	Yes	Cardholder name on top of card.
Number	string	Yes	Card's number
Month	int	Yes	Card expiration date (month)
Year	int	Yes	Card expiration date (year) - Parameter must be 4 characters

An example JSON file to be sent to the service is as follows:

JSON

{
    "RelationalId1": "1000923",
    "RelationalId2": "",
    "RelationalId3": "",
    "Card": {
        "Nickname": "Yüksek limitli kartım",
        "HolderName": "Emir Selim Tütüncü",
        "Number": "4546711234567894",
        "Month": 12,
        "Year": 2026
    }
}

The parameters returned from the service are as follows:

Parameter	Type	Description
ErrorCode	int	If the operation is successful, it returns '0'.
Result	bool	Returns true or false. Returns 'true' if the operation was successful.
Message	string	If the operation is wrong, this is the message about the error, it provides language support according to the locale parameter.
Body	object	If the operation is faulty, the detail object about this error.