> For the complete documentation index, see [llms.txt](https://developer.esnekpos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.esnekpos.com/hoppa-gelistirici-ortami/tekrarli-odeme-servisi/kart-ekleme-servisi.md).

# Kart Ekleme Servisi

**Kart Ekleme Servisi İstek Modeli;**

<table><thead><tr><th width="108.33333333333331">Metod</th><th width="540">API URL</th><th>Parametreler</th></tr></thead><tbody><tr><td>POST</td><td>https://base-url/api/services/RecurringPaymentCardAdd</td><td>JSON File</td></tr></tbody></table>

Servise gönderilmesi gereken parametreler şu şekildedir;

Kart Ekleme Servisi İstek Mesajı Parametreleri

<table><thead><tr><th width="220">Parametre</th><th width="84">Tip</th><th width="69">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>MERCHANT</td><td>string</td><td>Evet</td><td>Üye iş yerine özel oluşturulan eşsiz kimlik bilgisidir.</td></tr><tr><td>MERCHANT_KEY</td><td>string</td><td>Evet</td><td>Üye iş yerine özel oluşturulan anahtar bilgisidir.</td></tr><tr><td>ORDER_REF_NUMBER</td><td>string</td><td>Evet</td><td>Üye iş yeri tarafından ödeme işlemi isteği gönderilirken verilmiş olan referans numarası bilgisidir. Kart ekleme işlemi ilgili üye iş yerine ait belirtilen referans numarası ile eşleştirilerek işlem gerçekleştirilir.</td></tr><tr><td>CARD</td><td>object</td><td>Evet</td><td></td></tr></tbody></table>

<br>

**EYVCREDİTCARD**

<table><thead><tr><th width="167">Parametre</th><th width="95">Tip</th><th width="73">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>CC_NUMBER</td><td>string</td><td>Evet</td><td>Ödeme işleminin gerçekleştirileceği karta ait 16 haneli kart numarası bilgisidir.</td></tr><tr><td>EXP_MONTH</td><td>string</td><td>Evet</td><td>Ödeme işleminin gerçekleştirileceği karta ait 2 haneli son kullanım tarihini ay bilgisidir.</td></tr><tr><td>EXP_YEAR</td><td>string</td><td>Evet</td><td>Ödeme işleminin gerçekleştirileceği karta ait 4 haneli son kullanım tarihini yıl bilgisidir.</td></tr><tr><td>CC_CVV</td><td>string</td><td>Evet</td><td>Ödeme işleminin gerçekleştirileceği kartın arka yüzünde bulunan 3 haneli güvenlik kodu bilgisidir.</td></tr><tr><td>CC_OWNER</td><td>string</td><td>Evet</td><td>Ödeme işleminin gerçekleştirileceği kart sahibinin ad ve soyadı bilgisidir.</td></tr></tbody></table>

Servise gönderilecek örnek bir JSON dosyası şu şekildedir;

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

**Kart Ekleme Servisi Cevap Mesajı;**

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

\
Kart Ekleme Servisi Cevap Mesajı Parametreleri

| Parametre       | Tip    | Zorunlu | Açıklama                                          |
| --------------- | ------ | ------- | ------------------------------------------------- |
| RETURN\_CODE    | string | Evet    | Kart ekleme işlemi sonucu durumu kod bilgisidir.  |
| RETURN\_MESSAGE | string | Evet    | Kart ekleme işlemi sonucu durum mesaj bilgisidir. |

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

Kart ekleme servisi cevap mesajında `RETURN_CODE` parametresinin değeri **0** ve `RETURN_MESSAGE` parametresinin değeri **SUCCESS** olarak dönmesi işlem kart ekleme işleminin başarılı olarak gerçekleştiğini ifade etmektedir.