Add Card Service

Add Card Service Request Model;

Method	API URL	Parameter
POST	https://posservice.esnekpos.com/api/services/RecurringPaymentCardAdd	JSON File

The parameters to be sent to the service are as follows;

Add Card Service Request Message Parameters

Parameters	Type	Compulsory	Description
MERCHANT	string	Yes	It is a unique credential created specifically for the member business.
MERCHANT_KEY	string	Yes	It is the key information created specifically for the member business.
ORDER_REF_NUMBER	string	Yes	It is the reference number information given by the merchant when sending the payment transaction request. The process of adding a card is performed by matching the reference number of the relevant merchant.
CARD	object	Yes

EYVCREDİTCARD

Parameters	Type	Compulsory	Description
CC_NUMBER	string	Yes	It is the 16-digit card number information of the card on which the payment will be made.
EXP_MONTH	string	Yes	It is the month information of the 2-digit expiration date of the card on which the payment will be made.
EXP_YEAR	string	Yes	It is the 4-digit expiry date of the card, on which the payment will be made, and the year.
CC_CVV	string	Yes	It is the 3-digit security code information on the back of the card where the payment will be made.
CC_OWNER	string	Yes	It is the name and surname information of the card holder to whom the payment will be made.

Here is a sample JSON file to send to the service;

                                            
{
    "MERCHANT": "TEST1234",
    "MERCHANT_KEY": "4oK26hK8MOXrIV1bzTRVPA==",
    "ORDER_REF_NUMBER": "ORDER_REF_NUMBER",
    "CARD" : {
        "CC_NUMBER": "4531444531442283",
        "EXP_MONTH": "12",
        "EXP_YEAR": "2026",
        "CC_CVV": "111",
        "CC_OWNER": "TEST USER"
    }
}
                                        

Add Card Service Reply Message;

The parameters of the reply message sent from the service after the transaction are as follows;

Add Card Service Reply Message Parameters

Parameters	Type	Compulsory	Description
RETURN_CODE	string	Evet	The status of the card insertion process is the code information.
RETURN_MESSAGE	string	Evet	The status message is the result of the card insertion process.

                                            
{
    "RETURN_CODE": "0",
    "RETURN_MESSAGE": "SUCCESS",
}
                                        

If the value of RETURN_CODE parameter is 0 and the value of RETURN_MESSAGE parameter is SUCCESS in the reply message of the card adding service, it means that the process of adding the card was successful.