# POST Metodu

Paylink oluşturmak için aşağıdaki parametreleri kullanabilir; müşterilerinize **send\_email** ve **send\_sms** parametreleri ile ister email ister sms gönderebilirsiniz. İsterseniz dönen "**url**" bilgisini istediğiniz kanaldan müşterilerinize ulaştırabilirsiniz.

{% hint style="warning" %}
&#x20;Paylink oluşturmak için secret\_key ile basic authentication yapmalısınız. [Bakınız](/authentication.md#secret-key)
{% endhint %}

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

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

| Parametre İsmi               | Tip     | Zorunlu | Açıklama                                                                                                                                                                                                                                                                                                       |
| ---------------------------- | ------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **pos\_type**                | int     | Hayır   | Paynet’in pos’ları mı yoksa Firma’nın kendi pos’ları mı kullanılacak onu belirler. Default olarak Paynet pos’ları çalışır.                                                                                                                                                                                     |
| **addcomission\_to\_amount** | bool    | Hayır   | hizmet bedelinin kredi kartından çekilecek tutara eklenip eklenmeyeceğini belirler. Default false.                                                                                                                                                                                                             |
| **agent\_id**                | string  | Hayır   | Ödeme, firmanın bir bayisinin carisine aktarılacak ise bu alanda bayinin bayi kodu gönderilir. Bayi tanımının Paynet sisteminde tanımlı olması gerekir.                                                                                                                                                        |
| **name\_surname**            | string  | Evet    | Ödeme alınacak kişinin adı, soyadı.                                                                                                                                                                                                                                                                            |
| **user\_name**               | string  | Hayır   | Ödeme emri oluşturan kullanıcı bilgisi. Zorunlu değildir.                                                                                                                                                                                                                                                      |
| **amount**                   | decimal | Evet    | Ödeme tutarı                                                                                                                                                                                                                                                                                                   |
| **email**                    | string  | Hayır   | Ödeme emrinin gönderileceği email adresi, send\_mail parametresi true ise zorunlu.                                                                                                                                                                                                                             |
| **send\_mail**               | bool    | Hayır   | Ödeme emrinin mail ile gönderilip gönderilmeyeceğini belirler. True ise email parametresi zorunlu. Default false.                                                                                                                                                                                              |
| **phone**                    | string  | Hayır   | Ödeme emrinin SMS ile bilgilendirilmesi için SMS’in gönderileceği telefon numarası.                                                                                                                                                                                                                            |
| **send\_sms**                | bool    | Hayır   | Ödeme emrinin SMS ile gönderilip gönderilmeyeceğini belirler. True ise phone parametresi zorunlu. Default false.                                                                                                                                                                                               |
| **expire\_date**             | string  | Hayır   | Ödeme URL’inin geçerlilik süresini belirlemek için kullanılır. Saat olarak gönderilir. 72 saat geçerlilik süresi için 72 olarak gönderilir.                                                                                                                                                                    |
| **note**                     | string  | Hayır   | Ödeme sayfasında ödeme yapacak kişiye gösterilecek açıklama.                                                                                                                                                                                                                                                   |
| **agent\_note**              | string  | Hayır   | Ödeme işlemi yapıldığında raporlarda görünecek açıklama bilgisi.                                                                                                                                                                                                                                               |
| **reference\_no**            | string  | Hayır   | Ödeme işleminin ilişkilendirileceği referans numarası. (Fatura no, sipariş no vb.)                                                                                                                                                                                                                             |
| **instalment\_key**          | string  | Hayır   | İlgili oranın ID'si. Ödeme emri yollayan kişinin işlemi hangi banka ve taksit ile gerçekleşmesini isterse bu ID ile gönderilir.                                                                                                                                                                                |
| **succeed\_url**             | string  | Hayır   | İşlem başarılı ise bu parametrede gönderilen url’in sonuna işlem numarası(xact\_id) parametresini ekleyerek yönlendirme yapılır. Boş olarak gönderilirse Paynet’in default ödeme sonuç sayfası gösterilir.                                                                                                     |
| **error\_url**               | string  | Hayır   | İşlem başarısız ise bu parametrede gönderilen url’in sonuna işlem numarası(xact\_id) parametresini ekleyerek yönlendirme yapılır. Boş olarak gönderilirse Paynet’in default ödeme başarısız sayfası gösterilir.                                                                                                |
| **confirmation\_url**        | string  | Hayır   | Eğer işlem başarılı ise burada belirtilen url’e, [**confirmation\_url adresine post edilen parametreler**](https://doc.paynet.com.tr/oedeme-metotlari/ortak-oedeme-sayfasi/oedeme-emri-olusturma/confirmation-url-adresine-post-edilen-parametreler)’de belirtiğimiz parametreler json formatında post edilir. |
| **send\_confirmation\_mail** | bool    | Hayır   | Default true, Ana firmanın Paynet’te tanımlı mail adresine ödeme başarılı ise mail gönderir.                                                                                                                                                                                                                   |
| **multi\_payment**           | bool    | Hayır   | Default true. Ödemeyi birden fazla kart ile yapmasına olanak tanıyor.                                                                                                                                                                                                                                          |
| **ratio\_code**              | string  | Hayır   | Paynet.com.tr yönetim ekranlarında “API oran tanımları” sayfasından tanımlayabileceğiniz oran tablolarının “oran kodunu” bu alanda gönderebilirsiniz. Gönderdiğiniz oran koduna ait oran tablosu üzerinden komisyon hesaplaması yapılır. Bu sayede API üzerinden istediğiniz oranlar ile işlem yapabilirsiniz. |
| **invoice\_no**              | string  | Hayır   | Düzenli ödeme fatura numarası.                                                                                                                                                                                                                                                                                 |
| **card\_type**               | string  | Hayır   | <p>Müşterinizin sadece belirli bir kart tipinde işlem yapmasını sağlayabilirsiniz.</p><p>cc: Kredi kartı </p><p>dc: Debit kart</p><p>bc: business kart</p>                                                                                                                                                     |
| **bank\_id**                 | string  | Hayır   | Müşterinizin sadece belirli bir banka kartı ile işlem yapmasını sağlayabilirsiniz.                                                                                                                                                                                                                             |
| **installments**             | string  | Hayır   | Müşterinizin  virgül ile ayırarak sadece belirli taksitlerde işlem yapmasını sağlayabilirsiniz.                                                                                                                                                                                                                |
| **no\_instalment**           | bool    | Hayır   | Sadece tek çekim işlemlere izin vermek için kullanabilirsiniz.                                                                                                                                                                                                                                                 |
| **is\_active**               | bool    | Hayır   | Ödeme linki aktiflik durumu                                                                                                                                                                                                                                                                                    |
| **agent\_customer\_name**    | string  | Hayır   | Buraya yazacağınız değer slipte "Müşteri Adı" alanında görünecektir. Müşterinize göstermek istediğiniz firma adınızı yazabilirsiniz                                                                                                                                                                            |
| **tds\_option**              | int     | Hayır   | Ödeme işleminin 3D'li mi 3D'siz mi yapılacağını belirler. Default değeri 1'dir. (0: 3D'siz, 1: 3D'li, 2: Müşteri Seçsin)                                                                                                                                                                                       |
| {% endtab %}                 |         |         |                                                                                                                                                                                                                                                                                                                |

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

| Parametre İsmi   | Tip    | Açıklama                                                                                                                     |
| ---------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------- |
| **id**           | string | Ödeme linki işleminin id'si                                                                                                  |
| **url**          | string | Ödeme işleminin yapılacağı url linki. Bu link ile son kullancı kredi kart bilgilerini girerek ödeme işlemini gerçekleştirir. |
| **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" %}

```
{  
   "amount":120,
   "expire_date":12,
   "name_surname":"O*** Ö******",
   "email":"mail@paynet.com.tr",
   "phone":"53****0000",
   "send_mail":true,
   "send_sms":true
}
```

{% endtab %}

{% tab title="Response" %}

```
{
    "url": "https://pts-paynet.com.tr/S/M?id=35292939-bb17-4f8d-909e-78f767dc2742",
    "id": "f5e0a85b-2cf0-4596-b0c5-c027de671e49",
    "object_name": "mailorder",
    "code": 0,
    "message": "Başarılı İşlem"
}
```

{% endtab %}

{% tab title="Service Url" %}

| Sistem           | URL                                                 |
| ---------------- | --------------------------------------------------- |
| **Canlı Sistem** | <https://api.paynet.com.tr/v1/mailorder/create>     |
| **Test Sistemi** | <https://pts-api.paynet.com.tr/v1/mailorder/create> |
| {% 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/oedeme-metotlari/ortak-odeme-sayfasi/odeme-emri-olusturma/post-metodu.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.
