5. Update Card

It is recommended to perform stored card update operations only through your servers (Back-End). Direct access from your applications (End User) is not recommended.

Stored Card Update

PUT {{Base Adres}}/paywall/card

Sending a request to the above endpoint is sufficient. You can use the Base Address for both Test and Production environments as needed.

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

The parameters that must be sent to the service (HEADERS) 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

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

Parameter	Type	Compulsory	Description
PartnerBased	bool	No	Valid for cards registered within the scope of Partnership
PartnerIdentity	string	Yes/No	Valid for cards registered within the scope of Partnership
RelationalId1	string	Yes	The unique information associated with the card
RelationalId2	string	No	The second unique information associated with the card
RelationalId3	string	No	The third unique information associated with the card
UniqueCode	string	Yes	The unique identifier (ID) of the stored card
Nickname	string	Yes	Alias name of the card (e.g., My high-limit card)
Month	int	Yes	Expiration month of the card to be updated
Year	int	Yes	Expiration year of the card to be updated

JSON

{
    "PartnerBased": false,
    "PartnerIdentity": "",
    "RelationalId1": "003",
    "RelationalId2": "004",
    "RelationalId3": "",
    "UniqueCode": "921245xQN85D0+Zuf7oAJv5@@@@@G86eN7RA4cX8L4hHo7Ma3hg7AW7Bq232yPyw2iVPkrt1qEw==",
    "Nickname": "Yurtdışı kartım",
    "Month": 12,
    "Year": 2030
}

Servisten işlem sonrasında gönderilen cevap mesajına ait parametreler şu şekildedir :

Parameter	Type	Description
ErrorCode	int	Indicates the result of the operation. Returns '0' if successful, otherwise '1'
Result	string	Returns 'true' if the operation is successful, otherwise 'false'
Message	string	Indicates the result message of the operation
Body	nesne	If the operation fails, this is the detail object related to the error

Example Code:

JSON

{
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": ""
}