# Kart Bilgisi Saklama

Paynet üzerinden ödeme almadan kart bilgilerini kaydetmenizi sağlayan servistir.  Kart saklama servisini kullanırken aşağıdaki maddeler dikkat etmeniz gerekmektedir.

* İşlem sırasında kartı saklamak istiyorsanız müşterinizin benzersiz (unique)  bir bilgisine ihtiyacınız vardır ( userid, gsm no, e\_mail vs..).
* İlk defa kart saklama işlemi yaptığınızda **user\_unique\_id** parametresinde bu değeri göndermelisiniz. 
* Daha sonra Paynet sizin müşterinize ait  benzersiz **card\_owner\_id** üretir.
* Sizin de kendi sisteminizde kendi müşteri benzersiz değeriniz ile **card\_owner\_id** değerini ilişkilendirip saklamanız gerekir. 
* Bundan sonraki tüm işlemlerinizde **card\_owner\_id**'yi kullanacaksınız. Bir müşterinize bir kere kart saklama işlemi yaptıktan sonra  kart saklama ya da saklı karttan işlem alma isteklerinde artık  **card\_owner\_id** parametresi kullanacaksınız.

{% hint style="warning" %}
Bu servisi kullanabilmeniz için secret\_key ile basic authentication yapmalısınız. [bnkz](https://doc.paynet.com.tr/authentication#secret-key).
{% endhint %}

{% hint style="success" %}
<https://api.paynet.com.tr/v1/card/save>
{% endhint %}

{% tabs %}
{% tab title="İstek Parametreleri" %}

| Parametre İsmi       | Tip    | Zorunlu | Açıklama                                                                                                                                                                                                         |
| -------------------- | ------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **card\_desc**       | string | Evet    | Saklı karta verilen isim                                                                                                                                                                                         |
| **card\_holder**     | string | Evet    | Kart üzerindeki isim                                                                                                                                                                                             |
| **card\_number**     | string | Evet    | Kart numarası                                                                                                                                                                                                    |
| **expire\_month**    | string | Evet    | Kart üzerindeki ay                                                                                                                                                                                               |
| **expire\_year**     | string | Evet    | Kart üzerindeki yıl                                                                                                                                                                                              |
| **cvv**              | string | Hayır   | CVV kodu. CVV kodu gönderirseniz kart saklama sırasında bankadan kartın doğruluğunu kontrol etmek için 1 TL'lik ön provizyon alınıp iptal edilecektir.                                                           |
| **user\_unique\_id** | string | Hayır   | Üye iş yeri tarafından verilen kullanıcıya özgü benzersiz id. İlk defa kart saklama yapılıyorsa zorunlu.                                                                                                         |
| **card\_owner\_id**  | string | Hayır   | İlk defa kart saklama yapıldıktan sonra, Paynet tarafından user\_unique\_id’ye göre oluşturulan kart sahibinin benzersiz değeri. Bir sonraki kart saklama servisleri bu benzersiz değer üzerinden yapilir.       |
| **otp\_code**        | string | Hayır   | <p>Son kullanıcının send\_otp servisinde parametre olarak gönderilen numarası. </p><p>Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz.</p>                                 |
| **otp\_session\_id** | string | Hayır   | <p>OTP ile ilişkilendirilecek benzersiz değer. Bu değer ile saklanacak kart bilgisi ilişkilendirmesi yapılır. Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz.</p><p> </p> |
| **user\_gsm**        | string | Hayır   | OTP doğrulama zorunlu ise send\_otp servisinde otp\_code gönderilen telefon numarası.Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz.                                      |
| {% endtab %}         |        |         |                                                                                                                                                                                                                  |

{% tab title="Dönüş Parametreleri" %}

| Parametre İsmi        | Tip    | Açıklama                                                                                            |
| --------------------- | ------ | --------------------------------------------------------------------------------------------------- |
| **card\_desc**        | string | Saklı kart bilgisine verilen isim                                                                   |
| **card\_hash**        | string | Kart numarasının hashlenmiş değeri                                                                  |
| **card\_no**          | string | Kart numarasının ilk 6 son 4 tokenlanmış hali                                                       |
| **card\_bin**         | string | Kartın ilk 6 hanesi                                                                                 |
| **card\_type**        | string | Kart türü. [Bknz.](https://doc.paynet.com.tr/genel-bilgiler/veri-tipleri/kart-tipi)                 |
| **card\_bank\_name**  | string | Kartın banka adı ( Bonus,Axess,vs)                                                                  |
| **card\_logo\_url**   | string | Kartın logo görseli                                                                                 |
| **card\_brand\_name** | string | VISA,MASTERCARD,AMEX                                                                                |
| **card\_owner\_id**   | string | Kart sahibinin Paynet'in ürettiği benzersiz değeri                                                  |
| **user\_unique\_id**  | string | Üye iş yeri tarafından verilen kullanıcıya özgü benzersiz id. İlk saklamada gönderilen değer.       |
| **object\_name**      | string | Dönüş yapılan API’nin nesne adı                                                                     |
| **code**              | string | Dönüş sonucunun kodu. [Bknz](https://doc.paynet.com.tr/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message**           | string | Dönüş sonuç kodunun açıklaması                                                                      |
| {% endtab %}          |        |                                                                                                     |

{% tab title="Request" %}

```
{  
   "user_gsm":"5xxxyyzz",
   "otp_session_id":"otp_session_id",
   "otp_code":"ART2",
   "card_desc":"Kart aciklamasi",
   "card_holder":"Onur Ozdemir",
   "card_number":"435508xxxxxxxx",
   "expire_month":"12",
   "expire_year":"18",
   "cvv":"000",
   "user_unique_id":"benzersiz deger"
}
```

{% endtab %}

{% tab title="Response" %}

```
{  
   "card_owner_id":"abc45adc20-91ba-4a29-a599-0eb18177247e",
   "user_unique_id":"benzersiz deger",
   "card_desc":"test",
   "card_hash":"abcdef-8014-435e-8bcc-daf4592f3431",
   "card_no":"455508********8053",
   "card_bin":"435508",
   "card_type":"cc",
   "card_bank_name":"WorldCard",
   "card_logo_url":"https://pts-statics.paynet.com.tr/img/banklogo/small/AXSS.png",
   "card_brand_name":"VISA",
   "object_name":"card_save",
   "code":0,
   "message":"Başarılı İşlem"
}
```

{% endtab %}

{% tab title="Service Url" %}

| Sistem           | URL                                                                                                                                                                              |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/card/save](https://doc.paynet.com.tr/servisler/kart/https:/api.paynet.com.tr\[/v1/card/save)]\(<https://api.paynet.com.tr/v1/card/save>)         |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/card/save](https://doc.paynet.com.tr/servisler/kart/https:/pts-api.paynet.com.tr\[/v1/card/save)]\(<https://api.paynet.com.tr/v1/card/save>) |
| {% endtab %}     |                                                                                                                                                                                  |
| {% endtabs %}    |                                                                                                                                                                                  |