# Kart ekleme başlatma

Düzenli ödemeye kart bilgisi ekleme işlemini başlatan servistir.

{% hint style="success" %}
<https://api.paynet.com.tr/v1/subscription/create\\_card\\_tds\\_initial>
{% endhint %}

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

| Parametre ismi             | Tip    | Zorunlu | Açıklama                                                                                                                     |
| -------------------------- | ------ | ------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **subscription\_id\***     | string | Evet    | Kartın ekleneceği düzenli ödeme IDsi                                                                                         |
| **reference\_no\***        | string | Evet    | Kartın ekleneceği düzenli ödeme referans numarası                                                                            |
| **group\_reference\_no\*** | string | Evet    | Birbiri ile ilişkilendirmek istediğiniz düzenli ödemeleri bu parametre altında grup yapabilirsiniz. En fazla 50 karakterdir. |
| **return\_url**            | string | Evet    | 3D doğrulama sonucunun post edileceği URL                                                                                    |
| **pan**                    | string | Evet    | Kart no                                                                                                                      |
| **card\_holder**           | string | Hayır   | Kart üzerindeki isim                                                                                                         |
| **month**                  | int    | Evet    | Kartın son kullanma tarihi ay bilgisi                                                                                        |
| **year**                   | int    | Evet    | Kartın son kullanma tarihi yıl bilgisi                                                                                       |
| **cvv**                    | string | Evet    | Kartın arkasında yer alan cvv bilgisi                                                                                        |
| **label**                  | string | Hayır   | Kartı sınıflandırmak için karta verilen etiket                                                                               |
| {% endtab %}               |        |         |                                                                                                                              |

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

| Parametre ismi    | Tip    | Açıklama                                                                                             |
| ----------------- | ------ | ---------------------------------------------------------------------------------------------------- |
| **session\_id**   | string | Kart ekleme akışının session bilgisi                                                                 |
| **token\_id**     | string | İşlemin token bilgisi                                                                                |
| **post\_url**     | string | Bu URL'e redirect ettiğinizde bankanın 3D doğrulama sayfasını gösterir.                              |
| **html\_content** | string | post\_url yerine bu HTML content'i sayfanıza eklediğinizde bankanın 3D doğrulama sayfasını gösterir. |
| **Result Info**   |        |                                                                                                      |
| {% endtab %}      |        |                                                                                                      |

{% tab title="Request" %}

```
{ 
"group_reference_no":"test",
"reference_no":"test",
"pan":"435508******4358",
"card_holder":"A*** D******",
"return_url":"https://paynet.com.tr/",
"month":"12",
"year":"20",
"cvv":"***"
}
```

{% endtab %}

{% tab title="Response" %}

```
{
    "session_id": "session_id",
    "token_id": "token_id",
    "post_url": "https://pts-api.paynet.com.tr/v1/subscriptioncreatecardjgate/tds?session_id=js_EAAAAOBVGxisSlamqJ9MJ4az0sIKo612LkVsws4crXSURqgX&token_id=FF349CFA-6667-4555-8BD6-02BF5E181D80",
    "html_content": "<form name=\"paynetForm\" id=\"paynetForm\" method=\"post\" action=\"https://pts-api.paynet.com.tr/v1/subscriptioncreatecardjgate/tds?session_id=js_EAAAAOBVGxisSlamqJ9MJ4az0sIKo612LkVsws4crXSURqgX&token_id=FF349CFA-6667-4555-8BD6-02BF5E181D80\"><input type=\"hidden\" name=\"session_id\" value=\"js_EAAAAOBVGxisSlamqJ9MJ4az0sIKo612LkVsws4crXSURqgX\"/><input type=\"hidden\" name=\"token_id\" value=\"FF349CFA-6667-4555-8BD6-02BF5E181D80\"/></form><script type=\"text/javascript\">document.forms[0].submit();</script>",
    "object_name": "create_card_tds_initial_response",
    "code": 0,
    "message": "Başarılı İşlem"
}
```

{% endtab %}

{% tab title="Service Url" %}

| Sistem           | URL                                                                           |
| ---------------- | ----------------------------------------------------------------------------- |
| **Canlı Sistem** | <https://api.paynet.com.tr/v1/subscription/create\\_card\\_tds\\_initial>     |
| **Test Sistemi** | <https://pts-api.paynet.com.tr/v1/subscription/create\\_card\\_tds\\_initial> |

{% endtab %}
{% endtabs %}

{% hint style="info" %}
**\*subscription\_id, reference\_no ve group\_reference\_no parametrelerinden en az biri gönderilmek zorundadır.**
{% endhint %}


---

# 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/servisler/abonelik/kart-ekleme/kart-ekleme-baslatma.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.