# Add Card Service

## Add Card Service Request Model**;**

<table><thead><tr><th width="108.33333333333331">Method</th><th width="524">API URL</th><th>Parameter</th></tr></thead><tbody><tr><td>POST</td><td>https://posservice.esnekpos.com/api/services/RecurringPaymentCardAdd</td><td>JSON File</td></tr></tbody></table>

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

#### Add Card Service Request Message Parameters

<table><thead><tr><th width="220">Parameters</th><th width="84">Type</th><th width="69">Compulsory</th><th>Description</th></tr></thead><tbody><tr><td>MERCHANT</td><td>string</td><td>Yes</td><td>It is a unique credential created specifically for the member business.</td></tr><tr><td>MERCHANT_KEY</td><td>string</td><td>Yes</td><td>It is the key information created specifically for the member business.</td></tr><tr><td>ORDER_REF_NUMBER</td><td>string</td><td>Yes</td><td>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.</td></tr><tr><td>CARD</td><td>object</td><td>Yes</td><td></td></tr></tbody></table>

<br>

**EYVCREDİTCARD**

<table><thead><tr><th width="167">Parameters</th><th width="95">Type</th><th width="73">Compulsory</th><th>Description</th></tr></thead><tbody><tr><td>CC_NUMBER</td><td>string</td><td>Yes</td><td>It is the 16-digit card number information of the card on which the payment will be made.</td></tr><tr><td>EXP_MONTH</td><td>string</td><td>Yes</td><td>It is the month information of the 2-digit expiration date of the card on which the payment will be made.</td></tr><tr><td>EXP_YEAR</td><td>string</td><td>Yes</td><td>It is the 4-digit expiry date of the card, on which the payment will be made, and the year.</td></tr><tr><td>CC_CVV</td><td>string</td><td>Yes</td><td>It is the 3-digit security code information on the back of the card where the payment will be made.</td></tr><tr><td>CC_OWNER</td><td>string</td><td>Yes</td><td>It is the name and surname information of the card holder to whom the payment will be made.</td></tr></tbody></table>

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

```json
                                            
{
    "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 Messag&#x65;**;**

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

#### &#x20;Add Card Service Reply Message Parameters

<table><thead><tr><th width="198">Parameters</th><th width="84">Type</th><th width="83">Compulsory</th><th>Description</th></tr></thead><tbody><tr><td>RETURN_CODE</td><td>string</td><td>Evet</td><td>The status of the card insertion process is the code information.</td></tr><tr><td>RETURN_MESSAGE</td><td>string</td><td>Evet</td><td>The status message is the result of the card insertion process.</td></tr></tbody></table>

```json
                                            
{
    "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.