# 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 %}    |                                                                                                                                                                                                                                       |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.paynet.com.tr/uornek/servisler/kart-saklama/3.oedeme-almadan-kart-verisi-kaydetme/untitled.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
