# 3.3.Kart Bilgisi Saklama Servisi

Kart saklama işlemlerinde OTP zorunluluğu var ve send otp servisinde oluşturulan kodu check\_otp servisi ile doğrulama yapar.

{% 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 | Evet    | CVV kodu                                                                                                                                                                                                   |
| **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   | Son kullanıcının send\_otp servisinde parametre olarak gönderilen numarası                                                                                                                                 |
| **otp\_session\_id** | string | Hayır   | OTP ile ilişkilendirilecek benzersiz değer. Bu değer ile saklanacak kart bilgisi ilişkilendirmesi yapılır.                                                                                                 |
| **user\_gsm**        | string | Hayır   | OTP doğrulama zorunlu ise send\_otp servisinde otp\_code gönderilen telefon numarası                                                                                                                       |
| {% 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\_masked**  | string | Kart numarasının ilk 6 son 4 tokenlanmış hali                                                 |
| **card\_bin\_no**     | string | Kartın ilk 6 hanesi                                                                           |
| **card\_type**        | string | Kart türü ; cc:Bireysel  bc:Ticari  dc:Debit                                                  |
| **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                                                                          |
| **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_masked":"455508********8053",
   "card_bin_no":"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/uornek/servisler/kart-saklama/3.oedeme-almadan-kart-verisi-kaydetme/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/uornek/servisler/kart-saklama/3.oedeme-almadan-kart-verisi-kaydetme/https:/pts-api.paynet.com.tr\[/v1/card/save)]\(<https://api.paynet.com.tr/v1/card/save>) |
| {% endtab %}     |                                                                                                                                                                                                                                       |
| {% endtabs %}    |                                                                                                                                                                                                                                       |