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