mail adresinden Paynet API key talebinde bulunabilirsiniz.
{% hint style="warning" %}
Paynet servislerine erişim sağlayabilmeniz için **sabit IP** adresine ihtiyacınız vardır.
{% endhint %}
## Publishable key
Hazır Form ve Özelleştirilebilir Form ödeme methodlarını kullanmak için bu key'e ihtiyacınız vardır. Paynet JavaScript kütüphanelerini sayfanıza gömerken bu key kullanılır.
```javascript
```
Eklenen bu script ile sayfanızda **data-button\_label**’da belirtilen metin ile “*Ödeme yap*” butonu çıkar. Müşterileriniz bu butona basarak kredi kartı bilgilerini girip ödeme işlemini yapabilirler.
Ödeme işlemi tamamlandığında Paynet.js “**token\_id**” ve “**session\_id**” parametrelerini formunuza hidden olarak ekler ve formunuzdaki diğer input'lar ile beraber **action** adresine formu post eder.
Post işleminden sonra formunuza eklediğiniz diğer parametreler ile beraber **session\_id** ve **token\_id** bilgisi sunucunuza ulaşır. Bu değerler ile ödemeyi onaylayabilirsiniz.
#### Paynet.js Parametreleri
| Data attribute | Zorunlu | Açıklama |
| -------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **data-key** | Evet | Publishable key'iniz. |
| **data-amount** | Evet | Kredi kartından çekilecek tutar. Ödeme tutarının yüz ile çarpılmış hali. “10.00 TL” => “1000” olarak gönderilmeli. |
| **data-name** | Hayır | Ödeme sırasında görünecek başlık. |
| **data-description** | Hayır | Ödeme sırasında görünecek işlem açıklaması. Paynet API İşlem listesinde ve Paynet işlem listesinde burada gönderdiğiniz açıklama gösterilir. |
| **data-image** | Hayır | Hazır ödeme formunda gösterilecek logo. |
| **data-agent** | Hayır | Eğer alt bayileriniz var ise işlemin hangi bayi üzerinden geldiğini bu alana bayi kodu göndererek yapabilirsiniz. |
| **data-add\_commission\_amount** | Hayır | Komisyon tutarının ödeme tutarına eklenip eklenmeyeceği belirlenir. True olduğunda komisyon tutarı kredi kartından çekilecek tutara eklenir. |
| **data-no\_instalment** | Hayır | true/false, default: false. True olduğunda Taksitli çekime izin vermez, tek çekim yapılır. |
| **data-ratio\_code** | 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. |
| **data-reference\_no** | Hayır | Ödeme işleminin ilişkili olduğu referans numarası. Tekil (unique) bir veri olmalı. ( örn: sipariş numarası ) |
| **data-show\_tds\_error** | Hayır | Bankanın 3D sayfasında hata alması durumunda bunu direkt müşterinize göstermek isterseniz "true", onaylama adımında göstermek isterseniz "false". |
| **data-invoice\_no** | Hayır | Düzenli ödeme fatura numarası. |
| **data-subscription\_id** | Hayır | Düzenli ödeme kodu, mevcut bir düzenli ödemenize manuel ödeme almak istediğinizde invoice\_no ile beraber kullanılır. |
| **data-save\_card** | Hayır | Ödeme işlemi ile birlikte kredi kart numarasının da saklanması istiyorsanız bu parametreyi true yollayabilirsiniz. Kart saklama işlemi yapıyorsanız card\_desc zorunlu, card\_owner\_id ya da user\_unique\_id değerlerinden en az birini göndermeniz zorunlu. |
| **data-card\_owner\_id** | Hayır | İlk defa kart saklama yapıldıktan sonra, Paynet tarafından user\_unique\_id’ye göre oluşturulan kart sahibinin benzersiz bilgisi. Bir sonraki kart saklama ve karttan ödeme alma işlemlerinde bu değer kullanılır. |
| **data-user\_unique\_id** | Hayır | Üye iş yeri tarafından verilen kullanıcıya özgü benzersiz id. İlk defa kart saklama yapılıyorsa zorunlu. İlk kart saklama tamamlandıktan sonra Paynet tarafından bu kullanıcıya benzersiz bir değer atanır( card\_owner\_id). Bu değeri kendi sisteminizde kullanıcınız ile ilişkilendirerek saklamalısınız. Daha sonra bu kullanıcıya yapılan kart saklama işlemlerinde user\_unique\_id yerine Paynet tarafından verilen card\_owner\_id değişkenini kullanmalısınız. |
| **data-installments** | Hayır | Eğer müşterinize sadece belirli taksitler ile alış veriş yapmasına izin vermek istiyorsanız, virgül ile ayırarak izinli taksit bilgisini gönderebilirsiniz. 0,3,4,6 gibi |
| **data-tds\_required** | Hayır | true/false, Default: true
False : Eğer işlem yapılacak POS 3D’siz işlemi destekliyor ise, kullanıcının 3D’siz de işlem yapmasına izin verir. True: Eğer işlem yapılacak POS 3D’siz işlemi destekliyor ise, kullanıcının 3D’siz de işlem yapmasını engeller.
|
| **data-merge\_option** | Hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| **data-pos\_type** | Hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| **data-ratio\_code\_method** | Hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| **data-payment\_source** | Hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
{% hint style="warning" %}
**data-amount** parametresi ile karttan çekilecek tutarı 100 ile çarpılmış ve ondalık ayracı olmadan göndermelisiniz.
{% endhint %}
## 2. Adım: **Ödemeyi onaylama**
Paynet.js tarafından form action sayfanıza post edilen **token\_id** ve **session\_id** değerlerini kullanarak ödemeyi onaylamanız gerekmektedir. Ödeme onaylama servisi ile daha detaylı bilgi için [tıklayınız](/uornek/servisler/islem/odeme-onaylama).
{% hint style="danger" %}
Ödeme onaylama servisini başarılı şekilde çalıştırmazsanız kredi kartından tahsilat işlemi yapılmaz.
{% endhint %}
{% content-ref url="/pages/-LTf\_vSFIgOps3izl4uP" %}
[Ödeme Onaylama](/uornek/servisler/islem/odeme-onaylama)
{% endcontent-ref %}
## Paynet.js method ve eventler
Paynet.js javascript kütüphanesi içerisinde aşağıdaki evet ve methodları uygulamanızı özelleştirmek için kullanabilirsiniz.
### Paynet.onPaymentClick
Sayfanıza eklenen ödeme butonuna tıklama sonrasında uygulamanızın ihtiyaçlarına yönelik kredi kartı formu açılmadan önce kontrol etmenize olanak sağlayan event. Aşağıdaki şekilde kullanabilirsiniz.
```javascript
Paynet.onPaymentClick(function () {
if (koşul) {
/// do something
return true;
} else{
alert("Uyarı");
return false;
} });
```
{% hint style="info" %}
Geri dönüş değeri "**true**" dönmeniz durumunda ödeme formu açılır ve akış devam eder. "**false**" dönmeniz durumunda ödeme formu açılmaz ve akış sonlanır.
{% endhint %}
### **Paynet.updateAmount**
Bu method ile "**data-amount**" ile belirtiğiniz kredi kartından çekilecek tutarı ve "**data-ratio\_code**" ile belirtiğiniz oran tablosunu güncelleyebilirsiniz. Aşağıdaki şekilde kullanabilirsiniz.
```javascript
Paynet.updateAmount(amount);
Paynet.updateAmount(amount,ratioCode);
```
### Paynet.updateAddCommToAmount
Bu parametre ile "data-add\_commission\_amount" ile belirtiğiniz komisyonun kredi kartından çekilecek tutara eklenip/eklenmeyeceğini güncelleyebilirsini.
```javascript
Paynet.updateAddCommToAmount(true);
Paynet.updateAddCommToAmount(false);
```
# Özelleştirilebilir Form
Paynet ile ödeme almanın diğer bir kolay yolu **Paynet-custom.js**’i ödeme formunuza gömmektir. **Paynet-custom.js** ödeme ekranını kendi tasarımınıza uygun şekilde dizayn etmenize olanak verir. Sizin için kart bilgilerinin güvenliğini sağlar, tüm doğrulamaları yapar. Hassas kart bilgileri hiçbir şekilde güvensiz ortamlarda dolaşmaz.
#### Paynet-custom.js ile ödeme almak üç aşamadan oluşur;
* [x] Paynet-custom.js’i mevcut tasarımı size ait olan HTML formunuza yerleştirirsiniz.
* [x] HTML Form elementlere data-paynet attribute'u ile hangi alan olduğunu işaretlersiniz. Örneğin Kredi kartı numarasını alacağınız html input'a data-paynet="number" attribute'unu eklemeniz gerekiyor.
* [x] Kullanıcı kart bilgilerini girip ödeme butonuna basınca **Paynet-custom.js** kart bilgilerini alarak sizin formunuza “token\_id” ve “session\_id” bilgilerini ekler ve formunuzu post eder. Sizde sunucunuzda gönderilen “token\_id” ve “session\_id” bilgilerini alarak “Ödeme Onaylama” servisi ile kredi kartından çekim işlemini tamamlayabilirsiniz.
{% hint style="info" %}
Özelleştirilebilir Form methodu ile script'i sayfanıza eklemek için Publishable key, ödeme işlemini sunucu tarafında onaylamak için de secret key'e ihtiyacınız vardır. [bnkz](/uornek/authentication#secret-key).
{% endhint %}
## **1.Adım: Paynet-custom.js’i formunuza ekleme**
Paynet-custom.js’i aşağıdaki şekilde sayfanıza ekleyebilirsiniz. Eklenen bu script ile sayfanızı isteğiniz doğrultuda dizayn edebilirsiniz.
```markup
```
#### Paynet-custom.js Parametreleri
| Data attribute | Zorunlu | Açıklama |
| -------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **data-form** | Evet | Kart bilgilerinin alıncağı formun id'si. css selector "#formid" şeklinde verilmeli |
| **data-key** | Evet | Publishable key'iniz. |
| **data-amount** | Evet | Kredi kartından çekilecek tutar. Ödeme tutarının yüz ile çarpılmış hali. “10.00 TL” => “1000” olarak gönderilmeli. |
| **data-name** | Hayır | Ödeme sırasında görünecek başlık. |
| **data-description** | Hayır | Ödeme sırasında görünecek işlem açıklaması. Paynet API İşlem listesinde ve Paynet işlem listesinde burada gönderdiğiniz açıklama gösterilir. |
| **data-agent** | Hayır | Eğer alt bayileriniz var ise işlemin hangi bayi üzerinden geldiğini bu alana bayi kodu göndererek yapabilirsiniz. |
| **data-reference\_no** | Hayır | Ödeme işleminin ilişkili olduğu referans numarası. Tekil (unique) bir veri olmalı. ( örn: sipariş numarası ) |
| **data-add\_commission\_amount** | Hayır | Komisyon tutarının ödeme tutarına eklenip eklenmeyeceği belirlenir. True olduğunda komisyon tutarı kredi kartından çekilecek tutara eklenir. |
| **data-no\_instalment** | Hayır | true/false, default: false. True olduğunda Taksitli çekime izin vermez, tek çekim yapılır. |
| **data-ratio\_code** | 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. |
| **data-show\_tds\_error** | Hayır | Bankanın 3D sayfasında hata alması durumunda bunu direkt müşterinize göstermek isterseniz "true", onaylama adımında göstermek isterseniz "false". |
| **data-invoice\_no** | Hayır | Düzenli ödeme fatura numarası. |
| **data-subscription\_id** | Hayır | Düzenli ödeme kodu, mevcut bir düzenli ödemenize manuel ödeme almak istediğinizde invoice\_no ile beraber kullanılır. |
| **data-save\_card** | hayır | Ödeme işlemi ile birlikte kredi kart numarasının da saklanması istiyorsanız bu parametreyi true yollayabilirsiniz. Kart saklama işlemi yapıyorsanız card\_desc zorunlu, card\_owner\_id ya da user\_unique\_id değerlerinden en az birini göndermeniz zorunlu. |
| **data-save\_cardoid** | Hayır | İlk defa kart saklama yapıldıktan sonra, Paynet tarafından user\_unique\_id’ye göre oluşturulan kart sahibinin benzersiz bilgisi. Bir sonraki kart saklama ve karttan ödeme alma işlemlerinde bu değer kullanılır. |
| **data-save\_carduid** | Hayır | Üye iş yeri tarafından verilen kullanıcıya özgü benzersiz id. İlk defa kart saklama yapılıyorsa zorunlu. İlk kart saklama tamamlandıktan sonra Paynet tarafından bu kullanıcıya benzersiz bir değer atanır( card\_owner\_id). Bu değeri kendi sisteminizde kullanıcınız ile ilişkilendirerek saklamalısınız. Daha sonra bu kullanıcıya yapılan kart saklama işlemlerinde user\_unique\_id yerine Paynet tarafından verilen card\_owner\_id değişkenini kullanmalısınız. |
| data-save\_card\_desc | Hayır | Kartı saklarken açıklama. |
| data-use\_saved\_card | Hayır | Saklı kartlar ile işlem yapabilme. |
| **data-tds\_required** | Hayır | True/false, Default: true
False : Eğer işlem yapılacak POS 3D’siz işlemi destekliyor ise, kullanıcının 3D’siz de işlem yapmasına izin verir.
True: Eğer işlem yapılacak POS 3D’siz işlemi destekliyor ise, kullanıcının 3D’siz de işlem yapmasını engeller.
|
| **data-merge\_option** | Hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| **data-pos\_type** | Hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| **data-ratio\_code\_method** | Hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| **data-return\_url** | Hayır | Form action parametresi yerine başka bir url'de ödeme onaylama işlemi yapacaksanız bu alanda ilgili url bilgisini gönderebilirsiniz. |
## **2.Adım: HTML input elementlerinizi işaretleyin.**
Ödeme bilgilerinin alınacağı sayfa, tercihleriniz doğrultusunda diyazn edilir. Form'un ID'si script attribute'unda data-form="\[your form id]" şeklinde verilmelidir. Formunuzdaki input elementleri de data-paynet attribute'u ile belirtilmelidir. Formunuza yerleştirdiğiniz buton ile ödeme işlemi gerçekleştiğinde Paynet-custom.js, “token\_id” ve “session\_id” parametrelerini formunuza hidden olarak ekler ve formu post eder. Form post işlemi ile sizin formunuza eklediğiniz parametreler ile beraber session\_id ve token\_id bilgisi web server’ınıza gelir.
#### Script Parametreleri
| Parametre İsmi | Zorunlu | Açıklama |
| ------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **number** | Evet | Kredi kartı numarası bilgisi |
| **installmentKey** | Evet | Seçilen taksitin ID’si |
| **holderName** | Evet | Kart sahibinin adı |
| **data-agent** | Evet | Ödemeyi alanın ya da yapanın firmadaki cari hesap kodu. Bu alanda firma bayisi cari hesap kodu ya da bayinin Paynet altındaki kodu gönderilebilir. Firma kendi bayi kodunu kullanacak ise Paynet sisteminde ilgili tanımın yapılması gerekiyor. |
| **exp-month** | Evet | Kredi kartı son kullanma tarihinin ay bilgisi |
| **exp-year** | Evet | Kredi kartı son kullanma tarihinin yıl bilgisi |
| **cvv** | Evet | Kredi kartı CVC bilgisi |
| **desc** | Hayır | Ödeme ile ilgili açıklama bilgisi |
| **email** | Hayır | Ödeme yapan kişinin e-posta bilgisi |
| **phone** | Hayır | Ödeme yapan kişinin telefon bilgisi |
| **do3D** | Hayır | Ödemenin 3D’li olup olmadığı bilgisi |
## 3.Adım : Ödemeyi onaylama
Server’ınıza ulaşan session\_id ve token\_id parametreleri ile kart bilgisi sizin sisteminizden geçmeden ödeme işlemini onaylayabilirsiniz.[Bknz.](/uornek/servisler/islem/odeme-onaylama)
{% content-ref url="/pages/-LTf\_vSFIgOps3izl4uP" %}
[Ödeme Onaylama](/uornek/servisler/islem/odeme-onaylama)
{% endcontent-ref %}
## Event parametre ve Servisler
Paynet-custom.js javascript kütüphanesindeki aşağıdaki eventleri ve servisleri daha esnek bir uygulama oluşturmak için kullanabilirsiniz.
1. [Event Parametreleri](/uornek/oedeme-methodlari/oezellestirilmis-form/event-parametreleri)
2. [Servis Parametreleri](/uornek/oedeme-methodlari/oezellestirilmis-form/servis-parametreleri)
# Event Parametreleri
| Event Parametreleri | Açıklama |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Paynet.events.onCheckBin** | Kredi kartı numarası girildiğinde callback almamızı sağlayan eventtir.[Detay için tıklayınız](/uornek/oedeme-methodlari/oezellestirilmis-form/event-parametreleri#paynet-events-oncheckbin). |
| **Paynet.events.validationError** | Sayfada validation hatası olduğunda validationları yakalamamıza yardımcı olan eventtir.[Detay için tıklayınız.](/uornek/oedeme-methodlari/oezellestirilmis-form/event-parametreleri#paynet-events-validationerror) |
| **Paynet.events.onPaymentClick** | Öde butonuna tıklandığında çalışan eventtir.[Detay için tıklayınız.](/uornek/oedeme-methodlari/oezellestirilmis-form/event-parametreleri#paynet-events-onpaymentclick) |
| **Paynet.events.onAuthentication** | Yetkilendirme aşamasında callback alabilmenizi sağlayan eventtir.[Detay için tıklayınız.](/uornek/oedeme-methodlari/oezellestirilmis-form/event-parametreleri#paynet-events-onauthentication) |
| **Paynet.events.onTdsRedirect** | 3D'li işlemlerde yönlendirme işleminde çalışan eventtir. [Detay için tıklayınız .](/uornek/oedeme-methodlari/oezellestirilmis-form/event-parametreleri#paynet-events-ontdsredirect) |
| **Paynet.events.onCreateToken** | Token oluşturma safhasında callback alabilmemizi sağlayan eventttir. [Detay için tıklayınız.](/uornek/oedeme-methodlari/oezellestirilmis-form/event-parametreleri#paynet-events-oncreatetoken) |
| **Paynet.events.onLoad** | Custom form sayfası yüklendiğinde çalışan eventtir. [Detay için tıklayınız.](/uornek/oedeme-methodlari/oezellestirilmis-form/event-parametreleri#paynet-events-onload) |
### Paynet.events.onCheckBin
Kredi kartı numarası giriş esnasında checkbin servisinden callback alabileceğimiz eventtir. Örnek olarak kart nuamrası inputu herhangi bir bin numarası ile eşleşmediği takdirde hata mesajı yazdırabilmemiz için kullanabiliriz.Aşağıdaki şekilde kullanabilirsiniz:
```
Paynet.events.onCheckBin(function (d) {
if (d && d.ok) {
bankID = d.bank.id;
clearError();
if (d.bank.id != $('#bank_id').val())
{
showError("", "Uyumsuz kart numarası");
}
else
{
if (d.tdsState == 'required') {
$('#tds').attr('checked', 'checked');
$('#tds').attr('disabled', 'disabled');
$('#isTds').hide();
} else if (d.tdsState == 'optional') {
$('#tds').attr('checked', 'checked');
$('#tds').removeAttr('disabled', 'disabled');
$('#isTds').show();
}<
}
} else
{
clearError();
$('#isTds').hide();
}
});
```
#### Response Parametreleri
| Parametre İsmi | Tip | Açıklama |
| ---------------------- | ------------ | --------------------------------------- |
| **bank\_id** | char(4) | Bankanın Paynet sistemindeki kodu |
| **bank\_logo** | string(60) | Banka logo |
| **bank\_name** | string(100) | Banka adı |
| **tds\_enable** | bool | 3D'li işleme izni |
| **instalment\_key** | datetime | İşlemin tarihi |
| **instalment** | int | Taksit sayısı |
| **instalment\_amount** | decimal | Kredi kartından çekilecek taksit tutarı |
| **desc** | string(50) | Taksit açıklaması |
| **bank\_id** | char(4) | Bankanın Paynet sistemindeki kodu |
| **bank\_logo** | string(60) | Banka logo |
| **bank\_name** | string( 100) | Banka adı |
| **ratio** | float | Ödeme sırasında kullanılan oran |
| **total\_amount** | decimal | Kredi kartından çekilen toplam tutar |
| **total\_net\_amount** | decimal | Komisyon hariç tutar |
| **comission** | decimal | Komisyon tutarı |
| **comission\_tax** | decimal | Komisyon vergisi |
### Paynet.events.validationError
Form’da giriş değerlerinde yanlışlık olduğunda callback alabileceğimiz event’tir.
### Paynet.events.onPaymentClick
Öde butonuna tıklandığında tetiklenen eventtir. Örneğin ; öde butonuna tıklandığında form submit edilmeden sayfadaki hata mesajlarının silinmesini çağıran methodun kullanılması. Aşağıdaki şekilde kullanabilirsiniz :
```
Paynet.events.onPaymentClick(function ()
{ clearError();
});
```
### Paynet.events.onAuthentication
Paynet api servislerine authenticate methodunun callback’ini alabileceğimiz eventtir. Örneğin api servislerine yollanan private key’in eşleşmemesi durumunda auth servisinden gelen hata mesajının ekranda gösterilmesi. Aşağıdaki şekilde kullanabilirsiniz:
```
Paynet.events.onAuthentication(function (c) {
if (!c.ok) {
showError(c.code, c.message);
}
});
```
#### Response Parametreleri
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------------------------------------------------------------------------------ |
| **type** | int | Dönüş tipi |
| **message** | string | Hata mesajı |
| **code** | string | Bknz. [HTTP Status Kodlar](/uornek/genel-bilgiler/hata-kodlari/http-status-kodlar#http-status-kodlari) |
| **result\_code** | int | Bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
### Paynet.events.onTdsRedirect
3D’li işlemlerde banka sistemine yönlendirilirken callback alabileceğimiz eventtir. Örneğin ; 3D’li bir işlemde banka sistemine yönlendirilmesinin console ekranına “3D doğrulama için yönlendiriliyorsunuz” şeklinde log atılması. Aşağıdaki şekilde kullanabilirsiniz:
```
Paynet.events.onTdsRedirect(function () {
console.log('3D doğrulama için yönlendiriliyorsunuz');
});
```
### Paynet.events.onCreateToken
CreateToken servisinin callback’ini alabileceğimiz eventtir. Örneğin; girilen kart bilgisi ve seçilen ödeme koşulu api’ye gönderilirilen verilerin sonucunun başarısız olması durumunda form ekranında hata mesajı gösterilmesi. Aşağıdaki şekilde kullanabilirsiniz:
```
Paynet.events.onCreateToken(function (c) {
if (!c.ok) {
showError(c.code, c.message);
} });
```
#### Response Parametreleri
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ----------------------------------------------------------------------------------------------------- |
| **token\_id** | string | Sistem tarafından işlem için verilen id numarası |
| **post\_url** | string | 3D'li işlemlerde post edilecek url adresi |
| **is\_tds** | bool | İşlemin 3D'li olup olmadığını belirtir |
| **type** | int | Dönüş tipi |
| **message** | string | Hata mesajı |
| **code** | string | Bknz.[HTTP Status Kodlar](/uornek/genel-bilgiler/hata-kodlari/http-status-kodlar#http-status-kodlari) |
| **result\_code** | int | Bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
### Paynet.events.onLoad
Paynet-custom.js kütüphanesi sayfaya yüklendiği an callback’ini alabileceğimiz eventtir.Aşağıdaki şekilde kullanabilirsiniz:
```
Paynet.events.onLoad(function () {
console.log('paynet library loaded');
});
```
# Servis Parametreleri
| Servis Adı | Açıklama |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Paynet.services.checkBin** | Kredi kartı numarasını bin numarasına göre hangi bankaya ait olduğunu bulmak için kullanabileceğiniz servistir. [Detay için tıklayınız.](/uornek/oedeme-methodlari/oezellestirilmis-form/servis-parametreleri#paynet-services-checkbin) |
| **Paynet.services.installments** | Oran tablosunu client tarafta oluşturmanızı sağlayan servis. [Detay için tıklayınız.](/uornek/oedeme-methodlari/oezellestirilmis-form/servis-parametreleri#paynet-services-installments) |
| **Paynet.services.updateAmount** | Kredi kartından çekilecek tutar bilgisini güncelleme yapabileceğiniz servis. [Detay için tıklayınız.](/uornek/oedeme-methodlari/oezellestirilmis-form/servis-parametreleri#paynet-services-updateamount) |
| **Paynet.services.updateRatioCode** | Kredi kartından çekilecek tutar bilgisini ve oran kodunu güncelleme yapabileceğiniz servis. [Detay için tıklayınız.](/uornek/oedeme-methodlari/oezellestirilmis-form/servis-parametreleri#paynet-services-updateratiocode) |
### Paynet.services.checkBin
Paynet-custom.js içerisinde checkBin servisi mevcuttur. checkBin servisi ile kart numarası inputlarını custom kullananlar için bu servisi kullanabilirler. Örneğin; kart girişi için 4'erli numara girişi olan 4 input var ama arkada tek inputda tutuluyor. Bundan dolayı müşteri kendisi bir event kullanırsa yazacağı koda göre checkBin servisini çağırıp onCheckBin event'ından callback alabilir.
{% hint style="info" %}
Örnek olarak Paynet.services.checkBin('4444440000000001'); şeklinde servisi kullanabiliriz.
{% endhint %}
#### Response Parametreleri
| Parametre İsmi | Tip | Açıklama |
| ---------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------- |
| **bank\_id** | char(4) | Bankanın Paynet sistemindeki kodu |
| **bank\_logo** | string(60) | Banka logo |
| **bank\_name** | string(100) | Banka adı |
| **tds\_enable** | bool | 3D'li işleme izni |
| **instalment\_key** | datetime | İşlemin tarihi |
| **instalment** | int | Taksit sayısı. [Bknz.](/uornek/genel-bilgiler/taksit-kodlari)[Taksit Kodları](/uornek/genel-bilgiler/taksit-kodlari) |
| **instalment\_amount** | decimal | Kredi kartından çekilecek taksit tutarı |
| **desc** | string(50) | Taksit açıklaması |
| **bank\_id** | char(4) | Bankanın Paynet sistemindeki kodu |
| **bank\_logo** | string(60) | Banka logo |
| **bank\_name** | string(100) | Banka adı |
| **ratio** | float | Ödeme sırasında kullanılan oran |
| **total\_amount** | decimal | Kredi kartından çekilen toplam tutar |
| **total\_net\_amount** | decimal | Komisyon hariç tutar |
| **comission** | decimal | Komisyon tutarı |
| **comission\_tax** | decimal | Komisyon vergisi |
### Paynet.services.installments
Bu servis ile oran tablosunu client tarafta oluşturmanızı sağlayan servistir. Servisi javascript kütüphaneleri ile çağırabilir, gelen response'u da kendi dizaynınıza uygun şekilde oluşturabilirsiniz. Aşağıdaki gibi kullanabilirsiniz :
```
Paynet.services.installments(function (d) {/>
// oranları set edeceğiniz block
});
```
#### Response Parametreleri
| Parametre İsmi | Tip | Açıklama |
| ---------------------- | ----------- | ----------------------------------------------------------------------------------------------------- |
| **instalment\_key** | string | İlgili oranın ID'si. Custom Form Entegrasyonunda hangi taksit işlemi geçtiği bu ID gönderilerek olur. |
| **instalment** | int | Taksit sayısı.[Bknz](/uornek/genel-bilgiler/taksit-kodlari). |
| **instalment\_amount** | decimal | Kredi kartından çekilecek taksit tutarı |
| **desc** | string(50) | Taksit açıklaması |
| **bank\_id** | char(4) | Bankanın Paynet sistemindeki kodu |
| **bank\_logo** | string(60) | Banka logo |
| **bank\_name** | string(100) | Banka adı |
| **ratio** | float | Ödeme sırasında kullanılan oran |
| **total\_amount** | decimal | Kredi kartından çekilen toplam tutar |
| **total\_net\_amount** | decimal | Komisyon hariç tutar |
| **comission** | decimal | Komisyon tutarı |
| **comission\_tax** | decimal | Komisyon vergisi |
### Paynet.services.updateAmount
Bu servis ile tutar bilgisini create token oluşturulduktan sonra oluşturduğunuz custom ödeme sayfasında da güncelleme imkanını veren servistir. Aşağıdaki gibi kullanabilirsiniz :
```
Paynet.services.updateAmount($("#amount").val(),
function (d) {
if (d && d.ok) { alert("Tutar Güncellendi.") }
})
```
### Paynet.services.updateRatioCode
Bu servis ile tutar bilgisini create token oluşturulduktan sonra oluşturduğunuz custom ödeme sayfasında da güncelleme ile tanımlı oranınızı oran koduna göre getirme imkanını veren servistir. Aşağıdaki şekilde kullanabilirsiniz :
```
Paynet.services.updateRatioCode($("#amount").val(),$("#ratioCode").val(),
function (d) {
if (d && d.ok) { alert("Tutar Güncellendi.") }
})
```
#### Response Parametreleri
| Parametre İsmi | Tip | Açıklama |
| ----------------- | -------- | ----------------------------------------------------------------------------------------------------- |
| **session\_id** | string | Paynet-custom.js’in formunuza attach ettiği parametre |
| **name** | string | İşlemi başlatan bayinin adı |
| **tds\_required** | bool | 3D'li işlem durum bilgisi |
| **expire\_date** | datetime | Session'ın bitiş zamanı |
| **type** | int | Dönüş tipi |
| **message** | string | Hata mesajı |
| **code** | string | Bknz.[HTTP Status Kodlar](/uornek/genel-bilgiler/hata-kodlari/http-status-kodlar#http-status-kodlari) |
| **result\_code** | int | Bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
# Ortak Ödeme Sayfası
Müşterinizden ödeme almak istediğinizde kullanabilecek servislerdir. Ortak ödeme sayfası olarak ya da email veya sms ile link gönderilerek, link üzerinden ödeme alınması şeklinde kullanabilirsiniz. Ödeme sonrasında **succeed\_url,error\_url** ve ya **confirmation\_url**'i parametrelerini kullanarak sistemi entegre edebilirsiniz.
# Ödeme Emri Oluşturma
v1/mailorder/create
Ödeme almak istediğiniz müşterilerinize ödeme emri oluşturmanızı sağlayan servistir. Bu servisi hem GET metodu ile URL üzerinden hem de POST metodunu kullanarak istek parametrenizi JSON veya XML formatında göndererek işlem yapabilirsiniz. Ödeme emri ile emrinizi ister mail ile ister SMS ile ve isterse üretilen URL üzerinden anlık olarak ödeme emri yaratabilirsiniz. Bu servis ile üretilen url, gönderilen mail ya da SMS sizin belirleyeceğiniz “expire\_date” süresine kadar geçerli olur.
{% hint style="success" %}
{% endhint %}
# POST Methodu
Post metodu üzerinden ödeme emri göndermenin authentication mekanizması basic authentication üzerinden size vermiş olduğumuz secret key ile sağlanmaktadır.
{% 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 belirle. Default olarak Paynet pos’ları çalışır. |
| **addcomission\_to\_amount** | bool | Hayır | Komisyon tutarının 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\_email** | bool | Hayır | Ödeme emrinin mail ile gönderilip gönderilmeyeceğini belirler. True ile email parametresi zorunlu. Default false |
| **phone** | double | Hayır | Ödeme emrinin SMS ile bilgilendirilmesi için SMS’in gönderileceği telefon numarası |
| **send\_sms** | string | 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 gibi. |
| **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 gönderilerek olur. |
| **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 aşağıda confirmation\_url adresine post edilen parametreler’de belirtiğimiz parametreler json formatında post edilir. |
| **send\_confirmation\_email** | 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. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------- |
| **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":"Onur Özdemir",
"email":"onur.ozdemir@arena.com.tr",
"phone":"5358407813",
"send_mail":true,
"send_sms":true
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"url":" https://pts.paynet.com.tr/S/M?id=22c1ec4b-3c97-41bf-8e07-d352d403b1c0 ",
"object_name":"mailorder",
"code":0,
"message":"Başarılı Islem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | --------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# GET Methodu
Get methodu üzerinden ödeme emri oluşturmak için authentication, size vermiş olduğumuz public key üzerinden sağlanmaktadır. POST methodunda kullanılan tüm parametreler bu servisde de kullanılabilmektedir.
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ----------------------------- | ------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **public\_key** | string | Evet | Sisteme authentication olmayı sağlar. |
| **pos\_type** | int | Hayır | Paynet’in pos’ları mı yoksa Firma’nın kendi pos’ları mı kullanılacak onu belirle. Default olarak Paynet pos’ları çalışır. |
| **addcomission\_to\_amount** | bool | Hayır | Komisyon tutarının kredi kartından çekilecek tutara eklenip eklenmeyeceğini belirler. Default true. |
| **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ı |
| **expire\_date** | double | 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 gibi. |
| **succeed\_url** | string | Hayır | İşlem başarılı ise bu parametrede gönderilen url’e 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’e 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 aşağıda confirmation\_url adresine post edilen parametreler’de belirtiğimiz parametreler json formatında post edilir. |
| **send\_confirmation\_email** | 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. |
| {% endtab %} | | | |
{% tab title="Request" %}
```
{
public_key=pbk_pcs_Z3ABiIZq0kjTgfP37MGVQof32muAg
name_surname=onurozdemir
amount=15
email=ornek_mail@arena.com.tr
expire_date=48
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | --------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# Emir Listesi
v1/mailorder/list
Paynet ’ten ödeme emri(ortak ödeme) üzerinden yapılan işlemlerin listesini almak için kullanılır.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ------------------- | ---------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **agent\_id** | string(10) | Hayır | Paynet bayi kodu |
| **datab** | Date | Evet | Başlangıç Tarihi |
| **datbi** | Date | Evet | Bitiş Tarihi |
| **limit** | int | Hayır | Döndürülecek veri sayısı. Default 10 kayıt döner. |
| **ending\_before** | int | Hayır | Belirtilen index’den önceki limit sayısı kadar kayıt getirir. Eğer ending\_before 90 gönderildi, limit olarak 15 gönderildi. 75. İle 90. Kayıtları arasındaki kayıtları gönderir. |
| **starting\_after** | int | Hayır | Belirtilen index’den sonraki limit sayısı kadar kayıt getirir. Eğer starting after 15 gönderildi, limit olarak 15 gönderildi. 15. İle 30. Kayıtları arasındaki kayıtları gönderir |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **company\_code** | string(10) | Ana firma kodu |
| **agent\_id** | string(10) | Bayi kodu |
| **expire\_date** | double | Ödeme URL’inin geçerlilik süresini belirlemek için kullanılır. |
| **total** | int | Toplam satır sayısı |
| **xact\_id** | string(100) | Paynet işlem numarası |
| **bank\_id** | char(4) | Banka kodu |
| **bank\_name** | string(100) | Banka adı |
| **reference\_no** | string(50) | Banka referans kodu |
| **installment** | int | Taksit sayısı |
| **amount** | decimal | Kredi kartından çekilen tutar |
| **currency** | char(3) | Para birimi |
| **phone** | string | Ödeme emrinin SMS ile bilgilendirilmesi için SMS’in gönderileceği telefon numarası |
| **send\_sms** | bool | Ödeme emrinin SMS ile gönderilip gönderilmeyeceğini belirler. True ise phone parametresi zorunlu. Default false. |
| **note** | string | Ödeme sayfasında ödeme yapacak kişiye gösterilen açıklama. |
| **agent\_note** | string | Ödeme işlemi yapıldığında raporlarda görünen açıklama bilgisi. |
| **succeed\_url** | string | İş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 | İş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 | Eğer işlem başarılı ise burada belirtilen url’e aşağıda confirmation\_url adresine post edilen parametreler’de belirtiğimiz parametreler json formatında post edilir. |
| **status** | char(1) | 1:ODEME\_BEKLENIYOR 2:ODEME\_ALINDI 3:SURE\_ASIMI |
| **send\_confirmation\_mail** | bool | Ana firmanın Paynet’te tanımlı mail adresine ödeme başarılı ise mail gönderir. |
| **send\_mail** | bool | Ödeme emrinin mail ile gönderilip gönderilmeyeceğini belirler. True ile email parametresi zorunlu. |
| **multi\_payment** | decimal | Ödemeyi birden fazla kart ile yapmasına olanak tanıyor. |
| **total\_count** | int | Toplam gösterilen satır sayısı |
| **total\_amount** | int | Toplam işlem tutar |
| **limit** | int | Gönderilen limit bilgisi |
| **ending\_before** | int | Gönderilen ending\_before bilgisi |
| **starting\_after** | int | Gönderilen starting\_after bilgisi |
| **object\_name** | string | transaction\_list |
| **has\_more** | bool | True ise Belirtilen kriterlerde gönderilen satırlardan daha olduğu anlamına gelir. |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"agent_id":"20008",
"datab":"2015-04-04",
"datbi":"2016-05-05",
"ending_before":0,
"starting_after":0
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"total":306,
"total_count":10,
"total_amount":2.441,00",
"limit":10,
"ending_before":0,
"starting_after":0,
"has_more":true,
"Data":[
{
"company_code":"10031",
"agent_id":"20008",
"xact_id":"işlem no",
"referenceNo":"",
"email":"hakan.kocaturk@arena.com.tr",
"user_name":"",
"amount":200.0000,
"currency":"TL",
"installment":3,
"phone":"",
"bank_id":"AXSS",
"expire_date":"2015-06-17T01:52:00",
"create_date":"2015-06-16T13:53:18.933",
"note":null,
"agent_note":"",
"succeed_url":"",
"error_url":null,
"confirmation_url":"",
"bank_name":"Axess",
"status":2,
"sendConfirmation_mail":false,
"send_sms":false,
"send_mail":false,
"multi_payment":false
},
...
],
"object_name":"mailorderlist",
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr/](https://api.paynet.com.tr/v1/mailorder/create)[v1/mailorder/list](https://api.paynet.com.tr/v1/mailorder/list) |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# Confirmation Url Adresine Post Edilen Parametreler
Ödeme emri son kullanıcı tarafından başarılı şekilde yapıldığında ödeme bilgisi v1/mailorder/create servisinde belirtilen confirmation\_url parametresinde belirtilen adrese JSON formatında post edilir. Eğer bu parametre boş değere sahip ise post işlemi gerçekleşmez.
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ----------------------- | -------- | --------------------------------------------------------------------------------- |
| **referance\_no** | string | Ödeme işleminin ilişkilendirildiği referans numarası (Fatura no, sipariş no gibi) |
| **xact\_date** | DateTime | Ödeme işleminin yapıldığı zaman |
| **agent\_id** | string | Eğer ödeme bayinin carisine aktarılacak ise o bayinin kodunu belirtir |
| **bank\_id** | string | Ödemenin yapıldığı banka numarası |
| **instalment** | int | Ödemenin yapıldığı taksit sayısı |
| **card\_type** | string | Ödemenin yapıldığı kart tipi |
| **card\_holder** | string | Ödemenin yapıldığı kart sahibi ad ve soyad bilgisi |
| **card\_number** | string | Ödemenin yapıldığı kart numarasının ilk 6 ve son 4 numarası |
| **amount** | decimal | Yapılan ödemenin brüt tutarı |
| **netAmount** | decimal | Yapılan ödemenin net tutarı |
| **comission** | decimal | Yapılan ödemenin komisyon tutarı |
| **comission\_tax** | decimal | Yapılan ödeme tutarından kesilen komisyonun vergisi |
| **currency** | string | Ödemenin yapıldığı kur |
| **authorization\_code** | string | Bankadan dönen onay kodu |
| **order\_id** | string | Bankadan dönen satış kodu |
| **is\_succeed** | bool | Ödemenin başarılı bir şekilde alınıp alınmadığını belirtir. |
| {% endtab %} | | |
{% tab title="Second Tab" %}
{% endtab %}
{% endtabs %}
# API Entegrasyonu
Uygulamanızda kendi ödeme formunuzu kullanıp, API servislerimize entegre ederek 3D'siz ve ya 3D'li ödeme alabilirsiniz. Bu iki servisten birini kullanarak;
* [x] Tek çekim ya da taksitli işlem yapabilirsiniz.
* [x] İşlem sırasında kartı saklayabilirsiniz.
* [x] Saklı kart ile işlem yapabilirsiniz.
* [x] Mevcut bir düzenli ödeme kaydınız var ise ona istinaden ödeme yapabilirsiniz.
{% hint style="info" %}
Bu servislerimizi kullanmadan önce Paynet API **secret key**'ine ihtiyacınız vardır. [bknz.](/uornek/authentication)
{% endhint %}
## Ödeme
Ödeme servisimizi kullanarak tek çekim, taksitli ve saklı kart ile ödeme işlemlerini gerçekleştirebilirsiniz. Kredi kartından direkt ödeme tutarı çekilir, 3D doğrulama yapılmaz.
{% content-ref url="/pages/-LTN7w6EaUcvWHuzIwFD" %}
[Ödeme](/uornek/oedeme-methodlari/api-entegrasyonu/odeme)
{% endcontent-ref %}
## 3D ile Ödeme
Bu servisi kullanarak tek çekim, taksitli ve saklı kart ile 3D doğrulamalı ödeme işlemi gerçekleştirebilirsiniz.
{% content-ref url="/pages/-LTN83ApJVlVZSwKQAXB" %}
[3D ile ödeme](/uornek/oedeme-methodlari/api-entegrasyonu/3d-ile-odeme)
{% endcontent-ref %}
# Ödeme
3D doğrulama olmadan ödeme servisimizi kullanarak tek çekim, taksitli ve saklı kart ile ödeme işlemlerini gerçekleştirebilirsiniz. Kredi kartından direkt ödeme tutarı çekilir, 3D doğrulama yapılmaz.
{% hint style="warning" %}
Ödeme servisini kullanabilmeniz için secret\_key ile basic authentication yapmalısınız. [bnkz](/uornek/authentication#secret-key).
{% endhint %}
{% hint style="warning" %}
Bu serviste 3D doğrulama yapılmadığı için bu servisi kullanma yetkiniz olmalı. Bu konu hakkında satış temsilciniz ile temasa geçebilirsiniz.
{% endhint %}
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| No | Parametre | Tip | Zorunlu | Açıklama |
| ------------ | ----------------------- | ----------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1 | **amount** | decimal | evet | Kredi kartından çekilecek tutar. |
| 2 | **reference\_no** | string(50) | evet | Ödeme işleminin ilişkili olduğu referans numarası. Tekil (unique) bir veri olmalı. ( örn: sipariş numarası ) |
| 3 | **domain** | string(256) | evet | İşlemin yapıldığı uygulamanın domain bilgisi. ( örn: [www.acme.com](http://www.acme.com) ) |
| 4 | **card\_holder** | string(50) | opsiyonel | Kart sahibi bilgisi.
Saklı kart ile işlem yapılmıyorsa zorunlu.
|
| 5 | **pan** | string | opsiyonel | Kart numarası.
Saklı kart ile işlem yapılmıyorsa zorunlu.
|
| 6 | **month** | int | opsiyonel | Son kullanma tarihi Ay bilgisi. ( örn: 8,12 )
Saklı kart ile işlem yapılmıyorsa zorunlu.
|
| 7 | **year** | int | opsiyonel | Son kullanma tarihi Yıl bilgisi. ( örn: 2020, 2030 ) Saklı kart ile işlem yapılmıyorsa zorunlu. |
| 8 | **cvc** | string | opsiyonel | Kart güvenlik kodu.
Saklı kart ile işlem yapılmıyorsa zorunlu.
|
| 9 | **card\_hash** | string | opsiyonel | Saklı kartın token bilgisi. Kart bilgileri girilmemiş ise bu bilgi zorunlu. |
| 10 | **card\_holder\_phone** | string(10) | hayır | Kart sahibinin telefon numarası. |
| 11 | **card\_holder\_mail** | string(60) | hayır | Kart sahibi email adresi. |
| 12 | **description** | string(140) | hayır | İşlem ile ilgili açıklama alanı. |
| 13 | **instalment** | int | hayır | İşlemin kaç taksit yapılacağı bilgisi. Değer gönderilmezse tek çekim uygulanır. |
| 14 | **agent\_id** | string(10) | hayır | Eğer alt bayileriniz var ise işlemin hangi bayi üzerinden geldiğini bu alana bayi kodu göndererek yapabilirsiniz. |
| 15 | **company\_amount** | decimal | hayır | Eğer alt bayileriniz var ise işlemin ne kadarının sizin hesabınıza aktarılacağını belirleyebilirsiniz. |
| 16 | **add\_commission** | bool | hayır | İşlem komisyonunun karttan çekilecek tutar'a eklenmesini istiyorsanız "true" gönderebilirsiniz. |
| 17 | **transaction\_type** | char(1) | hayır | Satış ya da ön provizyon. 1 satış, 3 ön provizyon. Varsayılan satış işlemidir. |
| 18 | **ratio\_code** | string(8) | 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. |
| 19 | **save\_card** | bool | hayır | Ödeme işlemi ile birlikte kredi kart numarasının da saklanması istiyorsanız bu parametreyi true yollayabilirsiniz. Kart saklama işlemi yapıyorsanız card\_desc zorunlu, card\_owner\_id ya da user\_unique\_id değerlerinden en az birini göndermeniz zorunlu. |
| 20 | **card\_desc** | string(100) | opsiyonel | Kart saklama işlemi yapılıyor ise bu alan zorunludur. |
| 21 | **user\_unique\_id** | string | opsiyonel | Üye iş yeri tarafından verilen kullanıcıya özgü benzersiz id. İlk defa kart saklama yapılıyorsa zorunlu. İlk kart saklama tamamlandıktan sonra Paynet tarafından bu kullanıcıya benzersiz bir değer atanır( card\_owner\_id). Bu değeri kendi sisteminizde kullanıcınız ile ilişkilendirerek saklamalısınız. Daha sonra bu kullanıcıya yapılan kart saklama işlemlerinde user\_unique\_id yerine Paynet tarafından verilen card\_owner\_id değişkenini kullanmalısınız. |
| 22 | **card\_owner\_id** | string | opsiyonel | İlk defa kart saklama yapıldıktan sonra, Paynet tarafından user\_unique\_id’ye göre oluşturulan kart sahibinin benzersiz bilgisi. Bir sonraki kart saklama ve karttan ödeme alma işlemlerinde bu değer kullanılır. |
| 23 | **user\_gsm\_no** | string | hayır | Kart saklama işleminde ek olarak OTP kontrolü yapmak isterseniz bu parametre kullanılır. Daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| 24 | **subscription\_id** | string | hayır | Düzenli ödeme kodu, mevcut bir düzenli ödemenize manuel ödeme almak istediğinizde invoice\_no ile beraber kullanılır. |
| 25 | **invoice\_no** | string | hayır | Düzenli ödeme fatura numarası. |
| 26 | **ratio\_code\_method** | char(1) | hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| 27 | **merge\_option** | bool | hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| 28 | **pos\_type** | int | hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| 29 | **approved\_card** | bool | hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| {% endtab %} | | | | |
{% tab title="Dönüş Parametreleri" %}
| No | Parametre | Tip | Açıklama |
| ------------ | ------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------ |
| 1 | **id** | int | tekil paynet işlem id |
| 2 | **xact\_id** | string | paynet işlem id'nin hash değeri |
| 3 | **xact\_date** | DateTime | işlemin tarihi |
| 4 | **transaction\_type** | char(1) | işlem tipi 1: satış, 2: ön provizyon |
| 5 | **pos\_type** | int | pos tipi |
| 6 | **agent\_id** | string | bayi kodu |
| 7 | **user\_id** | string | kullanıcı kodu |
| 8 | **email** | string | mail adresi |
| 9 | **phone** | string | telefon bilgisi |
| 10 | **bank\_id** | string | Banka kodu |
| 11 | **bank\_name** | string | Banka adı |
| 12 | **instalment** | int | taksit bilgisi |
| 13 | **ratio** | float | işlem komisyon oranı |
| 14 | **card\_no\_masked** | string | maskeli kart bilgisi |
| 15 | **card\_holder** | string | kart sahibi |
| 16 | **amount** | decimal | brüt işlem tutarı |
| 17 | **net\_amount** | decimal | komisyon hariç tutar |
| 18 | **comission** | decimal | komisyon tutarı |
| 19 | **currency** | string | para birimi |
| 20 | **bank\_authorization\_code** | string | banka onay kodu |
| 21 | **bank\_reference\_code** | string | banka referans kodu |
| 22 | **bank\_order\_id** | string | banka sipariş numarası |
| 23 | **is\_succeed** | bool | işlemin başarılı ya başarısız olduğu bilgisi. true ise ilgili karttan tutar tahsil edilmiş demektir. |
| 24 | **code** | string | http status kodu |
| 25 | **message** | string | işlem sonuç mesajı |
| 26 | **paynet\_error\_id** | string | paynet hata kodu |
| 27 | **paynet\_error\_message** | string | paynet hata açıklaması |
| 28 | **bank\_error\_id** | string | bankadan bildirilen hata kodu |
| 29 | **bank\_error\_message** | string | bankadan bildirilen hata mesajı |
| 30 | **bank\_error\_short\_desc** | string | bankadan bildirilen hata mesajı |
| 31 | **bank\_error\_long\_desc** | string | bankadan bildirilen hata mesajı |
| 32 | **reference\_no** | string | request sırasında gönderilen referans kodu |
| 33 | **xact\_transaction\_id** | string | O işlemin guid işlem kodu, bu işlemin iptal, iade işlemlerinde bu alan aynı guid değerini alır. |
| 34 | **campaign\_url** | string | Bazı kart progamlarında + taksit ve taksit erteleme seçimi işlem sonrası başka bir uygulamada seçilebiliyor. |
| 35 | **end\_user\_comission** | decimal | ratio\_code kullanımında komisyon değeri |
| 36 | **end\_user\_ratio** | float | ratio\_code kullanımında komisyon oranı |
| 37 | **ratio\_code** | string | oran kodu |
| 38 | **ratio\_code\_method** | string | oran kodu methodu |
| 39 | **is\_save\_card\_succeed** | bool | kart saklama işlemi yapılıyorsa kart saklama sonucu |
| 40 | **save\_card\_result\_message** | string | kart saklama mesajı |
| 41 | **card\_owner\_id** | string | kart saklamada bir sonraki sefer kullanılacak id |
| 42 | **user\_unique\_id** | string | müşterinizin benzersiz numarası |
| 43 | **card\_hash** | string | token edilmiş kart bilgisi |
| 44 | **card\_bank\_id** | string | saklı kart bankası |
| 45 | **card\_logo\_url** | string | saklı kart logosu |
| {% endtab %} | | | |
{% tab title="Request" %}
```javascript
Request
{
"amount": 12.5,
"reference_no": "REF1000",
"agent_id": "",
"pos_type": "5",
"transaction_type": "1",
"company_amount": null,
"add_commission": "False",
"ratio_code": "",
"instalment": "0",
"merge_option": "False",
"ratio_code_method": "",
"domain": "",
"approved_card": "False",
"card_holder": "******",
"card_hash": "",
"pan": "******",
"month": "8",
"year": "2026",
"cvc": "000",
"card_holder_phone": "",
"card_holder_mail": "",
"description": "test",
"save_card": "False",
"card_owner_id": "",
"user_unique_id": "",
"user_gsm_no": "",
"card_desc": "",
"subscription_id": "",
"invoice_no": ""
}
```
{% endtab %}
{% tab title="Response " %}
```javascript
{
"id": 2049043,
"xact_id": "xk_EAAAAEBAN9wUFv0GvZ37KeP0ggCz*SafLumQCPN2Z1EDrsMf",
"xact_date": "2018-12-14T13:33:53.1227309+03:00",
"transaction_type": 1,
"pos_type": 6,
"agent_id": "20077",
"user_id": "PaynetApi",
"email": null,
"phone": null,
"instalment": 0,
"ratio": 0.02,
"card_no_masked": "450803******4509",
"card_holder": "TEST TEST",
"amount": 12.5,
"net_amount": 12.25,
"comission": 0.25,
"comission_tax": 0,
"currency": "TRY",
"bank_id": "ZDGR",
"bank_name": "Maximum",
"bank_authorization_code": "aut-7044",
"bank_reference_code": "ref-7044",
"bank_order_id": "order-7044",
"is_succeed": true,
"paynet_error_id": "",
"paynet_error_message": "",
"bank_error_id": "",
"bank_error_message": "",
"bank_error_short_desc": "",
"bank_error_long_desc": "",
"reference_no": "deneme11",
"xact_transaction_id": "2049043",
"campaign_url": "",
"end_user_comission": 0,
"end_user_ratio": 0,
"ratio_code": "",
"ratio_code_method": "",
"is_save_card_succeed": false,
"save_card_result_message": "",
"card_owner_id": "",
"user_unique_id": "",
"card_hash": "",
"card_bank_id": "",
"card_logo_url": "",
"object_name": "payment_response",
"code": 0,
"message": "Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------------------------------ |
| **Canlı sistem** | |
| **Test sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="success" %}
İşlem sonucunun başarılı olup olmadığını **is\_succeed** parametresini kontrol ederek anlayabilirsiniz. **is\_succeed** parametresi true ise işlem başarılı demektir. Hata kodları için [daha detaylı bilgi için](/uornek/genel-bilgiler/hata-kodlari).
{% endhint %}
{% hint style="info" %}
connection timeout ya da execution time out gibi sebeplerden dolayı cevap alamıyorsanız, aynı **reference\_no** ile cevap alana kadar işleme devam edebilirsiniz. Sistem aynı reference\_no ile daha önceden başarılı bir işlem var ise o işlemi döndürür. Bu durumda sonuç kodu 0 yerine 100 döner, sonuç mesajı da “Önceki Başarılı İşlem” olarak döner.
{% endhint %}
###
{% hint style="info" %}
Kart saklama süreci ile ilgili dahat detaylı bilgi için [bknz](/uornek/genel-bilgiler/sikca-sorulan-sorular/kart-saklama-suereci-hakkinda).
{% endhint %}
# 3D ile ödeme
3D’li ödeme iki adımdan oluşur. Bunlar **3D ödeme başlatma** ve **3D ödemesi** yapmaktır. 3D Ödeme başlatma servisi ile bankaların 3D doğrulama sayfalarına erişim yapılacak url ve ya html içeriğe erişebileceksiniz. 3D ödemesi ile de 3D doğrulama sonucuna göre ödeme işlemini sonlandırırsınız.
* [x] **3D ödeme başlatma** servisine ödeme servisine ek olarak 3D doğrulama sonucunun döneceği **retur\_url** parametresi ile request gönderilir.
* [x] Uygulamanızı **3D ödeme başlatma** servisinden dönen **"post\_url**" parametresine redirect edersiniz.
* [x] Bankaların 3D doğrulama ekranı açılır.
* [x] 3D doğrulama sonucu başlatma servisine gönderdiğiniz **return\_url** parametresinde belirtilen url'e post edilir.
* [x] **return\_url**'inize gelen parametreleri 3D ödemesi servisine post edersiniz ve sonucu kontrol edersiniz.
## 3D ödeme başlatma
Ödeme işleminden farklı olarak **return\_ur**l parametresi gönderilir. Servisden dönen post\_url ya da html\_content parametrelerini kullanarak bankaların 3D doğrulama sayfasını açabilirsiniz.
{% hint style="info" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| No | Parametre İsmi | Tip | Zorunlu | Açıklama |
| ------------ | ----------------------- | ----------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1 | **amount** | decimal | Evet | Kredi kartından çekilecek tutar. |
| 2 | **reference\_no** | string(50) | Evet | Ödeme işleminin ilişkili olduğu referans numarası. Tekil (unique) bir veri olmalı. ( örn: sipariş numarası ) |
| 3 | **return\_url** | string(256) | Evet | 3D doğrulama sonucunun post edileceği URL |
| 4 | **domain** | string(256) | Evet | İşlemin yapıldığı uygulamanın domain bilgisi. ( örn: [www.acme.com](http://www.acme.com) ) |
| 5 | **card\_holder** | string(50) | Hayır | Kart sahibi bilgisi.
Saklı kart ile işlem yapılmıyorsa zorunlu.
|
| 6 | **pan** | string | Hayır | Kart numarası.
Saklı kart ile işlem yapılmıyorsa zorunlu.
|
| 7 | **month** | int | Hayır | Son kullanma tarihi Ay bilgisi. ( örn: 8,12 )
Saklı kart ile işlem yapılmıyorsa zorunlu.
|
| 8 | **year** | int | Hayır | Son kullanma tarihi Yıl bilgisi. ( örn: 2020, 2030 ) Saklı kart ile işlem yapılmıyorsa zorunlu. |
| 9 | **cvc** | string | Hayır | Kart güvenlik kodu.
Saklı kart ile işlem yapılmıyorsa zorunlu.
|
| 10 | **card\_hash** | string | Hayır | Saklı kartın token bilgisi. Kart bilgileri girilmemiş ise bu bilgi zorunlu. |
| 11 | **card\_holder\_phone** | string(10) | Hayır | Kart sahibinin telefon numarası |
| 12 | **card\_holder\_mail** | string(60) | Hayır | Kart sahibi email adresi. |
| 13 | **description** | string(140) | Hayır | İşlem ile ilgili açıklama alanı. |
| 14 | **instalment** | int | Hayır | İşlemin kaç taksit yapılacağı bilgisi. Değer gönderilmezse tek çekim uygulanır. |
| 15 | **agent\_id** | string(10) | Hayır | Eğer alt bayileriniz var ise işlemin hangi bayi üzerinden geldiğini bu alana bayi kodu göndererek yapabilirsiniz. |
| 16 | **company\_amount** | decimal | Hayır | Eğer alt bayileriniz var ise işlemin ne kadarının sizin hesabınıza aktarılacağını belirleyebilirsiniz. |
| 17 | **add\_commission** | bool | Hayır | İşlem komisyonunun karttan çekilecek tutar'a eklenmesini istiyorsanız "true" gönderebilirsiniz. |
| 18 | **transaction\_type** | char(1) | Hayır | Satış ya da ön provizyon. 1 satış, 3 ön provizyon. Varsayılan satış işlemidir. |
| 19 | **ratio\_code** | string(8) | 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. |
| 20 | **save\_card** | bool | Hayır | Ödeme işlemi ile birlikte kredi kart numarasının da saklanması istiyorsanız bu parametreyi true yollayabilirsiniz. Kart saklama işlemi yapıyorsanız card\_desc zorunlu, card\_owner\_id ya da user\_unique\_id değerlerinden en az birini göndermeniz zorunlu. |
| 21 | **card\_desc** | string(100) | Hayır | Kart saklama işlemi yapılıyor ise bu alan zorunludur. |
| 22 | **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. İlk kart saklama tamamlandıktan sonra Paynet tarafından bu kullanıcıya benzersiz bir değer atanır( card\_owner\_id). Bu değeri kendi sisteminizde kullanıcınız ile ilişkilendirerek saklamalısınız. Daha sonra bu kullanıcıya yapılan kart saklama işlemlerinde user\_unique\_id yerine Paynet tarafından verilen card\_owner\_id değişkenini kullanmalısınız. |
| 23 | **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 bilgisi. Bir sonraki kart saklama ve karttan ödeme alma işlemlerinde bu değer kullanılır. |
| 24 | **user\_gsm\_no** | string | Hayır | Kart saklama işleminde ek olarak OTP kontrolü yapmak isterseniz bu parametre kullanılır. Daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| 25 | **subscription\_id** | string | Hayır | Düzenli ödeme kodu, mevcut bir düzenli ödemenize manuel ödeme almak istediğinizde invoice\_no ile beraber kullanılır. |
| 26 | **invoice\_no** | string | Hayır | Düzenli ödeme fatura numarası. |
| 27 | **ratio\_code\_method** | char(1) | Hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| 28 | **merge\_option** | bool | Hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| 29 | **pos\_type** | int | Hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz |
| 30 | **approved\_card** | bool | Hayır | Bu alanla ilgili daha detaylı bilgi için lütfen destek ekibimiz ile iletişime geçiniz. |
| {% endtab %} | | | | |
{% tab title="Dönüş Parametreleri" %}
| No | Parametre İsmi | Tip | Açıklama |
| ------------ | ----------------- | ------ | ---------------------------------------------------------------------------------------------------- |
| 1 | **post\_url** | string | Bu URL'e redirect ettiğinizde bankanın 3D doğrulama sayfasını gösterir. |
| 2 | **html\_content** | string | post\_url yerine bu HTML content'i sayfanıza eklediğinizde bankanın 3D doğrulama sayfasını gösterir. |
| 3 | **token\_id** | string | İşlemin token bilgisi |
| 4 | **session\_id** | string | 3D ödeme akışının session bilgisi |
| 5 | **object\_name** | string | tdsinitial\_response |
| 6 | **code** | string | Bknz.[HTTP Status Kodlar](/uornek/genel-bilgiler/hata-kodlari/http-status-kodlar) |
| 7 | **message** | string | işlem sonuç mesajı |
| {% endtab %} | | | |
{% tab title="Request" %}
```javascript
Request
{
"return_url": "https://pts-kurumsal.paynet.com.tr/Demo/TDSCharge",
"amount": "20",
"reference_no": "REF1001",
"agent_id": "",
"pos_type": "5",
"transaction_type": "1",
"company_amount": null,
"add_commission": "False",
"ratio_code": "",
"instalment": "0",
"merge_option": "False",
"ratio_code_method": "",
"domain": "",
"approved_card": "False",
"card_holder": "******",
"card_hash": "",
"pan": "******",
"month": "**",
"year": "**",
"cvc": "***",
"card_holder_phone": "",
"card_holder_mail": "",
"description": "test 2",
"save_card": "False",
"card_owner_id": "",
"user_unique_id": "",
"user_gsm_no": "",
"card_desc": "",
"subscription_id": "",
"invoice_no": ""
}
```
{% endtab %}
{% tab title="Response" %}
```javascript
Response
{
"token_id": "DF63C3CB-358A-4258-BDDA-522F4D8C5FA8",
"session_id": "js_EAAAAFAL6CJHCCqAoll6DRsSqLfUMmn0pcqT6LZiJk6ZX*3G",
"post_url": "https://pts-api.paynet.com.tr/v1/paynetjgate/tds_easy?session_id=js_EAAAAFAL6CJHCCqAoll6DRsSqLfUMmn0pcqT6LZiJk6ZX*3G&token_id=DF63C3CB-358A-4258-BDDA-522F4D8C5FA8",
"html_content": "",
"object_name": "tdsinitial_response",
"code": 0,
"message": "Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------------- |
| **Canlı sistem** | |
| **Test sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
## 3D Ödemesi Yapmak
3D doğrulama sonucunda kredi kartından ilgili tutarın çekim yapıldığı servis. "3D ödeme başlatma" servisinde kullandığınız return\_url'e post edilen **session\_id** ve **token\_id** değerlerini bu service post edip ödeme akışını tamamlayabilirsiniz.
{% hint style="success" %}
[https://api.paynet.com.tr/v2/transaction/t](https://api.paynet.com.tr/v2/transaction/tds_initial)ds\_charge
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| --------------------- | ------- | ------- | ------------------------------------------------------------------------------------------------------ |
| **session\_id** | string | Evet | 3D ödeme akışının session bilgisi |
| **token\_id** | string | Evet | İşlemin token bilgisi |
| **transaction\_type** | char(1) | Hayır | Satış ya da ön provizyon. 1 satış, 3 ön provizyon. Varsayılan satış işlemidir. |
| **company\_amount** | decimal | Hayır | Eğer alt bayileriniz var ise işlemin ne kadarının sizin hesabınıza aktarılacağını belirleyebilirsiniz. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------ |
| **id** | int | tekil paynet işlem id |
| **xact\_id** | string | paynet işlem id'nin hash değeri |
| **xact\_date** | Datetime | işlemin tarihi |
| **transaction\_type** | char(1) | işlem tipi 1: satış, 2: ön provizyon |
| **pos\_type** | int | pos tipi |
| **is\_tds** | string | True ise 3D'siz işlem yapılamaz. False ise 3D'li veya 3D'siz işlem yapılabilir. |
| **user\_id** | string | Kullanıcı kodu |
| **email** | string | Mail adresi |
| **phone** | string | Telefon bilgisi |
| **bank\_id** | string | Banka kodu |
| **bank\_name** | string | Banka adı |
| **instalment** | int | Taksit bilgisi |
| **ratio** | float | işlem komisyon oranı |
| **card\_no\_masked** | string | Maskeli kart bilgisi |
| **card\_holder** | string | Kart sahibi |
| **amount** | decimal | Brüt işlem tutarı |
| **net\_amount** | decimal | Komisyon hariç tutar |
| **comission** | decimal | Komisyon tutarı |
| **comission\_tax** | decimal | Komisyon hizmet tutarı |
| **currency** | string | Para birimi |
| **authorization\_code** | string | Banka onay kodu |
| **reference\_code** | string | Banka referans kodu |
| **order\_id** | string | Banka sipariş numarası |
| **is\_succeed** | bool | İşlemin başarılı ya başarısız olduğu bilgisi. true ise ilgili karttan tutar tahsil edilmiş demektir. |
| **paynet\_error\_id** | string | Paynet hata kodu |
| **paynet\_error\_message** | string | Paynet hata açıklaması |
| **bank\_error\_id** | string | Bankadan bildirilen hata kodu |
| **bank\_error\_message** | string | Bankadan bildirilen hata mesajı |
| **bank\_error\_short\_desc** | string | Bankadan bildirilen hata mesajı |
| **bank\_error\_long\_desc** | string | Bankadan bildirilen hata mesajı |
| **agent\_reference\_no** | string | Request sırasında gönderilen referans kodu |
| **campaign\_url** | string | Bazı kart progamlarında + taksit ve taksit erteleme seçimi işlem sonrası başka bir uygulamada seçilebiliyor. |
| **end\_user\_comission** | decimal | ratio\_code kullanımında komisyon değeri |
| **end\_user\_ratio** | float | ratio\_code kullanımında komisyon oranı |
| **ratio\_code** | string | oran kodu |
| **ratio\_code\_method** | string | oran kodu methodu |
| **is\_save\_card\_succeed** | bool | Kart saklama işlemi yapılıyorsa kart saklama sonucu |
| **save\_card\_result\_message** | string | Kart saklama mesajı |
| **card\_owner\_id** | string | Kart saklamada bir sonraki sefer kullanılacak id |
| **card\_logo\_url** | string | Saklı kart logosu |
| **md\_status** | string | Banka 3D sonuç kodu |
| **object\_name** | string | Nesne adı |
| **code** | string | http status kodu |
| **message** | string | İşlem sonuç mesajı |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"session_id":"{{session}}",
"token_id":"{{token}}"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"id":2049018,
"xact_id":"xk_EAAAAJ4Xc96iya0kRYaut2qsj*AFozqI3*nF0BwfoZWgswYK",
"xact_date":"2018-12-04T09:03:59.81",
"transaction_type":1,
"pos_type":6,
"is_tds":false,
t_id":"20077",
"user_id":"PaynetApi",
"email":"",
"phone":" ",
"bank_id":"ZDGR",
"bank_name":"Diğer Banka",
"instalment":0,
"ratio":0,
"card_no_masked":"450803******4509",
"card_holder":"TEST TEST",
"amount":12.5,
"net_amount":12.25,
"comission":0,
"comission_tax":0,
"currency":"TRY",
"authorization_code":"aut-1513",
"reference_code":"ref-1513",
"order_id":"order-1513",
"is_succeed":true,
"paynet_error_id":"",
"paynet_error_message":"",
"bank_error_id":"",
"bank_error_message":"",
"bank_error_short_desc":"",
"bank_error_long_desc":"",
"agent_reference_no":"deneme11",
"campaign_url":null,
"end_user_comission":0.25,
"end_user_ratio":0.02,
"ratio_code":"",
"ratio_code_method":" ",
"is_save_card_succeed":false,
"save_card_result_message":null,
"card_owner_id":null,
"user_unique_id":null,
"card_hash":null,
"card_bank_id":null,
"card_logo_url":null,
"md_status":-1,
"object_name":"transaction",
"code":100,
"message":"Önceki Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------------- |
| **Canlı sistem** | |
| **Test sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
**tds\_charge** işlemi sırasında eğer connection timeout ya da execution time out gibi sebeplerden dolayı cevap alamıyorsanız, aynı **session\_id** ve **token\_id** ile cevap alana kadar işleme devam edebilirsiniz. Sistem aynı **session\_id** ve **token\_id** ile daha önceden başarılı bir işlem var ise o işlemi döndürür. Bu durumda sonuç kodu 0 yerine 100 döner, sonuç mesajı da “Önceki Başarılı İşlem” şeklinde döner.
{% endhint %}
# İşlem
Kredi kartından işlem geçme, işlem listeleme, işlem detay gibi servisleri içerir. Servis detayları aşağıda açıklanmıştır.
# Ödeme Onaylama
v1/transaction/charge
Paynet.js ve ya Paynet-custom.js ile başlatılan hazır form ya da özelleştirilebilir form entegrasyonlarında kredi kartı ödeme işlemini sonlandırmaya, kredi kartından ilgili tutarın çekiminin yapıldığı servistir. Bu servisi kullanmak için Paynet.js’in sunucunuza post ettiği **session\_id** ve **token\_id** bilgilerine ihtiyaç vardır.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| --------------------- | ----------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **session\_id** | string(100) | Evet | Paynet.js’in formunuza attach ettiği parametre |
| **token\_id** | string(100) | Evet | Paynet.js’in formunuza attach ettiği parametre |
| **reference\_no** | string( 50) | Hayır | İşlem ile ilişkilendireceğiniz sizin göndereceğiniz bir referans numarası. Sipariş numarası, fatura numarası gibi. Referans numarasını unique bir değer gönderirseniz charge transaction servisinden cevap alamadığınız durumlarda işlemin durumunu check transansaction servisi üzerinden kontrol edebilirsiniz. Bu şekilde mükerrer çekim işlemlerinden korunmuş oluruz. |
| **transaction\_type** | char(1) | Evet | Satış ya da ön provizyon. 1 satış, 3 ön provizyon. Varsayılan satış işlemidir. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **xact\_id** | string(100) | İşlemin id'si |
| **xact\_date** | datetime | İşlemin tarihi |
| **transaction\_type** | char(1) | 1: satış |
| **pos\_type** | char(1) | 5: Paynet POS |
| **is\_tds** | bool | İşlem 3D’li ise true |
| **agent\_id** | string(10) | İşlemi yapan bayinin Paynet cari hesap kodu |
| **user\_id** | string(10) | PaynetJ olarak default döner |
| **email** | string(60) | Mail adresi |
| **phone** | string(10) | Telefon bilgisi |
| **bank\_id** | char(4) | Bankanın Paynet sistemindeki kodu |
| **instalment** | int | Taksit sayısı |
| **ratio** | float | Ödeme sırasında kullanılan oran |
| **card\_no\_masked** | string(25) | Maskeli kart numarası |
| **card\_holder** | string(50) | Kart sahibi |
| **amount** | decimal | Kredi kartından çekilen tutar |
| **net\_amount** | decimal | Komisyon hariç tutar |
| **comission** | decimal | Komisyon tutarı |
| **comission\_tax** | decimal | Komisyon vergisi |
| **currency** | char(3) | Para birimi |
| **authorization\_code** | string(10) | Banka onay kodu |
| **reference\_code** | string(50) | Banka referans kodu |
| **order\_id** | string(50) | Banka sipariş no |
| **is\_succeed** | bool | İşlem başarılı ise true. Eğer işlem başarılı ise http 200 ve is\_succeed true döner. Banka onay vermemiş ise http 200 ve is\_succedd false döner. |
| **paynet\_error\_id** | string | Paynet sistemi hata kodu |
| **paynet\_error\_message** | string | Paynet sistemi hata mesajı |
| **bank\_error\_id** | string(50) | Banka sisteminin hata kodu |
| **bank\_error\_message** | string(50) | Banka sisteminin hata mesajı |
| **bank\_error\_short\_desc** | string(250) | Banka sisteminin hata mesajı |
| **bank\_error\_long\_desc** | string | Banka sisteminin hata mesajı |
| **agent\_reference\_no** | string(50) | Ödeme işleminde kullandığınız referans numaranız. reference\_no ile aynı |
| **object\_name** | string | transaction |
| **code** | string | Sistem sonuç kodu bknz. Bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Sistem mesajı |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"session_id":"js_EAAAAD3fKWDiouwO+dcEqN2gusaKLSmLIOJV37ZIJOnKyg6+",
"token_id":"jt_EAAAAKfn6aGfKgvaK1yVPAbFKF4F4RhV7iR1lJBAxVeltC\/+UefYTyMeO2bgVOnMsjU06j\/ZNv42tDQZnyB2aOwEZME-",
"reference_no":"1234",
"transaction_type":1
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"xact_id":"xk_EAAAAE3ovgioQa0Xc++vq16TJYL6Qerwf6hgceGxLAtX7QG9",
"xact_date":"0001-01-01T00:00:00",
"transaction_type":1,
"pos_type":5,
"is_tds":true,
"agent_id":"20081",
"user_id":"paynetj",
"email":null,
"phone":null,
"bank_id":"BONS",
"instalment":3,
"ratio":0.021,
"card_no_masked":"444444******0004",
"card_holder":"gokhan",
"amount":5000,
"net_amount":4764,
"comission":200,
"comission_tax":36,
"currency":"TRY",
"authorization_code":"aut-3060",
"reference_code":"ref-3060",
"order_id":"order-3060",
"is_succeed":true,
"paynet_error_id":"",
"paynet_error_message":"",
"bank_error_id":"",
"bank_error_message":"",
"bank_error_short_desc":"",
"bank_error_long_desc":"",
"agent_reference_no":null,
"object_name":"transaction",
"code":0,
"message":"Ba\u015far\u0131l\u0131 \u0130\u015flem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------------------------------ |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
Aşağıdaki örnekte post edilen **session\_id** ve **token\_id** değerleri alınarak ödeme onaylama servisine gönderilir.
```php
$session_id,
'token_id' => $token_id,
'transaction_type' => 1,
);
$options = array(
'http' => array(
'header' =>"Accept: application/json; charset=UTF-8\r\n".
"Content-type: application/json; charset=UTF-8\r\n".
"Authorization: Basic ".$secret_key,
'method' => 'POST',
'content' => json_encode($params),
'ignore_errors' => true
),
);
$context = stream_context_create($options);
$result = json_decode(@file_get_contents($PostURL, false, $context));
if($result->is_succeed == true)
{
echo "Başarılı";
}
else
{
echo "Başarısız";
}
?>
```
# Ödeme Raporu
v1/payment\_list
Bu servis ile vade tarihi bazında alınacak ödemelerin listesini listeleyebilirsiniz.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------- | ---- | ------- | ------------------------------------------------------------------------------------ |
| **date** | date | Hayır | Belirli tarih bazında listeleme yapmak için. Varsayılan değer istek atılan tarihtir. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **agent\_service\_amount** | decimal | Bayi hizmet tutarı |
| **agent\_pay\_amount** | decimal | Bayiye ödenecek net tutar |
| **company\_pay\_amount** | decimal | Ana firma ödenecek net tutar |
| **company\_service\_amount** | decimal | Ana firma komisyon tutarı |
| **due\_date** | Datetime | Ödeme tarihi |
| **company\_code** | string | İşlemi yapan bayinin Paynet ana firma hesap kodu |
| **company\_name** | string | İşlemi yapan bayinin ana firma adı |
| **agent\_id** | string | İşlemi yapan bayinin Paynet cari hesap kodu |
| **agent\_name** | string | İşlemi yapan bayinin adı |
| **xact\_id** | string | İşlem’in id’si |
| **xact\_date** | Datetime | İşlemin tarihi |
| **bank\_id** | string | Bankanın Paynet sistemindeki kodu. Bknz.[Banka Kodları](/uornek/genel-bilgiler/banka-kodlari) |
| **bank\_name** | string | Banka adı |
| **card\_no** | string | Maskeli kart numarası |
| **card\_holder** | string | Ödemenin yapıldığı kart sahibi ad ve soyad bilgisi |
| **card\_type** | char(2) | Ödemenin yapıldığı kart tipi.Bknz.[Kart Tipi](/uornek/genel-bilgiler/veri-tipleri/kart-tipi) |
| **authorization\_code** | string | Banka onay kodu |
| **reference\_code** | string | Banka referans kodu |
| **order\_id** | string | Banka sipariş numarası |
| **xact\_type** | char(2) | İşlem tipi . Bknz.[İşlem Tipi](/uornek/genel-bilgiler/veri-tipleri/islem-tipi) |
| **is\_succeed** | bool | İşlem başarılı ise true. Eğer işlem başarılı ise http 200 ve is\_succeed true döner. Banka onay vermemiş ise http 200 ve is\_succedd false döner. |
| **pos\_type** | int | 5: Paynet POS |
| **instalment** | int | Taksit sayısı. Bknz.[Taksit Kodları](/uornek/genel-bilgiler/taksit-kodlari) |
| **ratio** | float | Ödeme sırasında kullanılan oran |
| **user\_id** | string | İşlemi yapan kullanıcı |
| **amount** | decimal | Kredi kartından çekilen tutar |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"date":"2018-12-24"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"total":1,
"total_count":1,
"object_name":"transaction_payment_list",
"Data":[
{
"company_code":"1124",
"company_name":"FIRATPEN",
"agent_id":"1124",
"agent_name":"FIRATPEN",
"xact_id":"2507677",
"xact_date":"19.12.2018",
"bank_id":"AXSS",
"bank_name":"Axess",
"card_no":"435508******4358",
"card_holder":"ONUR ÖZDEMİR",
"card_type":"cc",
"authorization_code":"408338",
"reference_code":"835309695576",
"order_id":"DA96BF9E9FD846B3949E69EFBB4BEBA0",
"xact_type":"S",
"is_succeed":true,
"pos_type":5,
"instalment":0,
"ratio":0.025,
"user_id":"tst",
"amount":1,
"due_date":"2018-12-24T00:00:00",
"agent_service_amount":0,
"agent_pay_amount":0,
"company_pay_amount":1.96,
"company_service_amount":0.04
}
]
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | -------------------------------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | [ ](< https://pts-api.paynet.com.tr>) |
| {% endtab %} | |
| {% endtabs %} | |
# Finansallaştırma
v1/transaction/capture
Paynet.js ve ya Paynet-custom.js ile başlatılan gömülü ya da custom form entegrasyonlarında ödeme anayı alınan ön provizyonlu kredi kartı işlemini, kredi kartından ilgili tutarın veya ilgili tutardan az olarak finansallaştırmanın yapıldığı servistir. Bu servisi kullanmak için ödeme onaylama( charge ) servisinde transaction\_type değerini (3 : PreAuth ) ön provizyonlu işlem olarak onaylamalısınız.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------- | ----------- | ------- | --------------------------------------------------- |
| **xact\_id** | string(100) | Evet | İşlemin id'si |
| **amount** | string | | Finansallaştırmanın yapılmasının istenildiği tutar. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **xact\_id** | string(100) | İşlemin id’si |
| **xact\_date** | datetime | İşlemin tarihi |
| **transaction\_type** | char(1) | 1: satış 4:Finansallaştırma |
| **pos\_type** | char(1) | 5: Paynet POS |
| **is\_tds** | bool | İşlem 3D’li ise true |
| **agent\_id** | string(10) | İşlemi yapan bayinin Paynet cari hesap kodu |
| **user\_id** | string(10) | İşlemi yapan kullanıcı |
| **email** | string(60) | Mail adresi |
| **phone** | string(10) | Telefon bilgisi |
| **bank\_id** | char(4) | Bankanın Paynet sistemindeki kodu |
| **instalment** | int | Taksit sayısı.[Bknz](/uornek/genel-bilgiler/taksit-kodlari) |
| **ratio** | float | Ödeme sırasında kullanılan oran. |
| **card\_no\_masked** | string(25) | Maskeli kart numarası |
| **card\_holder** | string(50) | Kart sahibi |
| **amount** | decimal | Kredi kartından çekilen tutar |
| **net\_amount** | decimal | Komisyon hariç tutar |
| **comission** | decimal | Komisyon tutarı |
| **comission\_tax** | decimal | Komisyon vergisi |
| **currency** | char(3) | Para birimi |
| **authorization\_code** | string(10) | Banka onay kodu |
| **reference\_code** | string(50) | Banka referans kodu |
| **order\_id** | string(50) | Banka sipariş no |
| **is\_succeed** | bool | İşlem başarılı ise true. Eğer işlem başarılı ise http 200 ve is\_succeed true döner. Banka onay vermemiş ise http 200 ve is\_succedd false döner. |
| **paynet\_error\_id** | string | Paynet sistemi hata kodu |
| **paynet\_error\_message** | string | Paynet sistemi hata mesajı |
| **bank\_error\_id** | string(50) | Banka sisteminin hata kodu |
| **bank\_error\_message** | string(50) | Banka sisteminin hata mesajı |
| **bank\_error\_short\_desc** | string(250) | Banka sisteminin hata mesajı |
| **bank\_error\_long\_desc** | string | Banka sisteminin hata mesajı |
| **object\_name** | string | transaction |
| **code** | string | Sistem sonuç kodu bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Sistem mesajı |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"xact_id":"xk_EAAAANFhOW7SioFxO8LHPMruxp0hX3wE8NmJSmGUD*W3uISj"
"amount":"100"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"xact_id": "xk_EAAAAIO6j*mZ24gKFpk739cUeuL9P7oKyavBUO0Rbe7WKYXG"
"xact_date": "2016-04-08T10:27:22.0296925+03:00"
"transaction_type": 4
"pos_type": 5
"is_tds": true
"agent_id": "20005"
"user_id": "cardholder"
"email": ""
"phone": ""
"bank_id": "AXSS"
"instalment": 3
"ratio": 0.04
"card_no_masked": "435508******4358"
"card_holder": "GJH"
"amount": 0
"net_amount": 56.55
"comission": 2.37
"comission_tax": 0.43
"currency": "TRY"
"authorization_code": "aut-8229"
"reference_code": "ref-8229"
"order_id": "order-8229"
"is_succeed": true
"paynet_error_id": ""
"paynet_error_message": ""
"bank_error_id": ""
"bank_error_message": ""
"bank_error_short_desc": ""
"bank_error_long_desc": ""
"object_name": "transaction"
"code": 0
"message": "Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------------------------------ |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# Ödeme Kontrol
v1/transaction/check
Yapılan bir kredi kartı işleminin detay bilgisini döner. Ödeme sonrası işlem bilgilerine hızlı erişim için kullanabilirsiniz.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ----------------- | ----------- | ------- | ----------------------------------------------------------------------------------------------------------- |
| **xact\_id** | string(100) | Evet\* | Paynet işlem ID’si |
| **reference\_no** | string(50) | Evet\* | Ödeme işleminde kullandığınız referans numaranız. Her işlemde unique bir numara göndermeniz tavsiye edilir. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ------------------------- | ----------- | -------------------------------------------------------------------------------------------- |
| **xact\_id** | string(100) | İşlemin id’si |
| **xact\_date** | datetime | İşlemin tarihi |
| **transaction\_type** | char(1) | 1: satış, 2: önprovizyon |
| **pos\_type** | char(1) | 1: Süpürmeli POS 5: Paynet POS |
| **is\_tds** | bool | İşlem 3D’li ise true |
| **agent\_id** | string(10) | İşlemi yapan bayinin Paynet cari hesap kodu |
| **email** | string(60) | Kullanılmıyor |
| **phone** | char(10) | Kullanılmıyor |
| **note** | string(140) | Ödeme sırasında kullandığınız açıklama (data-description) |
| **ratio** | float | Ödeme sırasında kullanılan oran |
| **agent\_reference** | string(50) | Ödeme işleminde kullandığınız referans numaranız. reference\_no ile aynı |
| **bank\_id** | char(4) | Bankanın Paynet sistemindeki kodu |
| **instalment** | int | Taksit sayısı. [Bknz.](/uornek/genel-bilgiler/taksit-kodlari) |
| **card\_type** | char(2) | Kart tipi. [Bknz](/uornek/genel-bilgiler/veri-tipleri/kart-tipi) |
| **card\_no** | string(25) | Maskeli kart numarası |
| **card\_holder** | string(50) | Kart sahibi |
| **amount** | decimal | Kredi kartından çekilen tutar |
| **netAmount** | decimal | Komisyon hariç tutar |
| **comission** | decimal | Komisyon tutarı |
| **comission\_tax** | decimal | Komisyon vergisi |
| **currency** | char(3) | Para birimi |
| **authorization\_code** | string(10) | Banka onay kodu |
| **reference\_code** | string(50) | Banka referans kodu |
| **order\_id** | string(50) | Banka sipariş no |
| **is\_succeed** | bool | İşlemin başarılı olup olmadığını gösterir. |
| **xact\_transaction\_id** | guid 32 | Paynet işlem takip numarası |
| **object\_name** | string | Transaction |
| **code** | string | Sistem sonuç kodu bknz. [Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Sistem mesajı |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
xact_id:"xk_EAAAAAh7VYf9HG4+GR9ezqiMWAA8PY6P4eroE4BUUHRCLxGO"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"Data":[
{
"xact_id":"xk_EAAAAJsdkI0VROQqWBJO2iq7lttGlkXmFkLD4ZszOT8kWsgu",
"xact_date":"2015-08-03T11:42:06.513",
"transaction_type":1,
"pos_type":5,
"agent_id":"20000",
"is_tds":true,
"bank_id":"PARF",
"instalment":3,
"card_no":"415514******3588",
"card_holder":"Emre",
"card_type":"cc",
"ratio":0.03,
"amount":15.55,
"netAmount":15,
"comission":0.47,
"comission_tax":0.08,
"currency":"TRY",
"authorization_code":"aut-2444",
"reference_code":"ref-2444",
"order_id":"order-2444",
"is_succeed":true,
"xact_transaction_id":"01CFB16C-C343-4311-B886-3DF73BB1CC39",
"email":"",
"phone":" ",
"note":"\u00d6demenizi tamamlamak i\u00e7in bilgileri girip tamam butonuna bas\u0131n\u0131z",
"agent_reference":"1234",
"object_name":"transaction",
"code":0,
"message":"Ba\u015far\u0131l\u0131 \u0130\u015flem"
}
],
"object_name":"transaction",
"code":0,
"message":"Ba\u015far\u0131l\u0131 \u0130\u015flem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
\*xact\_id veya reference\_no'dan en az birini göndermeniz gerekmektedir.
{% endhint %}
# İşlem Detay
v1/transaction/detail
Yapılan bir kredi kartı işleminin detay bilgisini döner. Charge servisinde kullandığınız referans numarası ya da paynet işlem numarası ile sorgulama yapabilirsiniz. Aynı referans numarası ile bir den fazla işlem var ise tüm işlemleri dizi şeklinde döner.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ----------------- | ----------- | ------- | ----------------------------------------------------------------------------------------------------------- |
| **xact\_id** | string(100) | Evet\* | Paynet işlem ID’si |
| **reference\_no** | string(50) | Evet\* | Ödeme işleminde kullandığınız referans numaranız. Her işlemde unique bir numara göndermeniz tavsiye edilir. |
| **user\_id** | string(10) | Hayır | Paynet Kullanici kodu |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **xact\_id** | string(100) | İşlemin id’si |
| **xact\_date** | datetime | İşlemin tarihi |
| **transaction\_type** | char(1) | Sales:1/ Reversal:2/ PreAuth:3 /Capture:4/ PreAuthReversal:5 /CaptureReversal:6 /Query:7/ Credit:9/ PointUse:10/ PointReturn:11 |
| **xact\_type\_desc** | string(50) | İşlem tipi açıklaması |
| **pos\_type** | char(1) | 5: Paynet POS / 1: Süpürmeli POS |
| **pos\_type\_desc** | string(100) | Pos tipi açıklaması |
| **is\_tds** | bool | İşlem 3D’li ise true |
| **agent\_id** | string(10) | İşlemi yapan bayinin Paynet cari hesap kodu |
| **agent\_name** | string(50) | Bayi Adı |
| **company\_name** | string(50) | Ana firma adı |
| **email** | string(60) | Kullanılmıyor |
| **phone** | string(10) | Kullanılmıyor |
| **note** | string(140) | Ödeme sırasında kullandığınız açıklama (data-description) |
| **ratio** | float | Ödeme sırasında kullanılan oran. |
| **agent\_reference** | string(50) | Ödeme işleminde kullandığınız referans numaranız |
| **bank\_id** | char(4) | Bankanın Paynet sistemindeki kodu |
| **bank\_name** | string(100) | Banka adı |
| **instalment** | int | Taksit sayısı. [Bknz](/uornek/genel-bilgiler/taksit-kodlari) |
| **instalment\_text** | string(100) | Taksit açıklaması |
| **payment\_string** | string(100) | Ödeme planı |
| **card\_no** | string(25) | Maskeli kart numarası |
| **card\_holder** | string(50) | Kart sahibi |
| **card\_type** | char(2) | Kredi kartı. [Bknz](/uornek/genel-bilgiler/veri-tipleri/kart-tipi) |
| **amount** | decimal | Kredi kartından çekilen tutar |
| **netAmount** | decimal | Komisyon hariç tutar |
| **comission** | decimal | Komisyon tutarı |
| **comission\_tax** | decimal | Komisyon vergisi |
| **currency** | char(3) | Para birimi |
| **authorization\_code** | string(10) | Banka onay kodu |
| **reference\_code** | string(50) | Banka referans kodu |
| **order\_id** | string(50) | Banka sipariş no |
| **is\_succeed** | bool | İşlemin başarılı olup olmadığını gösterir. |
| **reversed** | bool | True/False işlem iptal edilmiş ise true döner |
| **reversed\_xact\_id** | string(100) | İşlem tipi iptal olan işlemlerde hangi işlemin iptal olduğunu belirtir. |
| **reversal\_available** | bool | İade yapabilme yetkisi kontrolü |
| **xact\_transaction\_id** | guid 32 | Paynet işlem takip numarası |
| **company\_amount** | decimal | Bu işlem sonucunda Ana Firma Brüt alacak |
| **company\_commission** | decimal | Bu işlem sonucunda ana firmaya kesilecek komisyon tutarı |
| **company\_commission\_with\_tax** | decimal | Bu işlem sonucunda ana firmaya kesilecek KDV'li komisyon tutarı |
| **company\_net\_amount** | decimal | Bu işlem sonucunda ana firmaya ödenecek net tutar |
| **agent\_amount** | decimal | Bu işlem sonucunda Bayi Brüt alacağı |
| **agent\_commission** | decimal | Bu işlem sonucunda bayi komisyonu |
| **agent\_commission\_with\_tax** | decimal | Bu işlem sonucunda bayi KDV'li komisyonu |
| **agent\_net\_amount** | decimal | Bu işlem sonucunda bayiye ödenecek net tutar |
| **company\_cost\_ratio** | float | Ana firma komisyon değeri |
| **company\_pay\_ratio** | float | Ana firma / Bayi Arasındaki ödeme oranı |
| **ipaddress** | string(15) | İşlemin yapıldığı ip adresi |
| **client\_id** | guid 32 | İşlemin yapıldığı client id’si |
| **object\_name** | string | transaction |
| **code** | string | Sistem sonuç kodu bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Sistem mesajı |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
xact_id:"xk_EAAAAAh7VYf9HG4+GR9ezqiMWAA8PY6P4eroE4BUUHRCLxGO"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"Data":[
{
"xact_id":"xk_EAAAAECDqPDZHcx1TbLMmlRmWzZqMvxFKBH41vJAZTxRGlDH",
"xact_date":"2015-12-04T18:14:28.377",
"transaction_type":1,
"pos_type":5,
"agent_id":"10000",
"is_tds":true,
"bank_id":"BONS",
"instalment":0,
"card_no":"444444******4448",
"card_holder":"a a",
"card_type":"cc",
"ratio":0.02,
"amount":813.75,
"netAmount":794.54,
"comission":16.28,
"comission_tax":2.93,
"currency":"TRY",
"authorization_code":"aut-4276",
"reference_code":"ref-4276",
"order_id":"order-4276",
"is_succeed":true,
"reversed":false,
"reversed_xact_id":"xk_EAAAAGZEFDuBYb3R9qZ0YJ\/y3Tw7K1nc6sJXlRfe*0ZRk6sc",
"xact_transaction_id":"58573BB6-1F67-4DB1-841B-E44D8EA2873F",
"email":"yakup.kaymaz@isisbilisim.com.tr",
"phone":" ",
"note":"",
"agent_reference":"",
"company_amount":813.75,
"company_commission":16.28,
"company_commission_with_tax":19.2104,
"company_net_amount":794.5396,
"agent_amount":0,
"agent_commission":0,
"agent_commission_with_tax":0,
"agent_net_amount":0,
"company_cost_ratio":0.02,
"company_pay_ratio":0,
"company_vdate":"0001-01-01T00:00:00",
"agent_vdate":"0001-01-01T00:00:00",
"xact_type_desc":"Sat\u0131\u015f",
"bank_name":"Bonus",
"payment_string":"Bonus Tek \u00e7ekim",
"pos_type_desc":"Paynet POS",
"agent_name":"ARENA B\u0130LG\u0130SAYAR SAN. VE T\u0130C.A.\u015e.",
"company_name":"ARENA B\u0130LG\u0130SAYAR SAN. VE T\u0130C.A.\u015e.",
"instalment_text":"Pe\u015fin",
"ipaddress":"212.156.16.214",
"client_id":"9cb93236-41d8-4656-ad4d-746693b0f0a0",
"object_name":"transaction",
"code":0,
"message":"Ba\u015far\u0131l\u0131 \u0130\u015flem"
}
],
"object_name":"transaction",
"code":0,
"message":"Ba\u015far\u0131l\u0131 \u0130\u015flem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------------------------------ |
| **Canlı Sistem** | **** |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
\*xact\_id veya reference\_no'dan en az birini göndermeniz gerekmektedir.
{% endhint %}
# İşlem Listesi
v1/transaction/list
Paynet ’ten yapılan işlemlerin listesini almak için kullanılır.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ------------------- | ---------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **agent\_id** | string(10) | Hayır | Paynet bayi kodu |
| **bank\_id** | char(4) | Hayır | Banka kodu |
| **datab** | date | Evet | Başlangıç Tarihi |
| **datbi** | date | Evet | Bitiş Tarihi |
| **show\_unsucceed** | bool | Hayır | Bu parametre “true” ise başarılı işlemler ile birlikte başarısız işlemleride getirir. Default değeri “false” |
| **limit** | int | Hayır | Döndürülecek veri sayısı. Default 10 kayıt döner. |
| **ending\_before** | int | Hayır | Belirtilen index’den önceki limit sayısı kadar kayıt getirir. Eğer ending\_before 90 gönderildi, limit olarak 15 gönderildi. 75. İle 90. Kayıtları arasındaki kayıtları gönderir. |
| **starting\_after** | int | Hayır | Belirtilen index’den sonraki limit sayısı kadar kayıt getirir. Eğer starting after 15 gönderildi, limit olarak 15 gönderildi. 15. İle 30. Kayıtları arasındaki kayıtları gönderir. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **companyCode** | string(10) | Ana firma kodu |
| **companyName** | string(50) | Ana firma adı |
| **xact\_date** | datetime | İşlem tarihi dd.mm.yyyy formatında |
| **xact\_time** | datetime | İşlemin zamani dd.mm.yyyy HH:SS:ss |
| **total** | int | Toplam satır sayısı |
| **total\_count** | int | Toplam gösterilen satır sayısı |
| **total\_amount** | int | Toplam işlem tutar |
| **limit** | int | Gönderilen limit bilgisi |
| **ending\_before** | int | Gönderilen ending\_before bilgisi |
| **starting\_after** | int | Gönderilen starting\_after bilgisi |
| **object\_name** | string | transaction\_list |
| **has\_more** | bool | True ise Belirtilen kriterlerde gönderilen satırlardan daha olduğu anlamına gelir. |
| **Data\[]** | | |
| **-> merchant\_id** | string(50) | İşlemin yapıldığı üye iş yeri numarası |
| **-> company\_cost\_ratio** | float | Ana firma komisyon oranı. Sadece ana firma tarafından çekilen raporlarda gelir. |
| **-> agent\_id** | string(10) | Paynet Bayi kodu |
| **-> user\_id** | string(10) | Paynet Kullanici kodu |
| **-> xact\_note** | string(140) | İşlem yapılırken gönderilen description |
| **-> xact\_agent\_reference** | string(50) | İşlem yapılırken girilen referans numarası |
| **-> agent\_referans\_no** | string(50) | Ana Firma Bayi Kodu. Bayinin ana firmadaki kodu |
| **-> agent\_name** | string(50) | Bayi Adı |
| **-> xact\_id** | string(100) | Paynet işlem numarası |
| **-> is\_tds** | bool | İşlemin 3D secure ile yapılıp / yapılmadığı |
| **-> bank\_id** | char(4) | Banka kodu |
| **-> bank\_name** | string(100) | Banka adı |
| **-> card\_no** | string(25) | Kart numarası |
| **-> card\_holder** | string(50) | Kart sahibinin adı |
| **-> card\_type** | char(2) | Kart tipi |
| **-> card\_type\_name** | string(20) | Kart tipi açıklaması |
| **-> authorization\_code** | string(10) | Banka onay kodu |
| **-> reference\_code** | string(50) | Banka referans kodu |
| **-> order\_id** | string(50) | Banka sipariş numarası |
| **-> postype\_desc** | string(100) | Pos tipi açıklaması |
| **-> xact\_type** | char(2) | İşlem tipi. [Bknz](/uornek/genel-bilgiler/veri-tipleri/islem-tipi) |
| **-> xacttype\_desc** | string(50) | İşlem açıklaması |
| **-> fiscal\_period\_id** | char(6) | İşlemin yapıldığı mali dönem yyyyMM şeklinde. |
| **-> sector\_id** | char(4) | Sektör id’si |
| **-> sectorid\_desc** | string(20) | Sektör açıklaması |
| **-> channel\_name** | string(50) | İşlemin yapıldığı kanalın açıklaması |
| **-> ipaddress** | string(15) | İşlemin yapıldığı ip adresi |
| **-> client\_id** | guid 32 | İşlemin yapıldığı client |
| **-> xact\_transaction\_id** | guid 32 | Paynet takip kodu |
| **-> terminal\_id** | string(50) | İşlemin yapıldığı terminal numarası |
| **-> is\_succeed** | bool | İşlemin başarılı ya da başarısız olduğu. İşlem başarılı ile kredi kartından ilgili tutar çekilmiş demektir. Başarısız ise bir nedenden dolayı karttan çekim yapılamamıştır. |
| **-> reversed** | bool | İşlemin iptal edilip edilmediği |
| **-> is\_reconcile** | bool | Banka mutabakat yapılıp yapılmadığı anlamına gelir |
| **-> is\_payup** | bool | Ödemesinin firmaya yapılıp yapılmadığı |
| **-> is\_onchargeback** | bool | İşlemde charback talebi yapılıp yapılmadığı |
| **-> is\_transferred** | bool | İşlemin cari hesabınıza aktarılıp aktarılmadığı. |
| **-> reversed\_xact\_id** | string(100) | İptal kayıtlarında hangi kaydın iptali olduğunu belirler |
| **-> channel\_id** | int | İşlemin yapıldığı kanalın id’si |
| **-> pos\_type** | char(1) | Pos tipi |
| **-> instalment** | int | Taksit sayısı |
| **-> amount** | decimal | Kredi kartından çekilen tutar |
| **-> net\_amount** | decimal | Komisyon hariç tutar |
| **-> comission** | decimal | Komisyon tutarı |
| **-> comission\_tax** | decimal | Komisyon vergisi |
| **-> currency** | char(3) | Para birimi |
| **-> ratio** | float | Komisyon oranı |
| **-> company\_pay\_ratio** | float | Ana firmaya ödeme dağılımı oranı %50 için 50 gelir. |
| **-> company\_cost\_ratio** | float | Ana Firma Komisyonu % |
| **-> ana\_firma\_komisyonu** | decimal | Ana Firma Komisyonu TL (KDV Hariç) |
| **-> ana\_firma\_komisyonu\_kdv\_dahil** | decimal | Ana Firma Komisyonu TL (KDV Dahil) |
| **-> ana\_firma\_odenecek\_net\_tutar** | decimal | Ana Firma Ödenecek Net Tutar |
| **-> cp\_mfi\_vdate\_day** | int | Ana Firma Ödeme Blokajı (Gün) |
| **-> cp\_mfi\_vdate** | date | Ana Firmaya Ödeme Vadesi |
| **-> ana\_firma\_brut\_alacak** | decimal | Ana Firma Brüt Alacak |
| **-> bayi\_brut\_alacak** | decimal | Bayi Brüt Alacak |
| **-> bayi\_komisyonu** | decimal | Bayi Komisyonu TL (KDV Hariç) |
| **-> bayi\_komisyonu\_kdv\_dahil** | decimal | Bayi Komisyonu TL (KDV Dahil) |
| **-> bayiye\_odenecek\_net\_tutar** | decimal | Bayiye Ödenecek Net Tutar |
| **-> ap\_mfi\_vdate\_day** | int | Bayi Ödeme Blokajı (Gün) |
| **-> ap\_mfi\_vdate** | int | Bayiye Ödeme Vadesi |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"datab":"2015-04-04",
"datbi":"2015-05-05"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"companyCode":"10000",
"companyName":"ARENA B\u0130LG\u0130SAYAR SAN. VE T\u0130C.A.\u015e.",
"total":18,
"total_count":1,
"limit":1000,
"ending_before":0,
"starting_after":0,
"total_amount":359.778,
00,
"object_name":"transaction_list",
"has_more":false,
"Data":[
{
"merchant_id":"100100000",
"companyCode":"10000",
"companyName":"ARENA B\u0130LG\u0130SAYAR SAN. VE T\u0130C.A.\u015e.",
"agent_id":"20000",
"agent_referans_no":"12471",
"agent_name":"BURLA MAKINA TIC.VE YATIRIM A.\u015e.",
"xact_id":"xk_EAAAANi*ptb1bujhrJ0q5Vntse1l9ODuLzjnVzcodwngDyUo",
"xact_date":"10.12.2015",
"is_tds":true,
"bank_id":"AXSS",
"bank_name":"Axess",
"card_no":"434678******0002",
"card_holder":"fsfsfs",
"card_type":"bc",
"card_type_name":"Kredi Kart\u0131",
"authorization_code":"aut-2545",
"reference_code":"ref-2545",
"order_id":"order-2545",
"postype_desc":"Paynet POS",
"xact_type":"S",
"xacttype_desc":"Sat\u0131\u015f",
"fiscal_period_id":"201512",
"sector_id":"0001",
"sectorid_desc":"Bili\u015fim",
"channel_name":"Paynet Api",
"ipaddress":"10.1.2.176",
"client_id":" ",
"xact_transaction_id":"0110CBF1-3D81-4C94-9B4B-F4D94F035E09",
"terminal_id":"",
"is_succeed":true,
"reversed":false,
"is_reconcile":false,
"is_payup":false,
"is_onchargeback":false,
"is_transferred":false,
"reversed_xact_id":"",
"channel_id":2,
"pos_type":5,
"instalment":3,
"amount":"150,00",
"net_amount":"144,69",
"comission":"4,50",
"comission_tax":"0,81",
"currency":"TRY",
"ratio":"3,00",
"user_id":"paynetj",
"xact_time":"10.12.2015 23:05:11",
"xact_note":"",
"xact_agent_reference":"",
"company_pay_ratio":"30,00",
"company_cost_ratio":"3,00",
"ana_firma_brut_alacak":"45,00",
"ana_firma_komisyonu":"0,00",
"ana_firma_komisyonu_kdv_dahil":"0,00",
"ana_firma_odenecek_net_tutar":"45,00",
"bayi_brut_alacak":"105,00",
"bayi_komisyonu":"4,50",
"bayi_komisyonu_kdv_dahil":"5,31",
"bayiye_odenecek_net_tutar":"99,69",
"cp_mfi_vdate":"01.01.1900",
"cp_mfi_vdate_day":0,
"ap_mfi_vdate":"01.01.1900",
"ap_mfi_vdate_day":0
},
....
]
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# İşlem İşaretleme
v1/transaction/mark\_transferred
Paynet işlemlerini kendi sisteminize aktarırken list servisinden sadece aktarılmamış kayıtların gelmesini isterseniz bu servis ile o işlemi aktarıldı olarak işaretleyebilirsiniz.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------- | ------ | ------- | --------------------- |
| **xact\_id** | string | Evet | Paynet işlem numarası |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------------------------------------------------------------------- |
| **object\_name** | string | Dönüş yapılan API'nin nesne adı |
| **code** | string | Sistem sonuç kodu bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Sistem mesajı |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
xact_id: "xk_EAAAAAh7VYf9HG4+GR9ezqiMWAA8PY6P4eroE4BUUHRCLxGO"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"transaction_mark_transferred",
"message":"Başarılı İşlem",
"code":0
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# İşlem Bilgi Ekleme
v1/transaction/add\_info
Ödeme alınması sonrası işleminiz hakkında e-mail, telefon, referans kodu ve not eklemenize veya güncellemenize olanak tanır.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------------- | ------ | ------- | ----------------------------------------------- |
| **xact\_id** | string | Evet | Paynet işlem numarası |
| **note** | string | Hayır | Ödeme ile ilgili not bilgisi |
| **email** | string | Hayır | Ödeme ile ilgili mail bilgisi |
| **phone** | string | Hayır | Ödeme ile ilgili telefon bilgisi |
| **agent\_reference** | string | Hayır | Ödeme ile ilgili bayi referans numarası bilgisi |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ----------------------------------------------------------------------------------------------- |
| **object\_name** | string | Dönüş yapılan API’nin nesne adı |
| **code** | string | Dönüş sonucunun kodu. Bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Dönüş sonuç kodunun açıklaması |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"xact_id":"xk_EAAAAEwBHM0lIgwZbfPU5TmiHhhc/ARIrakW/9476pYzEyta",
"note":"note alanı",
"phone":"2123646464",
"email":"mail@mail.comı",
"agent_reference":"agent_reference alanı"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"transaction_add_info",
"message":"Başarılı İşlem",
"code":0
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# İşlem Slip
v1/transaction/slip
Başarılı işlemleriniz ile ilgili slip almak istediğinizde kullanabileceğiniz servistir.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------- | ------ | ------- | ---------------------------------------------- |
| **xact\_id** | string | Evet | Paynet işlem numarası |
| **email** | string | Hayır | Slip'in gönderilmesi istenilen mail adresi |
| **send\_mail** | bool | Hayır | mail gönderilsin mi? |
| **phone** | string | Hayır | Slip'in gönderilmesi istenilen telefon bilgisi |
| **send\_sms** | bool | Hayır | sms gönderilsin mi? |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | --------------------------------------------------------------------------------- |
| **object\_name** | string | Dönüş yapılan API’nin nesne adı |
| **code** | string | Dönüş sonucunun kodu. [Bknz](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Dönüş sonuç kodunun açıklaması |
| **url** | string | Slip'i görebileceğiniz URL adresi |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"xact_id":"xk_EAAAAEwBHM0lIgwZbfPU5TmiHhhc/ARIrakW/9476pYzEyta",
"email":"mail@arena.com.tr",
"send_mail":"true"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"url":"https://pts.paynet.com.tr/S/PaynetSlip?xact_id=xk_EAAAAEwBHM0lIgwZbfPU5TmiHhhc/***********;companyCode=****&agentID=****",
"object_name":"transaction_slip",
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | -------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# İmza Yükle
v1/transaction/upload
Bu servis ile; ödemesi alınmış başarılı işlemleriniz ile ilgili işlem onay verisi olarak imza resmini base64 formatında yükleyebilirsiniz.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------------- | ------ | ------- | ---------------------------------------------- |
| **xact\_id** | string | Evet | Paynet işlem numarası |
| **pars\_base64** | string | Evet | Resim verisinin base64'e dönüştürülmüş formatı |
| **pars\_file\_name** | string | Hayır | Resim verisinin adı |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | --------------------------------------------------------------------------------- |
| **object\_name** | string | Dönüş yapılan API’nin nesne adı |
| **code** | string | Dönüş sonucunun kodu. [Bknz](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Dönüş sonuç kodunun açıklaması |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"xact_id":"xk_EAAAAEwBHM0lIgwZbfPU5TmiHhhc/ARIrakW/9476pYzEyta",
"pars_base64":"İmza datasının base64'lü hali"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"file_upload",
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# İptal/İade
# İade Talebi
v1/transaction/reversed\_request
Başarılı kredi kartı işlemlerinin iptali, iadesi veya kısmi iadesi talebi için kullanılır. Burada önemli olan nokta işlemin yapıldığı tarihtir. Aynı gün yapılan işlemler tüm tutar iptal edilir. Geçmiş tarihli işlemler tümü iade olabilir ya da kısmı iade yapabilirsiniz. Aynı gün yapılan işlemlerde kısmi iade yapılamaz.
{% hint style="info" %}
Bu servis ile işlem'in iptal/iade'si için Paynet sisteminde bir talep oluşturulur. Operasyon ekibi bu talebi inceler ve uygun gördüğü takdirde işlemi gerçekleştirir.
{% endhint %}
{% hint style="info" %}
Ödeme servisini kullanabilmeniz için secret\_key ile basic authentication yapmalısınız. [bnkz](https://doc.paynet.com.tr/~/drafts/-LVM8pMcgdJBFmKMmegC/primary/authentication#secret-key).
{% endhint %}
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------- | ------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **xact\_id** | string | Evet | Paynet işlem numarası |
| **amount** | string | Hayır | İade edilecek tutar. İade edilecek tutarının yüz ile çarpılmış hali. “10.00 TL” => “1000” olarak gönderilmeli. Eğer gönderilmez ya da 0 gönderilirse tüm işlem tutarı iade edilir. |
| **succeedUrl** | string | Hayır | İade talebi onaylandığında veya onaydan kaldırıldığında succeedUrl adresine durumuyla ilgili post işlemi yapılır. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | --------------------------------------------------------------------------------- |
| **object\_name** | string | Dönüş yapılan API’nin nesne adı |
| **code** | string | Dönüş sonucunun kodu. [Bknz](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Dönüş sonuç kodunun açıklaması |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
xact_id: "xk_EAAAAAh7VYf9HG4+GR9ezqiMWAA8PY6P4eroE4BUUHRCLxGO"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"transaction_reversed_request",
"message":"Başarılı İşlem",
"code":0
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
**succeedUrl Adresine Post Edilen Parametreler**
İade işlemi servisinden gelen talep doğrultusunda istenilen iadenşn onayı veya reddi durumunda, iade işlemi (v1/transaction/reversed\_request) servisinde belirtilen succeedUrl parametresinde belirtilen adrese JSON formatında post edilir. Eğer bu parametre boş değere sahip ise post işlemi gerçekleşmez.
#### `İstek Parametreleri`
| Parametre İsmi | Tip | Açıklama |
| -------------- | ------ | ----------------------------------------------------------------------------------------- |
| **xact\_id** | string | İade işleminin Paynet işlem numarası |
| **code** | string | İade işleminin sonuç kodu 0: iade/iptal isteği onaylandı 1: iade/iptal isteği onaylanmadı |
| **status** | string | İade işlemi sonucu ile ilgili durum statusu |
| **message** | string | İade işlemi sonucu ile ilgili not |
# İade Talebi Listesi
v1/transaction/reversal\_list
Paynet ’ten yapılan iptal/iade taleplerinin listesini almak için kullanılır. Bu sayede iptal/iade taleplerinin durumlarını kontrol edebilirsiniz.
{% hint style="info" %}
Ödeme servisini kullanabilmeniz için secret\_key ile basic authentication yapmalısınız. [bnkz](https://doc.paynet.com.tr/~/drafts/-LVM8pMcgdJBFmKMmegC/primary/authentication#secret-key).
{% endhint %}
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ------------------- | --------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **agent\_id** | string (10) | Hayır | Paynet bayi kodu. |
| **bank\_id** | char(4) | Hayır | Banka kodu |
| **datab** | date | Evet | Başlangıç Tarihi |
| **datbi** | date | Evet | Bitiş Tarihi |
| **limit** | int | Hayır | Döndürülecek veri sayısı. Default 10 kayıt döner. |
| **ending\_before** | int | Hayır | Belirtilen index’den önceki limit sayısı kadar kayıt getirir. Eğer ending\_before 90 gönderildi, limit olarak 15 gönderildi. 75. İle 90. Kayıtları arasındaki kayıtları gönderir. |
| **starting\_after** | int | Hayır | Belirtilen index’den sonraki limit sayısı kadar kayıt getirir. Eğer starting after 15 gönderildi, limit olarak 15 gönderildi. 15. İle 30. Kayıtları arasındaki kayıtları gönderir |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ----------------------------- | ----------- | ---------------------------------------------------------------------------------- |
| **company\_code** | string(10) | Ana firma kodu |
| **company\_name** | string(50) | Ana firma adı |
| **xact\_date** | datetime | İşlem tarihi dd.mm.yyyy formatında |
| **entry\_date** | datetime | İade/iptal işlem tarihi dd.mm.yyyy formatında |
| **total** | int | Toplam satır sayısı |
| **total\_count** | int | Toplam gösterilen satır sayısı |
| **total\_amount** | int | Toplam işlem tutarı |
| **limit** | int | Gönderilen limit bilgisi |
| **ending\_before** | int | Gönderilen ending\_before bilgisi |
| **starting\_after** | int | Gönderilen starting\_after bilgisi |
| **object\_name** | string | transaction\_list |
| Data\[] | dizi | |
| **->** has\_more | bool | True ise Belirtilen kriterlerde gönderilen satırlardan daha olduğu anlamına gelir. |
| **->** agent\_id | string(10) | Paynet Bayi kodu |
| **->** user\_id | string(10) | Paynet Kullanici kodu |
| **->** agent\_name | string(50) | Bayi adı |
| **->** xact\_id | string(100) | Paynet işlem numarası |
| **->**reversed\_xact\_id | string(100) | Paynet iptal/iade işlem numarası |
| **->** bank\_id | char(4) | Banka kodu |
| **->** bank\_name | string(100) | Banka adı |
| **->** card\_no | string(25) | Kart numarası |
| **->** card\_holder | string(50) | Kart sahibinin adı |
| **->** authorization\_code | string(10) | Banka onay kodu |
| **->** reference\_code | string(50) | Banka referans kodu |
| **->** status | bool | İşlemin iptal/iade statüsü |
| **->** deleted | bool | İşlemin iptal/iade red edildi mi? |
| **->** delete\_reason | bool | İşlemin iptal/iade red nedeni |
| **->** instalment | int | Taksit sayısı |
| **->** amount | decimal | Kredi kartından çekilen tutar |
| **->** remain\_amount | decimal | İade/iptal edildikten sonra kalan tutar |
| **->** credit\_amount | decimal | İade/iptal edilen tutar |
| **->** requested\_amount | decimal | İade/iptal istenilen tutar |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"agent_id":"",
"bank_id":"",
"datab":"2015-04-04",
"datbi":"2016-11-05",
"ending_before":0,
"starting_after":0,
"limit":1
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"companyCode":"10000",
"companyName":"ARENA BİLGİSAYAR SAN. VE TİC.A.Ş.",
"total":24,
"total_count":2,
"limit":1,
"ending_before":0,
"starting_after":0,
"total_amount":24.781,
00 ",
" object_name":"transaction_list",
"has_more":true,
"Data":[
{
"xact_id":"xk_EAAAAACDUON4k5Wz6WqQ7NmcnPk*TmqGlHdLwpkh5eTF*ict",
"company_code":"10000",
"agent_id":"20060",
"user_id":"aygule",
"bank_id":"WRLD",
"bank_name":"YKB",
"instalment":0,
"amount":2.000,
00,
"entry_date":"10.06.2015",
"xact_date":"10.06.2015",
"status":"İptal edildi",
"cardholder":"test",
"cardno":"450634******5746",
"email":"",
"phone":" ",
"authorizationcode":"aut-2315",
"referencecode":"ref-2315",
"deleted":false,
"delete_reason":"",
"reversed_xact_id":"xk_EAAAAFNHzUQrK0p7fmbRPBzTOPwW2HwNRkGl71I6W4U1czZB",
"company_name":"ARENA BİLGİSAYAR SAN. VE TİC.A.Ş.",
"agent_name":"SMART BILGISAYAR SISTEMLERI",
"remain_amount":0,
"credit_amount":0,
"requested_amount":0
}
]
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# Ön Otorizasyon İptal
v1/transaction/preauth\_reversal
Ön otorizasyonlu yapılan kredi kartı işlemlerinin iptali için kullanılır.
{% hint style="info" %}
Ödeme servisini kullanabilmeniz için secret\_key ile basic authentication yapmalısınız. [bnkz](https://doc.paynet.com.tr/~/drafts/-LVM8pMcgdJBFmKMmegC/primary/authentication#secret-key).
{% endhint %}
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------- | ------------ | ------- | ------------- |
| **xact\_id** | string (100) | Evet | İşlemin id'si |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------------------------------------------------------------------- |
| **object\_name** | string | Dönüş yapılan API'nin nesne adı |
| **code** | string | Sistem sonuç kodu bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Sistem mesajı |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"xact_id":"xk_EAAAANFhOW7SioFxO8LHPMruxp0hX3wE8NmJSmGUD*W3uISj"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"transaction_preauth_reversed_request",
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# Finansallaştırma İptal
v1/transaction/capture\_reversal
Başarılı finansallaştırılmış kredi kartı işlemlerinin iptali için kullanılır.
{% hint style="info" %}
Ödeme servisini kullanabilmeniz için secret\_key ile basic authentication yapmalısınız. [bnkz](https://doc.paynet.com.tr/~/drafts/-LVM8pMcgdJBFmKMmegC/primary/authentication#secret-key).
{% endhint %}
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------- | ------------ | ------- | ------------- |
| **xact\_id** | string (100) | Evet | İşlemin id'si |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **xact\_id** | string(100) | İşlemin id'si |
| **xact\_date** | datetime | İşlemin tarihi |
| **transaction\_type** | char(1) | 4:Finansallaştırma / 6: Finansallaştırma İptal |
| **pos\_type** | char(1) | 5: Paynet POS |
| **is\_tds** | bool | İşlem 3D’li ise true |
| **agent\_id** | string(10) | İşlemi yapan bayinin Paynet cari hesap kodu |
| **user\_id** | string (10) | İşlemi yapan kullanıcı |
| **email** | string(60) | Mail adresi |
| **phone** | string(10) | Telefon bilgisi |
| **bank\_id** | char(4) | Bankanın Paynet sistemindeki kodu |
| **instalment** | int | Taksit sayısı |
| **ratio** | float | Ödeme sırasında kullanılan oran |
| **card\_no\_masked** | string (25) | Maskeli kart numarası |
| **card\_holder** | string (50) | Kart sahibi |
| **amount** | decimal | Kredi kartından çekilen tutar |
| **net\_amount** | decimal | Komisyon hariç tutar |
| **comission** | decimal | Komisyon tuturı |
| **comission\_tax** | decimal | Komisyon vergisi |
| **currency** | decimal | Parabirimi |
| **authorization\_code** | char(3) | Banka onay kodu |
| **reference\_code** | string (10) | Banka referans kodu |
| **order\_id** | string(50) | Banka sipariş no |
| **is\_succeed** | string(50) | İşlem başarılı ise true. Eğer işlem başarılı ise http 200 ve is\_succeed true döner. Banka onay vermemiş ise http 200 ve is\_succedd false döner. |
| **paynet\_error\_id** | bool | Paynet sistemi hata kodu |
| **paynet\_error\_message** | string | Paynet sistemi hata mesajı |
| **bank\_error\_id** | string | Banka sisteminin hata kodu |
| **bank\_error\_message** | string(50) | Banka sisteminin hata mesajı |
| **bank\_error\_short\_desc** | string(50) | Banka sisteminin hata mesajı |
| **bank\_error\_long\_desc** | string(250) | Banka sisteminin hata mesajı |
| **object\_name** | string | transaction |
| **code** | string | Sistem sonuç kodu bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Sistem mesajı |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"xact_id":"xk_EAAAAHTqbS04hq4sU877ZQIiNuIhJ*PVko0sJyhtHOdvxjpf"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"xact_id": "xk_EAAAAHTqbS04hq4sU877ZQIiNuIhJ*PVko0sJyhtHOdvxjpf"
"xact_date": "2016-04-07T15:33:09.543"
"transaction_type": 6
"pos_type": 5
"is_tds": false
"agent_id": "20005"
"user_id": "PaynetApi"
"email": ""
"phone": ""
"bank_id": "VAKF"
"instalment": 0
"ratio": 0.02
"card_no_masked": "402940******5945"
"card_holder": "cardholder"
"amount": 15
"net_amount": 14.65
"comission": 0.3
"comission_tax": 0.05
"currency": "TRY"
"authorization_code": ""
"reference_code": ""
"order_id": ""
"is_succeed": true
"paynet_error_id": ""
"paynet_error_message": ""
"bank_error_id": "6000"
"bank_error_message": "Invalid Ip Address : "
"bank_error_short_desc": ""
"bank_error_long_desc": ""
"object_name": "transaction"
"code": 1
"message": ""
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ----------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# Oran
# Oran Tablosu(Sunucu Tabanlı)
v1/ratio/Get
Sizin için geçerli olan oran tablosunu secret key ile çağırabileceğiniz servistir. Server tarafında kullanmak için uygundur.
{% hint style="info" %}
Ödeme servisini kullanabilmeniz için secret\_key ile basic authentication yapmalısınız. [bnkz](https://doc.paynet.com.tr/~/drafts/-LVM8pMcgdJBFmKMmegC/primary/authentication#secret-key).
{% endhint %}
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ---------------------------- | ------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **pos\_type** | int | Hayır | Paynet’in pos oranlarını mı yoksa Firma POS oranlarını mı kullanılacak onu belirlee. Default olarak Paynet pos’ları çalışır. |
| **amount** | decimal | Hayır | Kredi kartından çekilen toplam tutar. Gönderilen tutar'a göre instalment\_amount,total\_net\_amount,total\_amount,commision,commision\_tax değerlerini hesaplar. |
| **addcomission\_to\_amount** | bool | Hayır | true/false, Default: false. Komisyon tutarının ödeme tutarına eklenip eklenmeyeceği belirlenir. True olduğunda komisyon tutarı kredi kartından çekilecek tutara eklenir. |
| **bin** | string | Hayır | Kredi kartının ilk 6 hanesi gönderilir ise sadece kartın ait olduğu bankanın oranlarını döner. |
| **agent\_id** | string | Hayır | Ana firma, bayilerinin oranını görmek isterse; Paynet bayi kodunu değer olarak vermelidir. |
| **ratio\_code** | string | Hayır | Tanımladığınız oran tablosunu kodunu bu alanda gönderirseniz, o koda tanımlı oran ve taksit tablonuz görünür. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------------- | ----------- | ----------------------------------------------------------------------------------------------------- |
| **instalment\_key** | string | İlgili oranın ID'si. Custom Form Entegrasyonunda hangi taksit işlemi geçtiği bu ID gönderilerek olur. |
| **instalment** | int | Taksit sayısı. [Bknz](/uornek/genel-bilgiler/taksit-kodlari) |
| **instalment\_amount** | decimal | Kredi kartından çekilecek taksit tutarı |
| **desc** | string(50) | Taksit açıklaması |
| **bank\_id** | char(4) | Bankanın Paynet sistemindeki kodu |
| **bank\_logo** | string(60) | Banka logo |
| **bank\_name** | string(100) | Banka adı |
| **ratio** | float | Ödeme sırasında kullanılan oran. |
| **total\_amount** | decimal | Kredi kartından çekilen toplam tutar |
| **total\_net\_amount** | decimal | Komisyon hariç tutar |
| **commission** | decimal | Komisyon tutarı |
| **commission\_tax** | decimal | Komisyon vergisi |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"bin":"434678",
"amount":100
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"data":[
{
"bank_id":"AXSS",
"bank_logo":"http://localhost:64102/img/banklogo/small/AXSS.png",
"bank_name":"Axess",
"ratio":[
{
"ratio":0.02,
"instalment_key":"ji_EAAAAIi3zzUmsF9+s+onpvYG8g1pSXU5ymrpxEgBh1TyP/dN",
"instalment":0,
"instalment_amount":2.0,
"total_net_amount":1.96,
"total_amount":2.0,
"commision":0.04,
"commision_tax":0.00,
"desc":"Peşin"
},
{
"ratio":0.03,
"instalment_key":"ji_EAAAAAvOYWDjZ57GMBr3qbA+0aNHRNLwpyStLeBzeWFzOQgz",
"instalment":3,
"instalment_amount":0.67,
"total_net_amount":1.92,
"total_amount":2.0,
"commision":0.06,
"commision_tax":0.02,
"desc":"3 Taksit"
},
{
"ratio":0.03,
"instalment_key":"ji_EAAAAJca+t5ymv2WLi8aWuQNpfjyuq92XtgEIPhzLip8N4Jg",
"instalment":6,
"instalment_amount":0.33,
"total_net_amount":1.92,
"total_amount":2.0,
"commision":0.06,
"commision_tax":0.02,
"desc":"6 Taksit"
},
{
"ratio":0.02,
"instalment_key":"ji_EAAAAGam87sdWVgSGJ4FvWiqK/YEwk5P2r3xDFOctGlTin9X7tE0ahdpfeVJA6I6oCW7Qw==",
"instalment":101,
"instalment_amount":0.02,
"total_net_amount":1.96,
"total_amount":2.0,
"commision":0.04,
"commision_tax":0.00,
"desc":"Puan Kullanimi"
}
]
}
],
"object_name":"ratio_get",
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | -------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# Oran Tablosu(İstemci Taraflı)
v1/ratio/Get\_public
Paynet oran servisini client tarafta veren servistir.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| --------------------------- | ------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **pos\_type** | int | Hayır | Paynet’in pos oranlarını mı yoksa Firma POS oranlarını mı kullanılacak onu belirlee. Default olarak Paynet pos’ları çalışır. |
| **amount** | decimal | Hayır | Kredi kartından çekilen toplam tutar. Gönderilen tutar'a göre instalment\_amount,total\_net\_amount,total\_amount,commision,commision\_tax değerlerini hesaplar. |
| **addcomisson\_to\_amount** | bool | Hayır | true/false, Default: false. Komisyon tutarının ödeme tutarına eklenip eklenmeyeceği belirlenir. True olduğunda komisyon tutarı kredi kartından çekilecek tutara eklenir. |
| **bin** | string | Hayır | Kredi kartının ilk 6 hanesi gönderilir ise sadece kartın ait olduğu bankanın oranlarını döner. |
| **agent\_id** | string | Hayır | Ana firma, bayilerinin oranını görmek isterse; Paynet bayi kodunu değer olarak vermelidir. |
| **ratio\_code** | string | Hayır | Tanımladığınız oran tablosunu kodunu bu alanda gönderirseniz, o koda tanımlı oran ve taksit tablonuz görünür. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------------- | ----------- | ----------------------------------------------------------------------------------------------------- |
| **instalment\_key** | string | İlgili oranın ID'si. Custom Form Entegrasyonunda hangi taksit işlemi geçtiği bu ID gönderilerek olur. |
| **instalment** | int | Taksit sayısı. [Bknz](/uornek/genel-bilgiler/taksit-kodlari) |
| **instalment\_amount** | decimal | Kredi kartından çekilecek taksit tutarı |
| **desc** | string(50) | Taksit açıklaması |
| **bank\_id** | char(4) | Bankanın Paynet sistemindeki kodu |
| **bank\_logo** | string(60) | Banka logo |
| **bank\_name** | string(100) | Banka adı |
| **ratio** | float | Ödeme sırasında kullanılan oran. |
| **total\_amount** | decimal | Kredi kartından çekilen toplam tutar |
| **total\_net\_amount** | decimal | Komisyon hariç tutar |
| **comission** | decimal | Komisyon tutarı |
| **comission\_tax** | decimal | Komisyon vergisi |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"bin":"434678",
"amount":100
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"data":[
{
"bank_id":"AXSS",
"bank_logo":"http://localhost:64102/img/banklogo/small/AXSS.png",
"bank_name":"Axess",
"ratio":[
{
"ratio":0.02,
"instalment_key":"ji_EAAAAIi3zzUmsF9+s+onpvYG8g1pSXU5ymrpxEgBh1TyP/dN",
"instalment":0,
"instalment_amount":2.0,
"total_net_amount":1.96,
"total_amount":2.0,
"commision":0.04,
"commision_tax":0.00,
"desc":"Peşin"
},
{
"ratio":0.03,
"instalment_key":"ji_EAAAAAvOYWDjZ57GMBr3qbA+0aNHRNLwpyStLeBzeWFzOQgz",
"instalment":3,
"instalment_amount":0.67,
"total_net_amount":1.92,
"total_amount":2.0,
"commision":0.06,
"commision_tax":0.02,
"desc":"3 Taksit"
},
{
"ratio":0.03,
"instalment_key":"ji_EAAAAJca+t5ymv2WLi8aWuQNpfjyuq92XtgEIPhzLip8N4Jg",
"instalment":6,
"instalment_amount":0.33,
"total_net_amount":1.92,
"total_amount":2.0,
"commision":0.06,
"commision_tax":0.02,
"desc":"6 Taksit"
},
{
"ratio":0.02,
"instalment_key":"ji_EAAAAGam87sdWVgSGJ4FvWiqK/YEwk5P2r3xDFOctGlTin9X7tE0ahdpfeVJA6I6oCW7Qw==",
"instalment":101,
"instalment_amount":0.02,
"total_net_amount":1.96,
"total_amount":2.0,
"commision":0.04,
"commision_tax":0.00,
"desc":"Puan Kullanimi"
}
]
}
],
"object_name":"ratio_get",
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | --------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# Oran Tipi Düzenleme
v1/ratio/set\_type
Yeni bir oran tipi oluşturmanızı veya mevcut bir oran tipinin özelliklerini değiştirmenizi sağlar ve eklenen/düzenlenen oran tipinin kodunu döndürür.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ------------------ | ------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ratio\_type** | string | Hayır | Düzenleyeceğiniz oran tipine ait oran kodu. Yeni oran tipi oluşturulmak isteniyorsa bu parametre gönderilmemelidir. |
| **description** | string | Evet | Tanımlayacağınız oran tipinin açıklaması. |
| **is\_default** | bool | Hayır | true/false, Default: false. Oran tipinin API tarafından varsayılan olarak kullanılıp kullanılmayacağını belirler. |
| **is\_cumulative** | bool | Hayır | true/false, Default: true. Oran hesaplama yöntemini belirler. Parametre "true" olarak gönderilirse oran hesaplama yöntemi "Sabit Fonlama Oranı" olarak seçilmiş olur ve girilen oranlar API'da Paynet oranlarının üstüne +/- olarak eklenerek kullanılır, "false" olarak gönderilirse oran hesaplama yöntemi "Gösterilecek Oran" olarak seçilmiş olur ve oran olarak girilen değerler aynen API'da görüntülenir. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | -------------------------------------------------------------------------------- |
| **ratio\_code** | string | Eklenen veya düzenlenen oran tipinin kodu. |
| **object\_name** | string | Dönüş yapılan API’nin nesne adı. |
| **code** | string | Dönüş sonucunun kodu.[Bknz](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Dönüş sonuç kodunun açıklaması. |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"ratio_code":"S3E746PV",
"description":"Oran tipi açıklaması",
"is_default":false,
"is_cumulative":true
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"ratio_code":"S3E746PV",
"object_name":"ratio_set_type",
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# Oran Tipi Silme
v1/ratio/delete\_type
Tanımladığınız oran tiplerini silmenizi sağlayan servistir.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| --------------- | ------ | ------- | -------------------------------------- |
| **ratio\_code** | string | Evet | Silmek istediğiniz oran tipine ait kod |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ---------------------------------------------------------------------------------------------- |
| **object\_name** | string | Dönüş yapılan API’nin nesne adı |
| **code** | string | Dönüş sonucunun kodu bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Dönüş sonuç kodunun açıklaması |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"ratio_code":"S3E746PV"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"ratio_delete_type",
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ------------- | ---------------------------------------------------- |
| Canlı Sistem | |
| Test Sistemi | |
| {% endtab %} | |
| {% endtabs %} | |
# Oran Tanımlama
v1/ratio/define
Bir oran tipine oranların tanımını yapmayı, bu oran tipi için taksit veya banka bloklamayı sağlayan servistir.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| --------------- | ------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ratio\_code** | string | Evet | Oran tanımı yapmak istediğiniz oran tipine ait kod |
| **banks** | dizi | Evet | Oran tanımlarının yapılacağı bankaları tutan dizi. Bknz. [Banka Kodları](/uornek/genel-bilgiler/banka-kodlari)[ ](https://www.paynet.com.tr/doc/index.html#api-banka_kodlari) |
| **bank\_id** | char(4) | Evet | Tanımların yapılacağı bankaları temsil eden 4 karakterli kod |
| **instalments** | dizi | Hayır | "banks" dizisinin altındaki her nesne için taksitlere ait bilgileri tutan dizilerdir. Bir banka bloklanacaksa bu banka için "instalments" dizisi göndermeye gerek yok. |
| **instalment** | int | Evet | Bloklanacak veya oran tanımı yapılacak taksite ait numara. Bknz. [Taksit Kodları](/uornek/genel-bilgiler/taksit-kodlari) |
| **is\_blocked** | bool | Hayır | true/false, Default: false. Banka veya taksitin bloklu olup olmadığına dair, "banks" veya "instalments" dizilerindeki nesnelere eklenebilir. |
| **ratio** | float | Hayır | Default: 0. Tanımların yapılacağı oran tipinin, oran hesaplama yöntemine göre belli aralıklarda gönderilmesi gereken orandır. Oran hesaplama yönetimi "Kümülatif" olan oran tiplerinde minimum -0.20, maksimum 0.20 olabilir. Oran hesaplama yönetimi "Net" olan oran tiplerinde minimum 0, maksimum 0.20 olabilir. Taksit bloklanacaksa veya oran "0" olarak kaydedilecekse bu parametrenin gönderilmesine gerek yoktur. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------------------------------------------------------------------------ |
| **object\_name** | string | Dönüş yapılan API’nin nesne adı |
| **code** | string | Dönüş sonucunun kodu. Bknz [Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari). |
| **message** | string | Dönüş sonuç kodunun açıklaması |
| {% endtab %} | | |
{% tab title="Request" %}
```
"ratio_code":"S3E746PV",
"banks":[
{
"bank_id":"MAXM",
"is_blocked":"false",
"instalments":[
{
"instalment":"3",
"ratio":"0.13",
"is_blocked":"false"
},
{
"instalment":"6",
"ratio":"0.15",
"is_blocked":"false"
}
]
},
{
"bank_id":"WRLD",
"is_blocked":"false",
"instalments":[
{
"instalment":"3",
"ratio":"0.12",
"is_blocked":"false"
}
]
},
{
"bank_id":"AXSS",
"is_blocked":"true"
}
]
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"ratio_define",
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ----------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# Bayi
# Auto Login
v1/agent/autologin
odeme.paynet.com.tr sistemine api üzerinden otomatik giriş yapabilmenize olanak verir.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------- | ------ | ------- | ----------------------- |
| **user\_name** | string | Evet | Paynet kullanıcı adınız |
| **agent\_id** | string | Evet | Paynet bayi kodunuz |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ---------------------------------------------------------------------------------- |
| **url** | string | ödeme.paynet.com.tr hesabınıza otomatik login olmanızı sağlayacak url adresi |
| **object\_name** | string | Dönüş yapılan API’nin nesne adı |
| **code** | string | Dönüş sonucunun kodu . [Bknz](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Dönüş sonuç kodunun açıklaması |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"agent_id":"54280",
"user_name":"PaynetApi"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"url":"https://pts.paynet.com.tr/Account/PaynetAgentGate?al=EAAAALUbFZV0GZ3yLrGyYPDQEqeuVR%2fzQjelGe7J2fvecUODByB%2bFxqnEBlgWJb0WJUemFc0kvZ04%2bmLtMwsM1YblUc%3d",
"object_name":null,
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | -------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# Login
v1/agent/login
Login servisi doğrulama sonucunda bayi ve kullanıcı bilgilerini döner.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ----------------- | ------ | ------- | ---------------------------------------------- |
| **user\_name** | string | Evet | Paynet kullanıcı adınız |
| **password** | string | Evet | Paynet şifreniz |
| **agent\_id** | string | Evet | Paynet bayi kodunuz |
| **pushtoken\_id** | string | Evet | Device ID |
| **company\_code** | string | Hayır | Ana firma kodu opsiyonel olarak gönderilebilir |
| **os\_type** | string | Hayır | Cihazın işletim sistemi |
| **device\_type** | string | Hayır | Cihazın modeli |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ----------------------------------- | ------ | ------------------------------------------------------ |
| **session\_key** | string | Paynet API servislerinde kullanabileceğiniz key değeri |
| **expired\_date** | string | sessionKey değerinin son kullanma tarihi |
| **logo\_url** | string | Paynet sisteminde kayıtlı logo url |
| **agent\_id** | string | Bayi kodu |
| **user\_name** | string | Kullanıcı adı |
| **user\_id** | string | Kullanıcı kodu |
| **user\_email** | string | Kullanıcı mail adresi |
| **user\_phone** | string | Kullanıcı telefon numarası |
| **company\_code** | string | Ana firma kodu |
| **company\_desc** | string | Ana firma adı |
| **agent\_name** | string | Bayi adı |
| **adress1** | string | Bayi adres1 |
| **adress2** | string | Bayi adres2 |
| **county\_code** | string | Bayi il kodu |
| **county\_name** | string | Bayi il adı |
| **city\_code** | string | Bayi ilçe kodu |
| **city\_name** | string | Bayi ilçe adı |
| **zip\_code** | string | Bayi posta kodu |
| **phone** | string | Bayi telefon |
| **tax\_office** | string | Paynet sistemlerinde kayıtlı vergi dairesi |
| **tax\_id** | string | Paynet sistemlerinde kayıtlı vergi numarası |
| **sectorID** | string | Sektör kodu |
| **referans\_no** | string | Referans numarası |
| **segment\_id** | string | Paynet sistemlerinde kayıtlı segment kodu |
| **segment\_text** | string | Paynet sistemlerinde kayıtlı segment adı |
| **is\_agent\_blocked** | bool | Bayi blokaj durumu |
| **is\_agent\_deleted** | bool | Bayi çıkarılma durumu |
| **is\_activ** | bool | Bayi aktiflik durumu |
| **is\_select\_customer** | bool | Ana firma ya da ara toptan bayilerini belirtir |
| **is\_company** | bool | Login olan bayi ana firma mı? |
| **TransactionAuthorization** | bool | Ödeme İşlemi yapabilir |
| **ReportAuthorization** | bool | İşlem listesini görme |
| **MasterUserAuthorization** | bool | MASTER kullanıcı |
| **AllUserReportAuthorization** | bool | Diğer kullanicilarin islemlerini Görme |
| **ReverseTransactionAuthorization** | string | İptal / İade Yapabilir |
| **code** | string | Dönüş sonucunun kodu |
| **message** | string | Dönüş sonuç kodunun açıklaması |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"agent_id":"Bayi Kodunuz",
"user_name":"PaynetApi",
"password":"PaynetApi"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"userAuthorizationContainer":{
"TransactionAuthorization":true,
"ReportAuthorization":true,
"MasterUserAuthorization":true,
"AllUserReportAuthorization":true,
"ReverseTransactionAuthorization":true
},
"session_key":"mbl_pcs_cs73aR0x00iZnQwAwk*********",
"expired_date":"2016-04-09",
"logo_url":null,
"agent_id":"54266",
"user_name":"gamze yılmazel",
"user_id":null,
"user_email":"dummy",
"user_phone":"dummy",
"company_code":"dummy",
"company_desc":"dummy",
"agent_name":"MACİT GÜMÜŞ VE KUYUM.BİLİŞİM TEKN.L",
"adress1":"ESENTEPE MAH. FSM BULVARI",
"adress2":"BAHAR SİTESİ 96/1B",
"county_code":"33",
"county_name":"dummy",
"city_code":"",
"city_name":"dummy ",
"zip_code":"",
"email":null,
"phone":"dummy",
"tax_office":"İKİTELLİ",
"tax_id":"dummy",
"sector_id":"0001",
"referans_no":"39720",
"segment_id":"Testt",
"segment_text":"Bilişim",
"is_agent_blocked":false,
"is_agent_deleted":false,
"is_activ":false,
"is_company":false,
"object_name":"login",
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | |
| ---------------- | ------------------------------------------------ |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# Limit
v1/agent/limit\_info
Paynet'te tanımlı limitlerinizi görmek için kullanabilirsiniz.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ------------------------ | ------ | ----------------------- |
| **td\_defined\_limit** | string | Tanımlı 3D limit |
| **defined\_limit** | string | Tanımlı limit |
| **td\_used\_limit** | string | Kullanılan 3D limit |
| **used\_limit** | string | Kullanılan limit |
| **td\_available\_limit** | string | Kullanılabilir 3D limit |
| **available\_limit** | string | Kullanılabilir limit |
| {% endtab %} | | |
{% tab title="Response" %}
```
{
"td_defined_limit":"500.000,00",
"defined_limit":"100.000,00",
"td_used_limit":"0,00",
"used_limit":"10,00",
"td_available_limit":"500.000,00",
"available_limit":"99.990,00",
"object_name":"get_limit",
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service url" %}
| Sistem | URL |
| ---------------- | --------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
# Abonelik
Paynet API ile tekrarlanan faturalandırma işlemleri için düzenli ödeme oluşturun ve yönetin.
{% hint style="info" %}
Bu servisi kullanmamdan önce Authentication yaptığınızdan emin olunuz.
{% endhint %}
# Düzenli Ödeme Oluşturma
v1/subscription/create
Bu servis ile müşterinize bir düzenli ödeme talebi oluşturabilirsiniz. Servisten dönen "url" , müşterinizin düzenli ödeme için kart bilgilerini girebileceği ve düzenli ödemenin şartlarına onay verebileceği sayfanın erişim linkidir.İsterseniz müşterinizden kart bilgilerini ve onayı alacağınız sayfayı kendi web siteniz içine düzenli ödeme custom form entegrasyonu ile entegre edebilirsiniz. Bununla ilgili daha detay bilgiyi **** mail adresinden alabilirsiniz.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **name\_surname** | string | Evet | İsim ve soyisim bilgisi |
| **amount** | decimal | Evet | Düzenli ödeme tutarı |
| **interval** | int | Evet | Ödeme periyodu( 0:Günlük, 1:Haftalık, 2:Aylık, 3:Yıllık) |
| **interval\_count** | int | Evet | Toplam çekim adedi. interval aylık(2) ise interval\_count 12 ise bir yıl boyunca her ay çekim yapar. |
| **begin\_date** | datetime | Evet | Düzenli ödeme başlangıç tarihi |
| **reference\_no** | string | Evet | Referans numarası bilgisi |
| **end\_user\_email** | string | Evet | Son kullanıcı email bilgisi |
| **end\_user\_gsm** | string | Evet | Son kullanıcı gsm bilgisi |
| **agent\_id** | string | Hayır | Paynet bayi kodu |
| **agent\_amount** | decimal | Evet | Ödeme çekildikten sonra burada belirtilen tutar bayi hesabına aktarılır.Tutar belirtilmezse default ayarlar geçerlidir. |
| **company\_amount** | decimal | Evet | Ödeme çekildikten sonra burada belirtilen tutar Ana Firma hesabına aktarılır. Tutar belirtilmezse default ayarlar geçerlidir. |
| **end\_user\_desc** | string | Evet | Son kullanıcıya gösterilecek açıklama. " xxx aidatınız için düzenli ödeme onayı istiyoruz " gibi |
| **addcomission\_to\_amount** | string | Hayır | True/False. Default: false. Komisyon tutarının ödeme tutarına eklenip eklenmeyeceği belirlenir. True olduğunda komisyon tutarı kredi kartından çekilecek tutara eklenir. |
| **currency** | string | Hayır | Para birimi. Sadece TL destekleniyor. |
| **period** | int | Hayır | Ödemenin hangi periyotta olacağını belirler. (Default:0), interval ve interval\_count ile birlikte kullanılır. Örn: 12 adetli aylık ödemeli düzenli ödeme talimatında periyod 2 girilirse; 2 ayda bir çekim yapılır ve toplam 24 ayda tamamlanır. |
| **user\_name** | string | Hayır | Düzenli ödeme talebini oluşturan kullanıcının adı |
| **agent\_note** | string | Hayır | Düzenli ödeme talebini oluşturan bayinin kendisine notu. Sadece bayi görür. |
| **confirmation\_webhook** | string | Hayır | Düzenli ödeme talebi son kullanıcı tarafından onaylanırsa , burada belirleyeceğiniz URL'e request gönderilir. |
| **suceed\_webhook** | string | Hayır | Düzenli ödeme onaylandıktan sonra karttan ödeme çekimleri başarılı olduğunda burada belirleyeceğiniz URL'e request gönderilir. |
| **error\_webhook** | string | Hayır | Düzenli ödeme onaylandıktan sonra karttan ödeme çekimleri hatalı olduğunda burada belirleyeceğiniz URL'E request gönderilir. |
| **confirmation\_redirect\_url** | string | Hayır | Düzenli ödeme talebi son kullanıcı tarafından onaylandığında redirect edilecek sayfanın URL'ini burada gönderilir. |
| **send\_mail** | bool | Hayır | Email gönderilsin mi? True ise düzenli ödeme talebi oluşturulduktan sonra son kullanıcının email adresine düzenli ödemeyi onaylaması için gerekli link mail olarak gönderilir. |
| **send\_sms** | bool | Hayır | Sms gönderilsin mi?True ise düzenli ödeme talebi oluşturulduktan sonra son kullanıcın telefonuna düzenli ödemeyi onaylaması için gerekli link sms olarak gönderilir. |
| **is\_fixed\_price** | bool | Hayır | Sabit tutar mı? True ise tüm ödemeler amount alanında belirtilen tutar kadar çekilir. False ise invoince\_create servisi ile her bir ödeme için çekilecek tutarı vade bilgisi ile göndermelisiniz. |
| **auto\_renew** | bool | Hayır | Düzenli ödeme emri bitince tekrarlansın mı? |
| **agent\_logo** | string | Hayır | Bayi logo linki |
| **attempt\_day\_count** | int | Hayır | Ödeme çekim deneme gün sayısı. Default 3 gündür. 3 gün boyunca tanımlı kartlardan ödeme çekilmeye çalışılır. 3 günün sonunda hala çekim yapılamaz ise sözleşmeyi durdurur. |
| **daily\_attempt\_count** | int | Hayır | Ödeme gün içerisinde çekim denemesi sayısı. Default 3 gündür. Gün içerisinde karttan en fazla 3 kez çekim denemesi yapılır. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| -------------------- | ------ | ------------------------------- |
| **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ı |
| **url** | string | Düzenli ödeme URL'i |
| **subscription\_id** | string | Düzenli ödeme ID |
| **status** | string | Düzenli ödeme durumu |
| {% endtab %} | | |
{% tab title="Request" %}
```javascript
{
"name_surname":"Ozan Manav",
"amount":2000,
"interval":2,
"interval_count":12,
"reference_no":"90000543",
"begin_date":"2017-08-14T16:44:49.9405776+03:00",
"end_user_email":"ozan.manav@arena.com.tr",
"end_user_gsm":"5452838997",
"agent_id":"48811",
"send_mail":false,
"send_sms":false,
"is_fixed_price":false,
"attempt_day_count":"5",
"suceed_webhook":"http://test.com/successpage",
"error_webhook":"http://test.com/errorpage",
"confirmation_webhook":"http://test.com/confirmationpage",
"end_user_desc":"90000543 numaralı üyelik"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"subscription_create",
"code":0,
"message":"Başarılı Islem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | /[v1/subscription/create](https://api.paynet.com.tr/v1/subscription/create) |
| {% endtab %} | |
| {% endtabs %} | |
# Düzenli Ödeme Durum Güncelleme
v1/subscription/status\_update
Bu servis ile aktif durumda olan bir düzenli ödeme emrini durdurabilir, durdurulmuş bir düzenli ödemeyi aktif duruma çekebilirsiniz.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------------- | ------ | ------- | -------------------------------------------------------------------------------------- |
| **subscription\_id** | string | Evet\* | Düzenli ödeme emri id |
| **reference\_no** | string | Evet\* | Düzenli ödeme emri referans numarası |
| **status** | int | Evet | Güncellenmek istenen durum. Bknz. [Status](/uornek/genel-bilgiler/veri-tipleri/status) |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------- |
| **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" %}
```
{
"reference_no":"90003272",
"status":3
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"subscription_status_update",
"code":0,
"message":"Başarılı işlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | [/v1/subscription/status\_update](https://api.paynet.com.tr/v1/subscription/status_update) |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
\*subcription\_id veya reference\_no'dan en az birini göndermeniz gerekmektedir.
{% endhint %}
# Düzenli Ödeme Faturalandırma
v1/subscription/create\_invoice
Eğer düzenli ödeme emri oluşturma servisinde “is\_fixed\_price” parametresini “false” gönderirseniz, kredi kartından çekilecek tutarı bu servis ile her defasında göndermelisiniz. Çekilecek tutarı göndermediğiniz durumda karttan belirtilen dönem için çekim yapılmaz. Bu yöntemi fatura ödemesi gibi değişken tutarlı ödemeleriniz için kullanabilirsiniz.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------------- | -------- | ------- | ----------------------------- |
| **val\_date** | datetime | Evet | Çekileceği tarih |
| **amount** | decimal | Evet | Çekilecek tutar |
| **subscription\_id** | string | Evet\* | Düzenli ödeme no |
| **reference\_no** | string | Evet\* | Müşteri referans no bilgisi |
| **agent\_amount** | decimal | Hayır | Bayiye aktarılacak tutar |
| **company\_amount** | decimal | Hayır | Ana firmaya aktarılacak tutar |
| **invoice\_no** | string | Hayır | Fatura no |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------- |
| **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" %}
```
{
"reference_no":"90000600",
"company_amount":25972,
"agent_amount":2926,
"amount":28898,
"currency":"TRY",
"val_date":"03.10.2017 10:32:24",
"invoice_no":"11400556"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"subscription_invoice",
"code":0,
"message":"Başarılı Islem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/subscription/create\\\_invoice](https://doc.paynet.com.tr/uornek/servisler/abonelik/https:/pts-api.paynet.com.tr\[/v1/subscription/create\\_invoice)]\() |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
\*subcription\_id veya reference\_no'dan en az birini göndermeniz gerekmektedir.
{% endhint %}
# Düzenli Ödeme Emri Tekrar Gönder
v1/subscription/send\_again
Düzenli ödeme emri oluştururken “send\_mail” ve “send\_sms“ parametreleri true gönderildiğinde, eğer müşteriye sms ve mail ulaşmadıysa, müşteriye sms ve mail’i tekrar göndermek için kullanılır.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tür | Zorunlu | Açıklama |
| -------------------- | ------ | ------- | ----------------- |
| **subscription\_id** | string | Evet\* | Düzenli ödeme ID |
| **reference\_no** | string | Evet\* | Referans numarası |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------- |
| **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" %}
```
{
"subscription_id": 68bdfa37-65cd-4481-b14a-90aa731ccf3b"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"subscription_send_again",
"code":0,
"message":"Başarılı Islem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | [/v1/subscription/send\_again](https://api.paynet.com.tr/v1/subscription/send_again) |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
\*subcription\_id veya reference\_no'dan en az birini göndermeniz gerekmektedir.
{% endhint %}
# Düzenli Ödeme Listesi
v1/subscription/list
Oluşturduğunuz düzenli ödemelerin listesini çekmek için bu servisi kullanabilirsiniz.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ------------------- | ------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **datab** | date | Evet | Başlangıç tarihi |
| **datbi** | date | Evet | Bitiş tarihi |
| **agent\_id** | string | Hayır | Bayi kodu |
| **limit** | int | Hayır | Bu değer kadar veri alınır. |
| **has\_more** | int | Hayır | True ise belirtilen kriterlerde gönderilen satırlardan daha olduğu anlamına gelir. |
| **ending\_before** | int | Hayır | Belirtilen index’den önceki limit sayısı kadar kayıt getirir. Eğer ending\_before 90 gönderildi, limit olarak 15 gönderildi. 75. İle 90. Kayıtları arasındaki kayıtları gönderir. |
| **starting\_after** | int | Hayır | Belirtilen index’den önceki limit sayısı kadar kayıt getirir. Eğer ending\_before 90 gönderildi, limit olarak 15 gönderildi. 75. İle 90. Kayıtları arasındaki kayıtları gönderir. \[Opsiyonel] İnteger değer. Belirtilen index’den sonraki limit sayısı kadar kayıt getirir. Eğer starting after 15 gönderildi, limit olarak 15 gönderildi. 15. İle 30. Kayıtları arasındaki kayıtları gönderir. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------- |
| **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ı |
| **data** | list | Düzenli ödeme listesini döner |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"datab":01.02 .2016,
"datbi":01.02 .2016
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"subscription_list",
"code":0,
"message":"Başarılı Islem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | -------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | [/v1/subscription/list](https://api.paynet.com.tr/v1/subscription/list) |
| {% endtab %} | |
| {% endtabs %} | |
# Kart Bilgisi Listesi
v1/subscription/card\_info\_list
Düzenli ödemeye ait müşterinin kayıt ettiği kartların listesini dönen servistir.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------------- | ------ | ------- | ----------------- |
| **subscription\_id** | string | Evet\* | Düzenli Ödeme ID |
| **reference\_no** | string | Evet\* | Referans numarası |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| --------------------------- | ------ | --------------------------------------------- |
| **subscription\_id** | string | Düzenli Ödeme ID sini döndürür. |
| **reference\_no** | string | Referans numarasını döndürür. |
| **Data\[]** | dizi | |
| -> card\_id | string | Kartın id'si |
| -> card\_no\_mask | string | Kart numarasının ilk 6 son 4 tokenlanmış hali |
| -> card\_holder\_name\_mask | string | Kart sahibinin isim bilgisi |
| -> is\_default | bool | |
| **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="Response" %}
```
{
"subscription_id": 902c48d-fa22-4f35-aec7-0b448fb6bf4b
}
```
{% endtab %}
{% tab title="Request" %}
```
{
"subscription_id": "2c13ed3f-4919-49bd-85b1-0f7183ccceda",
"reference_no": "90000350",
"Data": [
{
"card_id": 1808,
"card_no_mask": "424242********4242",
"card_holder_name_mask": "AGİT",
"order_no": 1,
"is_default": true
},
{
"card_id": 1806,
"card_no_mask": "424242********4242",
"card_holder_name_mask": "AGİT",
"order_no": 2,
"is_default": false
},
{
"card_id": 1801,
"card_no_mask": "435508********4358",
"card_holder_name_mask": "ER***********UT",
"order_no": 3,
"is_default": false
},
{
"card_id": 1799,
"card_no_mask": "424242********4242",
"card_holder_name_mask": "AGİT",
"order_no": 4,
"is_default": false
}
],
"object_name": "subscription_card_list",
"code": 0,
"message": "Başarılı işlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Canlı Sistem | |
| Test Sistemi | [ https://pts-api.paynet.com.tr](< https://pts-api.paynet.com.tr>)[/v1/subscription/card\_info\_list](https://api.paynet.com.tr/v1/subscription/card_info_list) |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
\*subcription\_id veya reference\_no'dan en az birini göndermeniz gerekmektedir.
{% endhint %}
# Fatura Durum Güncelleme
v1/subscription/invoice\_status\_update
Yapılacak ödeme kayıtlarının durumlarını değiştiren servistir.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| --------------- | ------ | ------- | --------------------------------------------------------------- |
| **invoice\_id** | string | Evet\* | Fatura ID |
| **invoice\_no** | string | Evet\* | Fatura numarası |
| **status** | int | Evet | Durum.Bknz.[Status](/uornek/genel-bilgiler/veri-tipleri/status) |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------- |
| **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" %}
```
{
"invoice_id":"",
"invoice_no":"11400505",
"status":4
}
```
{% endtab %}
{% tab title="Response" %}
```
"object_name":"subscription_invoice_status_update",
"code":0,
"message":"Başarılı Islem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/subscription/invoice\\\_status\\\_update](https://doc.paynet.com.tr/uornek/servisler/abonelik/https:/pts-api.paynet.com.tr\[/v1/subscription/invoice\\_status\\_update)]\() |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
\*invoice\_id veya invoice\_no'dan en az birini göndermeniz gerekmektedir.
{% endhint %}
# Toplu Fatura Durum Güncelleme
v1/subscription/invoices\_status\_update\_all
Bir düzenli ödemeye ait tüm ödeme kayıtlarının durumlarını değiştiren servis. invoice\_status\_update içerisindeki kuralların aynısı kayıt başına burada da uygulanır.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------------- | ------ | ------- | ----------------------------------------------------------------- |
| **subscription\_id** | string | Evet\* | Düzenli ödeme emri ID |
| **reference\_no** | string | Evet\* | Düzenli ödeme referans numarası |
| **status** | int | Evet | Durum. Bknz. [Status](/uornek/genel-bilgiler/veri-tipleri/status) |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------- |
| **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" %}
```
{
"subscription_id": 68bdfa37-65cd-4481-b14a-90aa731ccf3b,
"status":4
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"subscription_invoices_status_update_all",
"code":0,
"message":"Başarılı Islem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Canlı Sistem | |
| Test Sistemi | [https://pts-api.paynet.com.tr\[/v1/subscription/invoices\\\_status\\\_update\\\_all](https://doc.paynet.com.tr/uornek/servisler/abonelik/https:/pts-api.paynet.com.tr\[/v1/subscription/invoices\\_status\\_update\\_all)]\() |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
\*subcription\_id veya reference\_no'dan en az birini göndermeniz gerekmektedir.
{% endhint %}
# Kart Bilgisi Silme
v1/subscription/card\_info\_delete
Düzenli ödemeye ait müşterinin kayıt ettiği kartlardan silme yapmak için kullanılan servistir. Kayıtlı bir kart var ise silmesine izin vermez.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------------- | ------ | ------- | ---------------------- |
| **card\_id** | string | Evet | Kartın id'si |
| **subscription\_id** | string | Evet\* | Düzenli ödeme ID |
| **reference\_no** | string | Evet\* | Düzenli ödeme numarası |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------- |
| **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ı |
| **card\_id** | string | Silinecek kart id'si |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"card_id":1800,
"subscription_id":"",
"reference_no":"90000350"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"card_id": 1800,
"object_name": "subscription_card_info_delete",
"code": 0,
"message": "Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/subscription/card\\\_info\\\_delete](https://doc.paynet.com.tr/uornek/servisler/abonelik/https:/pts-api.paynet.com.tr\[/v1/subscription/card\\_info\\_delete)]\() |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
\*subcription\_id veya reference\_no'dan en az birini göndermeniz gerekmektedir.
{% endhint %}
# Düzenli Ödeme Detayı
v1/subscription/subscription\_detail
Düzenli ödeme emri ile ilgili detay bilgileri dönen servistir.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------------- | ------ | ------- | --------------- |
| **subscription\_id** | string | Evet\* | Fatura ID |
| **reference\_no** | string | Evet\* | Fatura numarası |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **name\_surname** | string | Evet | İsim ve soyisim bilgisi |
| **amount** | decimal | Evet | Düzenli ödeme tutarı |
| **interval** | int | Evet | Ödeme Periyodu ( 0: Günlük, 1: Haftalık, 2: Aylık, 3: Yıllık ) |
| **interval\_count** | int | Evet | Toplam kaç adet çekim yapılacak. interval aylık (2) ise interval\_count 12 ise bir yıl boyunca her ay çekim yapar. Eğer period değeri 2 gönderilirse 2 ayda bir toplam 12 çekim yapılır yani 24 ayda düzenli ödeme tamamlanır. |
| **begin\_date** | datetime | Evet | Düzenli ödeme başlangıç tarihi |
| **reference\_no** | string | Evet | Referans no bilgisi |
| **end\_user\_email** | string | Evet | Son kullanıcı email bilgisi |
| **end\_user\_gsm** | string | Evet | Son kullanıcı gsm bilgisi. |
| **agent\_id** | string | Hayır | Paynet bayi kodu |
| **agent\_amount** | decimal | Evet | Ödeme çekildikten sonra burada belirtilen tutar bayi hesabına aktarılır. Tutar belirtilmezse default ayarlar geçerlidir. |
| **company\_amount** | decimal | Evet | Ödeme çekildikten sonra burada belirtilen tutar Ana Firma hesabına aktarılır. Tutar belirtilmezse default ayarlar geçerlidir. |
| **end\_user\_desc** | string | Evet | Son kullanıcıya gösterilecek açıklama. “xxx aidatınız için düzenli ödeme onayı istiyoruz” gibi. |
| **addcomission\_to\_amount** | decimal | Hayır | true/false, Default: false. Komisyon tutarının ödeme tutarına eklenip eklenmeyeceği belirlenir. True olduğunda komisyon tutarı kredi kartından çekilecek tutara eklenir. |
| **currency** | string | Hayır | Para birimi. Sadece TL destekleniyor. |
| **period** | string | Hayır | Ödemenin hangi periyotta olacağını belirler (Default 0), interval ve interval\_count ile birlikte kullanılıyor. Örn: 12 adetli Aylık ödemeli düzenli ödeme talimatında periyod 2 girilirse 2 ayda bir çekim yapılır ve toplam 24 ayda tamamlanır. |
| **user\_name** | string | Hayır | Düzenli ödeme talebini oluşturan kullanıcının adı. |
| **agent\_note** | string | Hayır | Düzenli ödeme talebini oluşturan bayinin kendisine notu. Sadece bayi görür. |
| **confirmation\_webhook** | string | Hayır | Düzenli ödeme talebi son kullanıcı tarafından onaylanırsa, burada belirleyeceğiniz URL'e request gönderilir. |
| **suceed\_webhook** | string | Hayır | Düzenli ödeme onaylandıktan sonra karttan ödeme çekimleri başarılı olduğunda burada belirleyeceğiniz URL'e request gönderilir. |
| **error\_webhook** | string | Hayır | Düzenli ödeme onaylandıktan sonra karttan ödeme çekimleri hatalı olduğunda burada belirleyeceğiniz URL'e request gönderilir. |
| **confirmation\_redirect\_url** | string | Hayır | Düzenli ödeme talebi son kullanıcı tarafından onaylandığında redirect edilecek sayfanın URL'ini burada gönderilir. |
| **send\_mail** | bool | Hayır | Email gönderilsin mi? true ise düzenli ödeme talebi oluşturulduktan sonra son kullanıcının email adresine düzenli ödemeyi onaylaması için gerekli link mail olarak gönderilir. |
| **send\_sms** | bool | Hayır | Sms gönderilsin mi? true ise düzenli ödeme talebi oluşturulduktan sonra son kullanıcının telefonuna düzenli ödemeyi onaylaması için gerekli link sms olarak gönderilir. |
| **is\_fixed\_price** | bool | Hayır | Sabit Tutar mı ? true ise tüm ödemeler amount alanında belirtilen tutar kadar çekilir. false ise invoice\_create servisi ile her bir ödeme için çekilecek tutarı vade bilgisi ile göndermelisiniz. |
| **auto\_renew** | bool | Hayır | Düzenli ödeme emri bitince tekrarlansın mı ? |
| **agent\_logo** | bool | Hayır | Bayi logo linki |
| **attempt\_day\_count** | int | Hayır | Ödeme çekim deneme gün sayısı. Default 3 gündür. 3 gün boyunca tanımlı kartlardan ödeme çekilmeye çalışılır. 3. günün sonunda hala çekim yapılamaz ise sözleşmeyi durdurur. |
| **daily\_attempt\_count** | int | Hayır | Ödeme gün içerisinde çekim denemesi sayısı. Default 3'tür. Gün içerisinde karttan en fazla 3 kere çekim denemesi yapılır. |
| {% endtab %} | | | |
{% tab title="Request" %}
```
{
"subscription_id": 902c48d-fa22-4f35-aec7-0b448fb6bf4b
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"Data": {
"subscription_id": "2902c48d-fa22-4f35-aec7-0b448fb6bf4b",
"company_code": "1000",
"agent_id": "52957",
"user_name": null,
"name_surname": "ozan manav",
"end_user_email": "ozan.manav@arena.com.tr",
"end_user_gsm": "00000000000",
"agent_logo": "",
"amount": "20,00",
"agent_amount": "0,00",
"company_amount": "0,00",
"currency": null,
"reference_no": "90000566",
"agent_note": "",
"end_user_desc": "90000566 numaralı Abonelik",
"add_comission_to_amount": false,
"interval": 2,
"interval_count": 12,
"period": 0,
"begin_date": "24.8.2017 14:52:57",
"is_fixed_price": false,
"auto_renew": false,
"confirmation_webhook": "http://test.com//Webhook/RecPayProComfirmed",
"suceed_webhook": "http://test.com//Webhook/RecPayProSucceed",
"error_webhook": "http://test.com//Webhook/RecPayProError",
"confirmation_redirect_url": "",
"status": 1,
"send_mail": false,
"send_sms": false,
"sms_verification_code": "ACRQDS24"
},
"object_name": null,
"code": 0,
"message": null
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/subscription/subscription\\\_detail](https://doc.paynet.com.tr/uornek/servisler/abonelik/https:/pts-api.paynet.com.tr\[/v1/subscription/subscription\\_detail)]\() |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
\*subcription\_id veya reference\_no'dan en az birini göndermeniz gerekmektedir.
{% endhint %}
# Kart Bilgisi Sıra Düzenleme
v1/subscription/card\_info\_arrange
Düzenli ödemeye ait müşterinin kayıt ettiği kartlardan silme yapmak için kullanılan servistir. Kayıtlı bir kart var ise silmesine izin vermez.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ------------------------- | ------ | ------- | ------------------------ |
| **subscription\_id** | string | Evet\* | Düzenli ödeme id'si |
| **reference\_no** | string | Evet\* | Düzenli ödeme numarası |
| **card\_information\[]** | dizi | | |
| -> subscription\_card\_id | string | Evet | Düzenli ödeme kart id'si |
| -> card\_id | int | Evet | Kartın id'si |
| -> order\_no | string | Evet | Sipariş numarası |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------- |
| **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" %}
```
{
"subscription_id": "2c13ed3f-4919-49bd-85b1-0f7183ccceda",
"reference_no": "",
"card_information": [
{
"subscription_card_id": 0,
"card_id": 1808,
"order_no": 1
},
{
"subscription_card_id": 0,
"card_id": 1806,
"order_no": 2
},
{
"subscription_card_id": 0,
"card_id": 1801,
"order_no": 3
},
{
"subscription_card_id": 0,
"card_id": 1799,
"order_no": 4
},
{
"subscription_card_id": 0,
"card_id": 1800,
"order_no": 5
},
{
"subscription_card_id": 0,
"card_id": 1800,
"order_no": 6
}
]
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name": "subscription_card_info_arrange",
"code": 0,
"message": "Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/subscription/card\\\_info\\\_arrange](https://doc.paynet.com.tr/uornek/servisler/abonelik/https:/pts-api.paynet.com.tr\[/v1/subscription/card\\_info\\_arrange)]\() |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
\*subcription\_id veya reference\_no'dan en az birini göndermeniz gerekmektedir.
{% endhint %}
# Fatura Listesi
v1/subscription/invoice\_list
Bir düzenli ödemeye ait ödeme kayıtlarının listesini girilen parametrelere göre dönen servistir.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------------- | ------ | ------- | ---------------------- |
| **agent\_id** | string | Hayır | Bayi Kodu |
| **limit** | int | Hayır | Limit bilgisi |
| **invoice\_status** | string | Hayır | Fatura Durumu |
| **subscription\_id** | string | Evet\* | Düzenli Ödeme ID |
| **reference\_no** | string | Evet\* | Düzenli Ödeme numarası |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ------------------------------------ | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **total** | int | Toplam satır sayısı |
| **total\_count** | int | Toplam gösterilen satır sayısı |
| **limit** | int | Döndürülecek veri sayısı. Default 10 kayıt döner. |
| **ending\_before** | int | Belirtilen index’den önceki limit sayısı kadar kayıt getirir. Eğer ending\_before 90 gönderildi, limit olarak 15 gönderildi. 75. İle 90. Kayıtları arasındaki kayıtları gönderir. |
| **starting\_after** | int | Belirtilen index’den sonraki limit sayısı kadar kayıt getirir. Eğer starting after 15 gönderildi, limit olarak 15 gönderildi. 15. İle 30. Kayıtları arasındaki kayıtları gönderir. |
| **has\_more** | bool | True ise Belirtilen kriterlerde gönderilen satırlardan daha olduğu anlamına gelir. |
| **Data\[]** | | |
| ->
subscription\_id
| string | Düzenli ödeme no |
| -> subscription\_attempt\_day\_count | | |
| -> invoice\_id | | |
| -> invoice\_no | | Düzenli ödeme fatura numarası |
| -> invoice\_val\_date | | |
| -> invoice\_amount | | |
| -> invoice\_agent\_amount | | |
| -> invoice\_company\_amount | | |
| -> invoice\_attempt\_count | | |
| -> invoice\_status | | |
| -> invoice\_succeed\_xact\_id | | |
| -> invoice\_sms\_posted | | |
| -> invoice\_email\_posted | | |
| -> invoice\_status\_desc | | |
| **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" %}
```
{
"agent_id":"48811",
"limit":1000,
"invoice_status":0,
"reference_no":""
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"total": 3,
"total_count": 0,
"limit": 1000,
"ending_before": 0,
"starting_after": 0,
"has_more": false,
"Data": [
{
"subscription_id": "184d7591-51c1-45c8-bdd5-6e65c9b1f828",
"subscription_attempt_day_count": 5,
"invoice_id": 5617,
"invoice_no": "11400551",
"invoice_val_date": "2017-09-29T11:11:16",
"invoice_amount": 55.08,
"invoice_agent_amount": 4.49,
"invoice_company_amount": 50.59,
"invoice_attempt_count": 0,
"invoice_status": 0,
"invoice_succeed_xact_id": -1,
"invoice_sms_posted": false,
"invoice_email_posted": false,
"invoice_status_desc": "Bekleniyor"
},
{
"subscription_id": "184d7591-51c1-45c8-bdd5-6e65c9b1f828",
"subscription_attempt_day_count": 5,
"invoice_id": 5618,
"invoice_no": "11400552",
"invoice_val_date": "2017-09-29T11:14:11",
"invoice_amount": 55.08,
"invoice_agent_amount": 4.49,
"invoice_company_amount": 50.59,
"invoice_attempt_count": 0,
"invoice_status": 0,
"invoice_succeed_xact_id": -1,
"invoice_sms_posted": false,
"invoice_email_posted": false,
"invoice_status_desc": "Bekleniyor"
},
{
"subscription_id": "184d7591-51c1-45c8-bdd5-6e65c9b1f828",
"subscription_attempt_day_count": 5,
"invoice_id": 5622,
"invoice_no": "11400555",
"invoice_val_date": "2017-10-02T12:10:59",
"invoice_amount": 21.67,
"invoice_agent_amount": 2.58,
"invoice_company_amount": 19.09,
"invoice_attempt_count": 0,
"invoice_status": 0,
"invoice_succeed_xact_id": -1,
"invoice_sms_posted": false,
"invoice_email_posted": false,
"invoice_status_desc": "Bekleniyor"
}
],
"object_name": "subscription_invoice_list",
"code": 0,
"message": null
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Canlı Sistem** | |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/subscription/invoice\\\_list](https://doc.paynet.com.tr/uornek/servisler/abonelik/https:/pts-api.paynet.com.tr\[/v1/subscription/invoice\\_list)]\() |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
\*subcription\_id veya reference\_no'dan en az birini göndermeniz gerekmektedir.
{% endhint %}
# Fatura Ödeme Girişimi Listesi
v1/subscription/invoice\_attempt\_list
Düzenli ödeme emrinde ödeme kaydı üzerinden yapılan kredi kartı çekimlerinin ve ya çekim denemelerinin listesini dönen servistir.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| --------------- | ------ | ------- | --------- |
| **invoice\_id** | string | Evet | Fatura ID |
| **invoice\_no** | string | Evet | Fatura no |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------- |
| **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" %}
```
{
"invoice_id":120,
"invoice_no":12
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"subcription_invoice_attempt_list",
"code":0,
"message":"Başarılı Islem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/subscription/invoice\\\_attempt\\\_list](https://doc.paynet.com.tr/uornek/servisler/abonelik/https:/pts-api.paynet.com.tr\[/v1/subscription/invoice\\_attempt\\_list)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# Manuel Çekim
v1/subscription/manual\_charge
Düzenli ödeme de kayıtlı kartlardan çekim işlemini manuel tetiklemek için kullanılır.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------------- | ------ | ------- | ---------------------- |
| **subscription\_id** | string | Evet\* | Düzenli ödeme id |
| **reference\_no** | string | Evet\* | Düzenli ödeme numarası |
| **invoice\_no** | int | | Fatura numarası |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------- |
| data\[] | dizi | |
| -> 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ı |
| **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" %}
```
{
"subscription_id":"",
"reference_no":"90000573",
"invoice_no":"11400528"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"data":[
{
"object_name":null,
"code":1,
"message":"11400528 numarali siparis için 1 saat 57 dakika sonra deneme yapabilirsiniz"
}
],
"object_name":null,
"code":1,
"message":null
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/subscription/manual\\\_charge](https://doc.paynet.com.tr/uornek/servisler/abonelik/https:/pts-api.paynet.com.tr\[/v1/subscription/manual\\_charge)]\() |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
\*subcription\_id veya reference\_no'dan en az birini göndermeniz gerekmektedir.
{% endhint %}
# Cari Hesap
Bayiler kur servisi sayesinde Paynet üzerinden istedikleri kur üzerinden işlem yapabilmelerine ve cari hesapları hakkında bilgi almalarına olanak sağlayan yapıdır.
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ----------------- | ------ | ------- | ------------------------- |
| **company\_code** | string | | Paynet ana firma kodu |
| **agent\_id** | string | | Paynet bayi kodu |
| **reference\_no** | string | | Bayinin referans numarası |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
| **date** | datetime | İşlem zamanı bilgisi |
| **company\_code** | string | Paynet ana firma kodu |
| **agent\_id** | string | Paynet bayi kodu |
| **reference\_no** | string | Referans numarası |
| **first\_column\_title** | string | 100 ile çarpılmış şekilde string formatta setlenmeli |
| **second\_column\_title** | string | 100 ile çarpılmış şekilde string formatta setlenmeli |
| **note** | string | Açıklama |
| **Para Birimleri\[]** | | TRY,USD,EUR |
| **->kur** | string |
O anki TRY cinsinden hesaplanmış kur bilgisi. Fakat bunu 100 ile çarpılmış şekilde string formatta setlenmeli. |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"agent_id":"53983",
"company_code":"1000",
"reference_no":"12471"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"date":"2018-10-12 08:53:00",
"company_code":"1000",
"agent_id":"52000",
"reference_no":"12471",
"first_column_title":" Bakiye",
"second_column_title":" V.D. Borç",
"note":" Ödemeleriniz Pazartesi günü aktarılır. *V.D: Vadesi Dolan"
"ParaBirimleri":[
{
“is_default” : true,
"para_birimi":"USD",
"kur":"6.954"
},
{
“is_default” : false,
"para_birimi":"EUR",
"kur":"6.954"
},
{
“is_default” : false,
"para_birimi":"TRY",
"kur":"1"
}
],
"Bakiye":[
{
"para_birimi":"USD",
"first_column_value":"34546.95",
"second_column_value":"34546.95"
},
{
"para_birimi":"EUR",
"first_column_value":"0",
"second_column_value":"34546.95"
},
{
"para_birimi":"TL",
"first_column_value":"-56.000",
"second_column_value":"34546.95"
}
]
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
**Dikkat edilmesi gereken hususlar:**
1. Response değerindeki tüm tutar bilgileri 100 ile çarpılmış şekilde ve string formatında olmalı.
2. Başarısız olunan durumlarda Http status code 200 dışında herhangi bir parameter kodu ile dönülmeli( 500 gibi ).
3. Servis istekleri maximum 10 saniyede data dönmeli.
{% endhint %}
# Kart Saklama
Bu servisi kullanarak kart saklama işlemi yapabilirsiniz.
{% hint style="info" %}
Bu servisi kullanmadan önce Authentication yaptığınızdan emin olunuz.
{% endhint %}
# 1.Ödeme Sırasında Kart Saklama
# 1.1.Authenticate Servis
v1/paynetj/auth
Bu servis ödeme işlemini başlatan bir session oluşturur. Bu sessionin belirli bir süre içerisinde tamamlanması gerekir. Bu servis ile kredi kartından çekilecek tutarı, komisyon hesaplama yöntemi gibi parametreleri gönderebilirsiniz. Ana firma ile ilgili bazı bilgilerde bu servisden döner. Servis başarılı ise http 200 döner, hata durumunda http 200 dışındaki kodlar döner. Eğer ödeme ile birlikte ödemesi alınan kart numarasını Paynet sistemlerine güvenli olarak kaydetmek istiyorsanız **save\_card** parametresini auth servisinde **true** yollayabilirsiniz. Kart saklama işlemini daha sonra da “Save Card Service (1.3 v1/paynetj/save\_card )” ile tetikleyebilirsiniz.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ----------------------- | ------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **amount** | decimal | Evet | Ödeme tutarının yüz ile çarpılmış hali. “10.00 TL” => “1000” olarak gönderilmeli. |
| **agent\_id** | string | Hayır | Bayi kodu: varsa işlemi yapan bayi kodu, paynet sistemindeki bayi kodu ya da firma sistemindeki cari kodu. |
| **pos\_type** | string | Hayır | Paynet POS’larından işlem yapmak istiyorsanız, boş göndermelisiniz. Firma kendi pos’undan işlem yapmak istiyorsa pos\_type:”1” olarak göndermelidir. |
| **add\_commission** | bool | Hayır | True ise komisyon tutarı kredi kartından çekilecek tutara eklenir. False ise eklenmez. Default: False’dur. |
| **reference\_no** | string | Hayır | İşleme verilen bir referans numarası. |
| **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. |
| **domain** | string | Evet | Mobil uygulamalarda işlem bir domain üzerinden olmadığından bu alanla uygulamanın ismini gönderebilirsiniz. |
| **return\_url** | string | Hayır | 3D’li işlemlerde 3D doğrulaması sonucu return\_url adresine session\_id ve token\_id parmetreleri ile birlikte redirect yapılır. return\_url parametresi verilmediği takdirde form tag’i arasına hidden input olarak session\_id ve token\_id değerleri post edilmiş olur. |
| **save\_card** | bool | Hayır | Ödeme ile birlikte kredi kart numarasınında saklanması isteniyor ise save\_card parametresi true yollayabilirsiniz. |
| **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. İlk kart saklama tamamlandıktan sonra Paynet tarafından bu kullanıcıya benzersiz bir değer atanır (Kredi kartından ödemenin alınması ( charge ) servisinden dönen card\_owner\_id değeri ). Bu değeri kendi sisteminizde kullanıcınız ile ilişkilendirerek saklamalısınız. Daha sonra bu kullanıcıya yapılan kart saklama işlemlerinde user\_unique\_id yerine Paynet tarafından verilen save\_card\_oid değişkenini kullanmalısınız. |
| **car\_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 bilgisi. Bir sonraki kart saklama ve karttan ödeme alma işlemlerinde servisleri bu değer kullanılır. |
| **save\_card\_gsm\_no** | string | Hayır | Auth işleminde save\_card değeri true ise ve kart saklama işleminde OTP kontrolu zorunlu ise bu parametreye OTP doğrulama kodunun gönderilmesi gereken telefon numarası girilmelidir. OTP zorunlu değil ise zorunlu değildir. OTP kullanma zorunluluğu Paynet ve Müşteri tarafından birlikte belirlenir. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ----------------- | ------ | ------------------------------------------------------------------------- |
| **session\_id** | string | Başlatılan session’ın numarası. Diğer servislerde bu değişken kullanılır. |
| **name** | string | Ana firmanın adı |
| **tds\_required** | bool | 3D Secure işleminin zorunlu olup olmadığı, true ise zorunludur. |
| **expire\_date** | string | Session'ın sona erme süresi |
| **object\_name** | string | Dönen nesnenin ismi |
| **code** | string | Sonuç kodu 0 ise başarılıdır. |
| **message** | string | Sonuç mesajı |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
amount: "1037",
agent_id: "12471",
pos_type: 5,
add_commission: false,
save_card : true:,
user_unique_id:’DCFC03FA-F053-41BD-9DCA-E3178C84FB22’,
card_owner_id:’d16eaa18-f00d-492d-868a-856412b7577d’,
save_card_gsm_no:’5xxxxxxxxxx’
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"session_id": "js_EAAAAHAql+krG7NbfmRg8N67QSm18/XMgCNNGM2rsM/3zt7t",
"name": "ARENA BİLGİSAYAR SAN.TİC.A.Ş.",
"tds_required": false,
"expira_date": "2015-06-11T11:52:05.7659006+03:00",
"obeject_Name": "paynetj_auth",
"code": 0,
"message": "Başarılı Islem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Canlı Sistem | [https://api.paynet.com.tr\[/v1/paynetj/auth](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/1.oedeme-sirasinda-kart-saklama/https:/api.paynet.com.tr\[/v1/paynetj/auth)]\() |
| Test Sistemi | [https://pts-api.paynet.com.tr\[/v1/paynetj/auth](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/1.oedeme-sirasinda-kart-saklama/https:/pts-api.paynet.com.tr\[/v1/paynetj/auth)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# 1.2.BIN Kontrol Servisi
v1/paynetj/check\_bin
Bu servis girilen BIN numarasına göre sistemde tanımlı banka bilgilerini ve oran bilgilerini döner. Buradan kullanıcının seçeceği taksit seçeneğine ait **“instalment\_key”** değerini bir sonraki adım olan **create\_token** servisinde kullanmalısınız.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| --------------- | ------ | ------- | ------------------------------------------------------------------------------------- |
| **session\_id** | string | Evet | Auth servisiyle ilgili alınan session bilgisi. |
| **bin** | string | Evet | Girilen kredi kartı bilgisinin ilk 8 karakteri. 8 karakter sonrası gönderilmemelidir. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ------------------------- | ------ | --------------------------------------------------------- |
| **bank\_id** | string | Bankanın paynet sistemindeki kodu. |
| **bank\_logo** | string | Bankanın logosunun alınacağı url. |
| **bank\_name** | string | Bankanın adı |
| **card\_type** | string | Kart türü: cc :Bireysel, bc:Ticari, dc:Debit |
| **tds\_enable** | bool | Seçilen banka ile 3D’li işlem yapılabilir mi yi belirtir. |
| **data** | dizi | Oran tablosu dizisi. |
| **-> instalment\_key** | string | Oran anahtarı, bu anahtar daha sonra kullanılacak |
| **-> instalment** | string | Taksit sayısı |
| **-> instalment\_amount** | string | Taksit tutarı |
| **-> total\_amount** | string | Kredi kartından çekilecek tutar |
| **-> commision** | string | Komisyon tutarı |
| **-> desc** | string | Ödeme planı, arayüzde gösterilecek değer |
| **object\_name** | string | Dönen cevabın nesne adı |
| **code** | string | İşlemin cevap kodu 0 ise işlem başarılıdır. |
| **message** | string | İşlemin cevap koduna göre mesaj barındırır. |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
session_id: "js_EAAAAMb2/RMGqozzIWMQWUTL5pJrdQvi/aD5qZ4A1LaDfo8g",
bin: "43550843"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"bank_id": "AXSS",
"bank_logo": "http://localhost:64102/img/banklogo/small/AXSS.png",
"bank_name": "Axess",
"card_type": "cc",
"tds_enable": true,
"data": [
{
"instalment_key": "ji_EAAAAGINo4rz8dJGeBoy+ItEftZ4QS0qS5xn44NfXj30wd/ZRwL7ZQs9OAKZy5xGY5EaaA==",
"instalment": 101,
"instalment_amount": 0.10,
"total_amount": 10.30,
"commision": 0.26,
"desc": "101 Taksit 101 x 0,10 = 10,30 TL"
},
{
"instalment_key": "ji_EAAAAPTScfWKuCRfoG7q82ibmozBZHJN8LYZseR0djrTRSsu",
"instalment": 0,
"instalment_amount": 10.24,
"total_amount": 10.24,
"commision": 0.20,
"desc": "0 Taksit 0 x 10,24 = 10,24 TL"
},
{
"instalment_key": "ji_EAAAAN4Aw1tKUlglnCrBgQr+m0maUBwR0ScCTbFXTJeEqGif",
"instalment": 3,
"instalment_amount": 3.46,
"total_amount": 10.37,
"commision": 0.31,
"desc": "3 Taksit 3 x 3,46 = 10,37 TL"
},
{
"instalment_key": "ji_EAAAAOT0wNkTexwQ9hDXhP6QIAdWja3VkAQalefn2jW3Ouyj",
"instalment": 6,
"instalment_amount": 1.73,
"total_amount": 10.37,
"commision": 0.31,
"desc": "6 Taksit 6 x 1,73 = 10,37 TL"
}
],
"obeject_name": "paynetj_bin",
"code": 0,
"message": "Başarılı Islem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/paynetj/check\\\_bin](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/1.oedeme-sirasinda-kart-saklama/https:/api.paynet.com.tr\[/v1/paynetj/check\\_bin)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/paynetj/check\\\_bin](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/1.oedeme-sirasinda-kart-saklama/https:/pts-api.paynet.com.tr\[/v1/paynetj/check\\_bin)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# 1.3.Kart Kaydetme Servisi
v1/paynetj/save\_card
Ödeme esnasında kartı Paynet sistemlerine kaydetmek istiyorsanız ve Auth servisinde belirlenmiş parametreler gönderilmemiş ise bu servisi kullanabilirsiniz. Kart açıklamasını gönderirseniz gönderdiğiniz açıklama ile işlem yapılır. göndermeseniz Paynet’in ekranında karta isim verebilirmek için alan çıkar.
{% hint style="success" %}
[https://api.paynet.com.tr/v1/paynetj/save\_card](https://api.paynet.com.tr/v1/paynetj/savecard)
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| --------------- | ------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **session\_id** | string | Evet | Auth servisiyle ilgili alınan session bilgisi |
| **card\_desc** | string | Hayır | Eğer kart açıklaması gönderilmez ise Paynet'in ekranı açıklama alır. Paynet kart saklama üyelik sözl. Vs ve okudum anladım çıkar. |
| **user\_gsm** | string | Hayır | 5XXXXXXXXX formatında kart sahibinin gsm nosu. OTP zorunlu ise zorunlu olacak. OTP zorunlu ve auth servisinde göndermediyseniz bu servisde göndermek zorunlu. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------------------- |
| **session\_id** | string | Auth ile başlatılan session |
| **object\_name** | string | Dönen cevabın nesne adı |
| **code** | string | İşlemin cevap kodu 0 ise işlem başarılıdır. |
| **message** | string | İşlemin cevap koduna göre mesaj barındırır. |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
session_id:"js_EAAAAMb2/RMGqozzIWMQWUTL5pJrdQvi/aD5qZ4A1LaDfo8g",
card_desc:"onur ozdemir"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"session_id": "js_EAAAALCbsO8tRNkc4NjA8tU2*2eDZfKhh6fSHHpGzKrc7T6q",
"code": 0,
"message": "Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/paynetj/save\\\_card](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/1.oedeme-sirasinda-kart-saklama/https:/api.paynet.com.tr\[/v1/paynetj/save\\_card)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/paynetj/save\\\_card](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/1.oedeme-sirasinda-kart-saklama/https:/pts-api.paynet.com.tr\[/v1/paynetj/save\\_card)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# 1.4.Kart Bilgilerini Yollama
v1/paynetj/create\_token
Bu servis ile girilen kart bilgisi ve seçilen taksit api’ye gönderilir. Karşılığında 3D’siz işlemlerde kullanmak için bir token değeri döner bu token değeri ile server side’da charge servisi ile onay verilir. **3D’li işlemlerde;** token değeri ile beraber 3D’li işlemi başlatmak için token\_id değerinin post edileceği adres post\_url parametresi ile döner. Bu adrese token\_id ile beraber session\_id ve size verilen publishable\_key değerlerini http post ya da http get methodları ile göndererek post\_url sayfasını uygulama üzerinde browserda açmalısınız. Bu sayede bankaların 3D doğrulama sayfasına yönlendirilmiş olursunuz. 3D doğrulama sonucunda, doğrulama işleminin sona erdiğini browser’ın tekrardan paynet.com.tr domainine redirect edildiğinde anlayabilirsiniz. Paynet.com.tr domainine redirect edildiğinde, uygulama içersinde açılan browser’ı kapatıp, charge servisine geçebilirsiniz, işlemin başarılı ya da başarısız olduğunu bu servisi ile anlayabilirsiniz. Bu adım ile sadece 3D doğrulaması yapılmış olur, kredi kartından tutar tahsil edilmez. Kredi kartından tutarın tahsil edilmesi için charge servisi başarılı şekilde çağrılmalıdır.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ----------------------- | ------ | ------- | --------------------------------------------- |
| **session\_id** | string | Evet | Auth servisiyle ilgili alınan session bilgisi |
| **card\_holder** | string | Evet | Kart sahibi |
| **pan** | string | Evet | Kredi kartı no |
| **month** | int | Evet | Kart son kullanım tarihi ay |
| **year** | int | Evet | Kart son kullanım tarihi yıl |
| **cvc** | string | Evet | Kart güvenlik kodu |
| **instalment\_key** | string | Evet | Seçilen oranın key’i. |
| **do\_3ds** | bool | Evet | 3D’li işlem ise true |
| **ip** | string | Evet | İşlemi yapan client’in ip'si |
| **client\_id** | string | | Client’a atılan benzersiz bir token değeri |
| **description** | string | | Açıklama |
| **card\_holder\_phone** | string | | Kart sahibi telefon numarası |
| **card\_holder\_mail** | string | | Kart sahibi email numarası |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | --------------------------------------------------------------------------------------------------------------------- |
| **token\_id** | string | Kredi kartı işlemini tamamlamak için kullanılacak token değeri |
| **post\_url** | string | Kart saklamalı işlemlerinde publishable\_key, token\_id ve session\_id parametrelerinin post edileceği url |
| **is\_tds** | string | İşlemin 3D’li mi 3D’siz mi olduğunu gösterir |
| **object\_name** | string | Dönen cevabın nesne adı |
| **code** | string | İşlemin cevap kodu 0 ise işlem başarılıdır. Bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | İşlemin cevap koduna göre mesaj barındırır. |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"session_id":"js_EAAAACbRzo74tNbO56EdJtHWkJVbbpGnwpPHtzweU2A0LzPu",
"card_holder":"gokhan oztorun",
"pan":"434678654654654",
"month":"12",
"year":"2019",
"cvc":"123",
"instalment_key":"ji_EAAAAOuvvlNfndedwQPqpTDFWAQtLi6ggCRe0hpgC3hswDcT",
"do_3ds":"true",
"ip":"21356455",
"client_id":"123456789",
"description":"deneme",
"card_holder_phone":"5XXXXXXXXX",
"card_holder_mail":"oxxxx@gmail.com"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"token_id":"jt_EAAAAIEOepBMwb1HKJddqx7r9NsyxCFd4cwglcnWsP36nZd+RyhJjac485Io+F3GB FVzflD0ySWTvhhRdCMRM8y/19g=",
"post_url":"http://pts-api.paynet.com.tr/v1/paynetjgate/tds",
"is_tds":true,
"obeject_name":"paynetj_token",
"code":0,
"message":"Başarılı Islem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/paynetj/create\\\_token](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/1.oedeme-sirasinda-kart-saklama/https:/api.paynet.com.tr\[/v1/paynetj/create\\_token)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/paynetj/create\\\_token](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/1.oedeme-sirasinda-kart-saklama/https:/pts-api.paynet.com.tr\[/v1/paynetj/create\\_token)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# 1.5.Kredi Kartından Ödeme Alınması
v1/transaction/charge
Token bilgisi oluşturulduktan sonra Server-side’da kredi kartından ödeme işlemi onaylanmalı, bu aşamaya kadar yapılan işlemlerde kredi kartından ödeme alınmaz. Ödeme charge servisinden sonra kredi kartından tahsil edilir. Servisi kullanabilmek için secret key ile authorization yapmalısınız. Aynı zamanda bu servis sadece static bir ip adresi üzerinden kullanılabilir. Mobil uygulamalar üzerinden secret key’inizi kullanarak bu servisi kullanamazsınız.
Eğer kart saklama işlemi başarılı ise charge sonrası “is\_save\_card\_succeed”: true şeklinde döner, hata durumunda “save\_card\_result\_message” kart saklama işleminin neden hatalı olduğunu döner. user\_unique\_id değişkeninde kullanıcının sizin sisteminizdeki benzersiz değeri, card\_owner\_id ise Paynet tarafından verilen o kullanıcıya ait benzersiz değer. card\_owner\_id değerini kendi sisteminizde kullanıcı ile ilişkilendirerek saklamalısınız. O kullanıcının saklı kartlarına card\_owner\_id değeri üzerinden kart listeleme servisinden ulaşabilirsiniz.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| --------------------- | ------ | ------- | ---------------------------------------------------------------------------- |
| **session\_id** | string | Evet | Auth servisiyle ilgili alınan session bilgisi |
| **token\_id** | string | Evet | Create\_token ile alınan token bilgisi. |
| **reference\_no** | string | Hayır | Ödeme işleminin ilişkili olduğu referans numarası. Örneğin sipariş numarası. |
| **transaction\_type** | string | Hayır | 1 |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------ |
| **id** | string | Tekil Paynet işlem id'si |
| **xact\_id** | string | Paynet işlem id'nin hash değeri |
| **xact\_date** | datetime | İşlemin tarihi |
| **transaction\_type** | char(1) | Satış ya da ön provizyon. 1 satış, 3 ön provizyon. Varsayılan satış işlemidir. |
| **pos\_type** | int | Pos tipi |
| **is\_tds** | bool | True ise 3D'siz işlem yapılamaz. False ise 3D'li veya 3D'siz işlem yapılabilir. |
| **agent\_id** | string | Bayi kodu |
| **user\_id** | string | Kullanıcı kodu |
| **email** | string | Mail adresi |
| **phone** | string | Telefon bilgisi |
| **bank\_id** | string | Banka kodu |
| **bank\_name** | string | Banka adı |
| **instalment** | int | İşlemin kaç taksit yapılacağı. Değer gönderilmezse tek çekim uygulanır. |
| **ratio** | float | İşlem komisyon oranı |
| **card\_no\_masked** | string | Maskeli kart bilgisi |
| **card\_holder** | string | Kart sahibinin bilgisi |
| **amount** | decimal | Brüt işlem tutarı |
| **net\_amount** | decimal | Komisyon hariç tutar |
| **comission** | decimal | Komisyon tutarı |
| **comission\_tax** | decimal | Komisyon vergisi |
| **currency** | string | Para birimi |
| **authorization\_code** | string | Onay kodu |
| **reference\_code** | string | Referans kodu |
| **order\_id** | string | Sipariş numarası |
| **is\_succeed** | bool | işlemin başarılı ya başarısız olduğu bilgisi. true ise ilgili karttan tutar tahsil edilmiş demektir. |
| **paynet\_error\_id** | string | Paynet hata kodu |
| **paynet\_error\_message** | string | Paynet hata mesajı |
| **bank\_error\_id** | string | Bankadan bildirilen hata kodu |
| **bank\_error\_message** | string | Bankadan bildirilen hata mesajı |
| **bank\_error\_short\_desc** | string | Bankadan bildirilen hata mesajı |
| **bank\_error\_long\_desc** | string | Bankadan bildirilen hata mesajı |
| **agent\_reference\_no** | string | Request sırasında gönderilen referans kodu |
| **campaign\_url** | string | Bazı kart progamlarında + taksit ve taksit erteleme seçimi işlem sonrası başka bir uygulamada seçilebiliyor. |
| **end\_user\_comission** | decimal | ratio\_code kullanımında komisyon değeri |
| **end\_user\_ratio** | float | ratio\_code kullanımında komisyon oranı |
| **ratio\_code** | string | Oran kodu |
| **ratio\_code\_method** | string | Oran kodu methodu |
| **is\_save\_card\_succeed** | bool | Kart saklama işlemi yapılıyorsa kart saklama sonucu |
| **save\_card\_result\_message** | string | Kart saklama mesajı |
| **user\_unique\_id** | string | Müşterinizin benzersiz numarası |
| **card\_owner\_id** | string | Kart saklamada bir sonraki sefer kullanılacak id |
| **object\_name** | string | Dönen cevabın nesne adı |
| **code** | string | İşlemin cevap kodu 0 ise işlem başarılıdır. |
| **message** | string | İşlemin cevap koduna göre mesaj barındırır. |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"session_id":"js_EAAAACbRzo74tNbO56EdJtHWkJVbbpGnwpPHtzweU2A0LzPu",
"token_id":"jt_EAAAAIEOepBMwb1HKJddqx7r9NsyxCFd4cwglcnWsP36nZd+RyhJjac485Io+F3GBFVzflD0ySWTvhhRdCMRM8y/19g=",
"reference_no":"sip123456",
"transaction_type":1
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"id": 2038219,
"xact_id": "xk_EAAAAIbSIhPJEDLcacVaeEbEfE8hrWt6arVigzKVOXX7FT*V",
"xact_date": "2017-07-14T13:48:20.5428782+03:00",
"transaction_type": 1,
"pos_type": 5,
"is_tds": false,
"agent_id": "10031",
"user_id": "PaynetApi",
"email": “”,
"phone": “”,
"bank_id": "AXSS",
"bank_name": "Axess",
"instalment": 0,
"ratio": 0.025,
"card_no_masked": "434678******0002",
"card_holder": "onur ozdemir",
"amount": 100,
"net_amount": 97.5,
"comission": 2.5,
"comission_tax": 0,
"currency": "TRY",
"authorization_code": "aut-4881",
"reference_code": "ref-4881",
"order_id": "order-4881",
"is_succeed": true,
"paynet_error_id": "",
"paynet_error_message": "",
"bank_error_id": "",
"bank_error_message": "",
"bank_error_short_desc": "",
"bank_error_long_desc": "",
"agent_reference_no": "",
"campaign_url": "",
"end_user_comission": 0,
"end_user_ratio": 0,
"ratio_code": "",
"ratio_code_method": "",
"is_save_card_succeed": true,
"save_card_result_message": "Kart saklama islemi basarili",
"user_unique_id": "DCFC03FA-F053-41BD-9DCA-E3178C84FB22",
"card_owner_id": "f4dabd79-5b7e-40bd-84d5-54058242dfa0",
"object_name": "transaction",
"code": 0,
"message": "Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/transaction/charge](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/1.oedeme-sirasinda-kart-saklama/https:/api.paynet.com.tr\[/v1/transaction/charge)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/transaction/charge](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/1.oedeme-sirasinda-kart-saklama/https:/pts-api.paynet.com.tr\[/v1/transaction/charge)]\() |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
Charge işlemi sırasında eğer connection timeout ya da execution time out gibi sebeplerden dolayı cevap alamıyorsanız, aynı session id ile cevap alana kadar işleme devam edebilirsiniz. Sistem aynı session id ile daha önceden başarılı bir işlem var ise o işlemi döndürür. Bu durumda sonuç kodu 0 yerine 100 döner, sonuç mesajı da “Önceki Başarılı İşlem” şeklinde döner.
{% endhint %}
# 2.Saklanmış Kart Verisi ile Ödeme Alma
# 2.1.Authenticate Servis
Auth
Bu servis ödeme işlemini başlatan bir session oluşturur. Bu sessionin belirli bir süre içerisinde tamamlanması gerekir. Bu servis ile kredi kartından çekilecek tutarı, komisyon hesaplama yöntemi gibi parametreleri gönderebilirsiniz. Ana firma ile ilgili bazı bilgilerde bu servisden döner. Servis başarılı ise http 200 döner, hata durumunda http 200 dışındaki kodlar döner. Eğer ödeme ile birlikte ödemesi alınan kart numarasını Paynet sistemlerine güvenli olarak kaydetmek istiyorsanız **save\_card** parametresini auth servisinde **true** yollayabilirsiniz. Kart saklama işlemini daha sonra da “Save Card Service (1.3 v1/paynetj/save\_card )” ile tetikleyebilirsiniz.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ----------------------- | ------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **amount** | string | Evet | Ödeme tutarının yüz ile çarpılmış hali. “10.00 TL” => “1000” olarak gönderilmeli. |
| **agent\_id** | string | Hayır | Bayi kodu: varsa işlemi yapan bayi kodu, paynet sistemindeki bayi kodu ya da firma sistemindeki cari kodu. |
| **pos\_type** | string | Hayır | Paynet POS’larından işlem yapmak istiyorsanız, boş göndermelisiniz. Firma kendi pos’undan işlem yapmak istiyorsa pos\_type:”1” olarak göndermelidir. |
| **add\_commission** | bool | Hayır | True ise komisyon tutarı kredi kartından çekilecek tutara eklenir. False ise eklenmez. Default: False’dur. |
| **reference\_no** | string | Hayır | İşleme verilen bir referans numarası. |
| **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. |
| **domain** | string | Evet | Mobil uygulamalarda işlem bir domain üzerinden olmadığından bu alanla uygulamanın ismini gönderebilirsiniz. |
| **return\_url** | string | Hayır | 3D’li işlemlerde 3D doğrulaması sonucu return\_url adresine session\_id ve token\_id parmetreleri ile birlikte redirect yapılır. return\_url parametresi verilmediği takdirde form tag’i arasına hidden input olarak session\_id ve token\_id değerleri post edilmiş olur. |
| **save\_card** | bool | Hayır | Ödeme ile birlikte kredi kart numarasınında saklanması isteniyor ise save\_card parametresi true yollayabilirsiniz |
| **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. İlk kart saklama tamamlandıktan sonra Paynet tarafından bu kullanıcıya benzersiz bir değer atanır (Kredi kartından ödemenin alınması ( charge ) servisinden dönen card\_owner\_id değeri ). Bu değeri kendi sisteminizde kullanıcınız ile ilişkilendirerek saklamalısınız. Daha sonra bu kullanıcıya yapılan kart saklama işlemlerinde user\_unique\_id yerine Paynet tarafından verilen save\_card\_oid değişkenini kullanmalısınız. |
| **car\_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 bilgisi. Bir sonraki kart saklama ve karttan ödeme alma işlemlerinde servisleri bu değer kullanılır. |
| **save\_card\_gsm\_no** | string | Hayır | Auth işleminde save\_card değeri true ise ve kart saklama işleminde OTP kontrolu zorunlu ise bu parametreye OTP doğrulama kodunun gönderilmesi gereken telefon numarası girilmelidir. OTP zorunlu değil ise zorunlu değildir. OTP kullanma zorunluluğu Paynet ve Müşteri tarafından birlikte belirlenir. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ----------------- | ------ | ------------------------------------------------------------------------------------------------------- |
| **session\_id** | string | Başlatılan session’ın numarası. Diğer servislerde bu değişken kullanılır. |
| **name** | string | Ana firmanın adı |
| **tds\_required** | bool | 3D Secure işleminin zorunlu olup olmadığı, true ise zorunludur. |
| **expire\_date** | string | Session'ın sona erme süresi |
| **object\_name** | string | Dönen nesnenin ismi |
| **code** | string | Sonuç kodu 0 ise başarılıdır.Bknz. [Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | Sonuç mesajı |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
amount: "1037",
agent_id: "12471",
pos_type: 5,
add_commission: false,
save_card : true:,
user_unique_id:’DCFC03FA-F053-41BD-9DCA-E3178C84FB22’,
card_owner_id:’d16eaa18-f00d-492d-868a-856412b7577d’,
save_card_gsm_no:’5xxxxxxxxxx’
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"session_id": "js_EAAAAHAql+krG7NbfmRg8N67QSm18/XMgCNNGM2rsM/3zt7t",
"name": "ARENA BİLGİSAYAR SAN.TİC.A.Ş.",
"tds_required": false,
"expira_date": "2015-06-11T11:52:05.7659006+03:00",
"obeject_Name": "paynetj_auth",
"code": 0,
"message": "Başarılı Islem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/paynetj/auth](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/2.saklanmis-kart-verisi-ile-oedeme-alma/https:/api.paynet.com.tr\[/v1/paynetj/auth)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/paynetj/auth](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/2.saklanmis-kart-verisi-ile-oedeme-alma/https:/pts-api.paynet.com.tr\[/v1/paynetj/auth)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# 2.2.Tanımlı Kart Listesi
v1/card/list
Bu servis daha önceden **card\_owner\_id** parametresine kaydedilmiş kartların listesini dönmektedir. **Basic Authentication**’ı **secret key** değeri ile yapmalısınız.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ------------------- | ------ | ------- | ---------------------------------------------------------------- |
| **card\_owner\_id** | string | Evet | Paynet’in kart saklamada üretiği kart sahibinin benzersiz değeri |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| --------------------- | ------ | -------------------------------------------------------------------------------------------- |
| **card\_desc** | string | Saklı karta verilen isim |
| **card\_hash** | string | Kart no 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:Ticaridc: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 | Paynet’in üretiği kart sahibinin 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önen nesnenin ismi |
| **code** | string | Sonuç kodu 0 ise başarılıdır. |
| **message** | string | Sonuç mesajı |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
“card_owner_id”:”1d16eaa18-f00d-492d-868a-856412b7577d1”
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"total":1,
"total_count":2,
"limit":10,
"ending_before":0,
"starting_after":0,
"has_more":false,
"Data":[
{
"company_code":"10031",
"agent_id":"10031",
"user_unique_id":"DCFC03FA-F053-41BD-9DCA-E3178C84FB22",
"card_owner_id":"f4dabd79-5b7e-40bd-84d5-54058242dfa0",
"card_hash":"d9124b54-162a-45c3-b09a-0388af1c891e",
"card_desc":"Paynet Ödeme Hizm.",
"card_holder":"RQ*****QR",
"card_no":"434678********0002",
"card_bin":"434678",
"card_type":"cc",
"card_bank_id":"AXSS",
"card_bank_name":"Axess",
"card_logo_url":"http://localhost:64102/img/banklogo/small/AXSS.png",
"card_brand_name":"VISA",
"expire_month":0,
"expire_year":0
}
],
"object_name":"card_list",
"code":0,
"message":null
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/card/list](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/2.saklanmis-kart-verisi-ile-oedeme-alma/https:/api.paynet.com.tr\[/v1/card/list)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/card/list](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/2.saklanmis-kart-verisi-ile-oedeme-alma/https:/pts-api.paynet.com.tr\[/v1/card/list)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# 2.3.BIN Kontrol Servisi
v1/paynetj/check\_card\_bin
Bu servis girilen Paynet sistemlerinde daha önce saklı kartınızın **card\_hash** parametresi ile sistemde tanımlı banka bilgilerini ve oran bilgilerini döner. Buradan kullanıcının seçeceği taksit seçeneğine ait **“instalment\_key”** değerini bir sonraki adım olan **create\_card\_token** servisinde kullanmalısınız.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ------------------- | ------ | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **session\_id** | string | Evet | Auth servisiyle ilgili alınan session bilgisi |
| **card\_hash** | string | Evet | Kart no hashlenmiş değeri |
| **card\_owner\_id** | string | Hayır | Paynet’in kart saklamada üretiği kart sahibinin benzersiz değeri. Daha önceden saklanmış kart ile ödeme alma işleminde Auth servisinde card\_owner\_id parametresi gönderilmediyse bu serviste card\_owner\_id parametresi gönderilmesi zorunludur. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ------------------------- | ------- | --------------------------------------------------------- |
| **bank\_id** | string | Bankanın paynet sistemindeki kodu |
| **bank\_logo** | string | Bankanın logosunun alınacağı url |
| **bank\_name** | string | Bankanın Adı |
| **card\_type** | string | Kart türü: cc :Bireysel, bc:Ticari, dc:Debit |
| **tds\_enable** | bool | Seçilen banka ile 3D’li işlem yapılabilir mi yi belirtir. |
| **data\[]** | dizi | Oran tablosu dizisi |
| **-> instalment\_key** | string | Oran anahtarı, bu anahtar daha sonra kullanılacak |
| **-> instalment** | string | Taksit sayısı |
| **-> instalment\_amount** | decimal | Taksit tutarı |
| **-> total\_amount** | decimal | Kredi kartından çekilecek tutar |
| **-> commision** | decimal | Komisyon tutarı |
| **-> desc** | string | Ödeme planı, arayüzde gösterilecek değer |
| **object\_name** | string | Dönen nesnenin ismi |
| **code** | string | Sonuç kodu 0 ise başarılıdır. |
| **message** | string | Sonuç mesajı |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
session_id: "js_EAAAAMb2/RMGqozzIWMQWUTL5pJrdQvi/aD5qZ4A1LaDfo8g",
card_hash: "f4dabd79-5b7e-40bd-84d5-54058242dfa0"
card_owner_id:"f4dabd79-5b7e-40bd-84d5-54058242dfa0"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"bank_id":"AXSS",
"bank_logo":"http://localhost:64102/img/banklogo/small/AXSS.png",
"bank_name":"Axess",
"card_type":"cc",
"tds_enable":true,
"data":[
{
"instalment_key":"ji_EAAAAGINo4rz8dJGeBoy+ItEftZ4QS0qS5xn44NfXj30wd/ZRwL7ZQs9OAKZy5xGY5EaaA==",
"instalment":101,
"instalment_amount":0.10,
"total_amount":10.30,
"commision":0.26,
"desc":"101 Taksit 101 x 0,10 = 10,30 TL"
},
{
"instalment_key":"ji_EAAAAPTScfWKuCRfoG7q82ibmozBZHJN8LYZseR0djrTRSsu",
"instalment":0,
"instalment_amount":10.24,
"total_amount":10.24,
"commision":0.20,
"desc":"0 Taksit 0 x 10,24 = 10,24 TL"
},
{
"instalment_key":"ji_EAAAAN4Aw1tKUlglnCrBgQr+m0maUBwR0ScCTbFXTJeEqGif",
"instalment":3,
"instalment_amount":3.46,
"total_amount":10.37,
"commision":0.31,
"desc":"3 Taksit 3 x 3,46 = 10,37 TL"
},
{
"instalment_key":"ji_EAAAAOT0wNkTexwQ9hDXhP6QIAdWja3VkAQalefn2jW3Ouyj",
"instalment":6,
"instalment_amount":1.73,
"total_amount":10.37,
"commision":0.31,
"desc":"6 Taksit 6 x 1,73 = 10,37 TL"
}
],
"obeject_name":"paynetj_bin",
"code":0,
"message":"Başarılı Islem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/paynetj/check\\\_card\\\_bin](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/2.saklanmis-kart-verisi-ile-oedeme-alma/https:/api.paynet.com.tr\[/v1/paynetj/check\\_card\\_bin)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/paynetj/check\\\_card\\\_bin](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/2.saklanmis-kart-verisi-ile-oedeme-alma/https:/pts-api.paynet.com.tr\[/v1/paynetj/check\\_card\\_bin)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# 2.4.Kart Hash Üzerinden Kredi Kartından Ödeme Alma
v1/paynetj/create\_card\_token
Create\_card\_token servisi saklanan kart verisi ile işlem geçebilmenize olanak tanır. Bu servis ile Paynet servislerine saklanan kart verisi (card\_hash) ve seçilen taksit api’ye gönderilir. Karşılığında 3D’siz işlemlerde kullanmak için bir token değeri döner bu token değeri ile server side’da charge servisi ile onay verilir. **3D’li işlemlerde;** token değeri ile beraber 3D’li işlemi başlatmak için token\_id değerinin post edileceği adres post\_url parametresi ile döner. Bu adrese token\_id ile beraber session\_id ve size verilen publishable\_key değerlerini http post ya da http get methodları ile göndererek post\_url sayfasını uygulama üzerinde browserda açmalısınız. Bu sayede bankaların 3D doğrulama sayfasına yönlendirilmiş olursunuz. 3D doğrulama sonucunda, doğrulama işleminin sona erdiğini browser’ın tekrardan paynet.com.tr domainine redirect edildiğinde anlayabilirsiniz. Paynet.com.tr domainine redirect edildiğinde, uygulama içersinde açılan browser’ı kapatıp, charge servisine geçebilirsiniz, işlemin başarılı ya da başarısız olduğunu bu servisi ile anlayabilirsiniz. Bu adım ile sadece 3D doğrulaması yapılmış olur, kredi kartından tutar tahsil edilmez. Kredi kartından tutarın tahsil edilmesi için charge servisi başarılı şekilde çağrılmalıdır.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ----------------------- | ------ | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **session\_id** | string | Evet | Auth servisiyle ilgili alınan session bilgisi |
| **card\_hash** | string | Evet | Kart no hashlenmiş değeri |
| **card\_owner\_id** | string | Hayır | Paynet’in kart saklamada üretiği kart sahibinin benzersiz değeri. Daha önceden saklanmış kart ile ödeme alma işleminde Auth servisinde card\_owner\_id parametresi gönderilmediyse bu serviste card\_owner\_id parametresi gönderilmesi zorunludur. |
| **instalment\_key** | string | Evet | Seçilen oranın key’i |
| **do\_3ds** | bool | Evet | 3D’li işlem ise true |
| **ip** | string | Evet | İşlemi yapan client’in ip'si |
| **client\_id** | string | | Client’a atılan benzersiz bir token değeri |
| **description** | string | | Açıklama |
| **card\_holder\_phone** | string | | Kart sahibi telefon numarası |
| **card\_holder\_mail** | string | | Kart sahibi email numarası |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| -------------- | ------ | ---------------------------------------------------------------------------------------------------------- |
| token\_id | string | Kredi kartı işlemini tamamlamak için kullanılacak token değeri |
| post\_url | string | Kart saklamalı işlemlerinde publishable\_key, token\_id ve session\_id parametrelerinin post edileceği url |
| is\_tds | bool | İşlemin 3D’li mi 3D’siz mi olduğunu gösterir. |
| object\_name | string | Dönen nesnenin ismi |
| code | string | Sonuç kodu 0 ise başarılıdır. |
| message | string | Sonuç mesajı |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"session_id":"js_EAAAACbRzo74tNbO56EdJtHWkJVbbpGnwpPHtzweU2A0LzPu",
"card_hash":"f4dabd79-5b7e-40bd-84d5-54058242dfa0",
"card_owner_id":"f4dabd79-5b7e-40bd-84d5-54058242dfa0"
"instalment_key":"ji_EAAAAOuvvlNfndedwQPqpTDFWAQtLi6ggCRe0hpgC3hswDcT",
"do_3ds":"true",
"ip":"21356455",
"client_id":"123456789",
"description":"deneme",
"card_holder_phone":"5XXXXXXXXX",
"card_holder_mail":"oxxxx@gmail.com"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"token_id":"jt_EAAAAIEOepBMwb1HKJddqx7r9NsyxCFd4cwglcnWsP36nZd+RyhJjac485Io+F3GB FVzflD0ySWTvhhRdCMRM8y/19g=",
"post_url":"http://pts-api.paynet.com.tr/v1/paynetjgate/tds",
"is_tds":true,
"obeject_name":"paynetj_token",
"code":0,
"message":"Başarılı Islem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/paynetj/create\\\_card\\\_token](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/2.saklanmis-kart-verisi-ile-oedeme-alma/https:/api.paynet.com.tr\[/v1/paynetj/create\\_card\\_token)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/paynetj/create\\\_card\\\_token](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/2.saklanmis-kart-verisi-ile-oedeme-alma/https:/pts-api.paynet.com.tr\[/v1/paynetj/create\\_card\\_token)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# 2.5.Ödemenin Alınması
v1/transaction/charge
Token bilgisi oluşturulduktan sonra Server-side’da kredi kartından ödeme işlemi onaylanmalı, bu aşamaya kadar yapılan işlemlerde kredi kartından ödeme alınmaz. Ödeme charge servisinden sonra kredi kartından tahsil edilir. Servisi kullanabilmek için secret key ile authorization yapmalısınız. Aynı zamanda bu servis sadece static bir ip adresi üzerinden kullanılabilir. Mobil uygulamalar üzerinden secret key’inizi kullanarak bu servisi kullanamazsınız.Eğer kart saklama işlemi başarılı ise charge sonrası “is\_save\_card\_succeed”: true şeklinde döner, hata durumunda “save\_card\_result\_message” kart saklama işleminin neden hatalı olduğunu döner. user\_unique\_id değişkeninde kullanıcının sizin sisteminizdeki benzersiz değeri, card\_owner\_id ise Paynet tarafından verilen o kullanıcıya ait benzersiz değer. card\_owner\_id değerini kendi sisteminizde kullanıcı ile ilişkilendirerek saklamalısınız. O kullanıcının saklı kartlarına card\_owner\_id değeri üzerinden kart listeleme servisinden ulaşabilirsiniz.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| --------------------- | ------ | ------- | ---------------------------------------------------------------------------- |
| **session\_id** | string | Evet | Auth servisiyle ilgili alınan session bilgisi |
| **token\_id** | string | Evet | Create\_token ile alınan token bilgisi. |
| **reference\_no** | string | Hayır | Ödeme işleminin ilişkili olduğu referans numarası. Örneğin sipariş numarası. |
| **transaction\_type** | string | Hayır | 1 |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------ |
| **id** | string | Tekil Paynet işlem id'si |
| **xact\_id** | string | Paynet işlem id'nin hash değeri |
| **xact\_date** | datetime | İşlem tarihi |
| **transaction\_type** | char(1) | Satış ya da ön provizyon. 1 satış, 3 ön provizyon. Varsayılan satış işlemidir. |
| **pos\_type** | int | Pos tipi |
| **is\_tds** | bool | True ise 3D'siz işlem yapılamaz. False ise 3D'li veya 3D'siz işlem yapılabilir. |
| **agent\_id** | string | Bayi kodu |
| **user\_id** | string | Kullanıcı kodu |
| **email** | string | Mail adresi |
| **phone** | string | Telefon bilgisi |
| **bank\_id** | string | Banka kodu |
| **bank\_name** | string | Banka adı |
| **instalment** | int | İşlemin kaç taksit yapılacağı. Değer gönderilmezse tek çekim uygulanır. |
| **ratio** | float | İşlem komisyon oranı |
| **card\_no\_masked** | string | Maskeli kart bilgisi |
| **card\_holder** | string | Kart sahibinin bilgisi |
| **amount** | decimal | Brüt işlem tutarı |
| **net\_amount** | decimal | Komisyon hariç tutar |
| **comission** | decimal | Komisyon tutarı |
| **comission\_tax** | decimal | Komisyon vergisi |
| **currency** | string | Para birimi |
| **authorization\_code** | string | Onay kodu |
| **reference\_code** | string | Referans kodu |
| **order\_id** | string | Sipariş numarası |
| **is\_succeed** | bool | işlemin başarılı ya başarısız olduğu bilgisi. true ise ilgili karttan tutar tahsil edilmiş demektir. |
| **paynet\_error\_id** | string | Paynet hata kodu |
| **paynet\_error\_message** | string | Paynet hata mesajı |
| **bank\_error\_id** | string | Bankadan bildirilen hata kodu |
| **bank\_error\_message** | string | Bankadan bildirilen hata mesajı |
| **bank\_error\_short\_desc** | string | Bankadan bildirilen hata mesajı |
| **bank\_error\_long\_desc** | string | Bankadan bildirilen hata mesajı |
| **agent\_reference\_no** | string | Request sırasında gönderilen referans kodu |
| **campaign\_url** | string | Bazı kart progamlarında + taksit ve taksit erteleme seçimi işlem sonrası başka bir uygulamada seçilebiliyor. |
| **end\_user\_comission** | decimal | ratio\_code kullanımında komisyon değeri |
| **end\_user\_ratio** | float | ratio\_code kullanımında komisyon oranı |
| **ratio\_code** | string | Oran kodu |
| **ratio\_code\_method** | string | Oran kodu methodu |
| **is\_save\_card\_succeed** | bool | Kart saklama işlemi yapılıyorsa kart saklama sonucu |
| **save\_card\_result\_message** | string | Kart saklama mesajı |
| **user\_unique\_id** | string | Müşterinizin benzersiz numarası |
| **card\_owner\_id** | string | Kart saklamada bir sonraki sefer kullanılacak id |
| **object\_name** | string | Dönen cevabın nesne adı |
| **code** | string | İşlemin cevap kodu 0 ise işlem başarılıdır. |
| **message** | string | İşlemin cevap koduna göre mesaj barındırır. |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"session_id":"js_EAAAACbRzo74tNbO56EdJtHWkJVbbpGnwpPHtzweU2A0LzPu",
"token_id":"jt_EAAAAIEOepBMwb1HKJddqx7r9NsyxCFd4cwglcnWsP36nZd+RyhJjac485Io+F3GBFVzflD0ySWTvhhRdCMRM8y/19g=",
"reference_no":"sip123456",
"transaction_type":1
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"id": 2038219,
"xact_id": "xk_EAAAAIbSIhPJEDLcacVaeEbEfE8hrWt6arVigzKVOXX7FT*V",
"xact_date": "2017-07-14T13:48:20.5428782+03:00",
"transaction_type": 1,
"pos_type": 5,
"is_tds": false,
"agent_id": "10031",
"user_id": "PaynetApi",
"email": “”,
"phone": “”,
"bank_id": "AXSS",
"bank_name": "Axess",
"instalment": 0,
"ratio": 0.025,
"card_no_masked": "434678******0002",
"card_holder": "onur ozdemir",
"amount": 100,
"net_amount": 97.5,
"comission": 2.5,
"comission_tax": 0,
"currency": "TRY",
"authorization_code": "aut-4881",
"reference_code": "ref-4881",
"order_id": "order-4881",
"is_succeed": true,
"paynet_error_id": "",
"paynet_error_message": "",
"bank_error_id": "",
"bank_error_message": "",
"bank_error_short_desc": "",
"bank_error_long_desc": "",
"agent_reference_no": "",
"campaign_url": "",
"end_user_comission": 0,
"end_user_ratio": 0,
"ratio_code": "",
"ratio_code_method": "",
"is_save_card_succeed": true,
"save_card_result_message": "Kart saklama islemi basarili",
"user_unique_id": "DCFC03FA-F053-41BD-9DCA-E3178C84FB22",
"card_owner_id": "f4dabd79-5b7e-40bd-84d5-54058242dfa0",
"object_name": "transaction",
"code": 0,
"message": "Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | -------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | |
| **Test Sistemi** | [/v1/transaction/charge](https://api.paynet.com.tr/v1/transaction/charge) |
| {% endtab %} | |
| {% endtabs %} | |
{% hint style="info" %}
Charge işlemi sırasında eğer connection timeout ya da execution time out gibi sebeplerden dolayı cevap alamıyorsanız, aynı session id ile cevap alana kadar işleme devam edebilirsiniz. Sistem aynı session id ile daha önceden başarılı bir işlem var ise o işlemi döndürür. Bu durumda sonuç kodu 0 yerine 100 döner, sonuç mesajı da “Önceki Başarılı İşlem” şeklinde döner.
{% endhint %}
# 3.Ödeme Almadan Kart Verisi Kaydetme
Paynet sistemleri üzerinde ödeme almadan kart bilgisini Paynet sistemlerinde güvenli olarak kaydetmenizi sağlayan servistir.
Ödeme almadan kart bilgisi kaydetme servisleri Authentication tipi olarak http Basic authentication yapısı kullanılıyor. Authentication’ı secret key üzerinden daha önceden tanımlamasını yaptığımız static ip üzerinden yapabilirsiniz. İlk kart saklama işleminde user\_unique\_id zorunlu. İlk kart saklamadan sonra servis card\_owner\_id’yi döner. Üye işyeri kendi database’inde card\_owner\_id’yi ve diğer bilgileri kaydetmeli. İkinci saklama işleminde card\_owner\_id üzerinden kart saklama yapılır. OTP yapmak zorunlu ise kart saklama servisinden önce önceden OTP gönderme servisi ile OTP doğrulama servisleri çağrılır. OTP zorunlu değil ise direk kart saklama servisi kullanılabilinir.
Kart saklama sırasında 1 TL’lik ön provizyon alıp iptal edecek.
# 3.1.OTP Gönderme Servisi
v1/card/send\_otp
Üye işyeri kart saklama servislerinde OTP doğrulama yapması zorunlu ise bu servisi kullanarak ilgili numaraya (son kullanıcı) OTP kodu gönderimi yapar.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------------- | ------ | ------- | ---------------------------------------------------------------------------------------------------------- |
| **user\_gsm** | string | Evet | OTP gönderilecek telefon numarası |
| **otp\_session\_id** | string | Evet | OTP ile ilişkilendirilecek benzersiz değer. Bu değer ile saklanacak kart bilgisi ilişkilendirmesi yapılır. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| --------------- | -------- | --------------------------------------------------------------------- |
| **otp\_expire** | datetime | OTP’nin expire olma zamanı, bu zamandan önce tekrar çalıştırılmamalı. |
| **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"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"otp_expire":"2017-07-17T15:30:15.0581408+03:00",
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/card/send\\\_otp](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/3.oedeme-almadan-kart-verisi-kaydetme/https:/api.paynet.com.tr\[/v1/card/send\\_otp)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/card/send\\\_otp](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/3.oedeme-almadan-kart-verisi-kaydetme/https:/pts-api.paynet.com.tr\[/v1/card/send\\_otp)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# 3.2.OTP Kontrol Servisi
v1/card/check\_otp
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" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------------- | ------ | ------- | -------------------------------------------------------------------------- |
| **otp\_code** | string | Evet | Son kullanıcının send\_otp servisinde parametre olarak gönderilen numarası |
| **otp\_session\_id** | string | Evet | OTP ile ilişkilendirilecek benzersiz değer. |
| **user\_gsm** | string | Evet | 5XXXXXXXXX formatında OTP doğrulaması yapılacak gsm no. |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| -------------- | ------ | ------------------------------ |
| **code** | string | Dönüş sonucunun kodu |
| **message** | string | Dönüş sonuç kodunun açıklaması |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"user_gsm":"5324818942",
"otp_session_id":"123456",
"otp_code":"ART2"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/card/check\\\_otp](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/3.oedeme-almadan-kart-verisi-kaydetme/https:/api.paynet.com.tr\[/v1/card/check\\_otp)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/card/check\\\_otp](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/3.oedeme-almadan-kart-verisi-kaydetme/https:/pts-api.paynet.com.tr\[/v1/card/check\\_otp)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# 3.3.Kart Bilgisi Saklama Servisi
v1/card/save
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" %}
{% 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)]\() |
| **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)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# 3.4.Kart Silme Servisi
v1/card/delete
Bu servis girilen Paynet sistemlerinde daha önce saklı kartınızın silme işareti koyar.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ------------------- | ------ | ------- | ------------------------------------------------- |
| **card\_owner\_id** | string | Evet | Paynet’in üretiği kart sahibinin benzersiz değeri |
| **card\_hash** | string | Evet | Kart no hashlenmiş değeri |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| -------------- | ------ | ------------------------------ |
| **code** | string | Dönüş sonucunun kodu |
| **message** | string | Dönüş sonuç kodunun açıklaması |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
" card_hash ":"abcdef-8014-435e-8bcc-daf4592f3431",
" card_owner_id ":"abc45adc20-91ba-4a29-a599-0eb18177247e "
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/card/delete](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/3.oedeme-almadan-kart-verisi-kaydetme/https:/api.paynet.com.tr\[/v1/card/delete)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/card/delete](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/3.oedeme-almadan-kart-verisi-kaydetme/https:/pts-api.paynet.com.tr\[/v1/card/delete)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# 3.5.Kart Açıklaması Güncelleme Servisi
v1/card/desc\_update
Bu servis girilen Paynet sistemlerinde daha önce saklı kartınızın kart adı bilgisini günceller.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ------------------- | ------ | ------- | ------------------------------------------------- |
| **card\_owner\_id** | string | Evet | Paynet’in üretiği kart sahibinin benzersiz değeri |
| **card\_hash** | string | Evet | Kart no hashlenmiş değeri |
| **card\_desc** | string | Evet | Yeni kart açıklaması |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| -------------- | ------ | ------------------------------ |
| **code** | string | Dönüş sonucunun kodu |
| **message** | string | Dönüş sonuç kodunun açıklaması |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
"card_hash":"abcdef-8014-435e-8bcc-daf4592f3431",
"card_owner_id":"abc45adc20-91ba-4a29-a599-0eb18177247e ",
"card_desc":"Kart Aciklamasi "
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/card/desc\\\_update](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/3.oedeme-almadan-kart-verisi-kaydetme/https:/api.paynet.com.tr\[/v1/card/desc\\_update)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/card/desc\\\_update](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/3.oedeme-almadan-kart-verisi-kaydetme/https:/pts-api.paynet.com.tr\[/v1/card/desc\\_update)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# 3.6.Kart Listesi Servisi
v1/card/list
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ------------------- | ------ | ------- | ---------------------------------------------------------------- |
| **card\_owner\_id** | string | Evet | Paynet’in kart saklamada üretiği kart sahibinin benzersiz değeri |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| --------------------- | ------ | -------------------------------------------------------------------------------------------- |
| **card\_desc** | string | Saklı karta verilen isim |
| **card\_hash** | string | Kart no 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 | 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 | Paynet’in üretiği kart sahibinin 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" %}
```
{
“card_owner_id”:”1d16eaa18-f00d-492d-868a-856412b7577d1”
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"total": 1,
"total_count": 2,
"limit": 10,
"ending_before": 0,
"starting_after": 0,
"has_more": false,
"Data": [
{
"company_code": "10031",
"agent_id": "10031",
"user_unique_id": "DCFC03FA-F053-41BD-9DCA-E3178C84FB22",
"card_owner_id": "f4dabd79-5b7e-40bd-84d5-54058242dfa0",
"card_hash": "d9124b54-162a-45c3-b09a-0388af1c891e",
"card_desc": "Paynet Ödeme Hizm.",
"card_holder": "RQ*****QR",
"card_no": "434678********0002",
"card_bin": "434678",
"card_type": "cc",
"card_bank_id": "AXSS",
"card_bank_name": "Axess",
"card_logo_url": "http://localhost:64102/img/banklogo/small/AXSS.png",
"card_brand_name": "VISA",
"expire_month": 0,
"expire_year": 0
}
],
"object_name": "card_list",
"code": 0,
"message": null
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/card/list](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/3.oedeme-almadan-kart-verisi-kaydetme/https:/api.paynet.com.tr\[/v1/card/list)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/card/list](https://doc.paynet.com.tr/uornek/servisler/kart-saklama/3.oedeme-almadan-kart-verisi-kaydetme/https:/pts-api.paynet.com.tr\[/v1/card/list)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# Fatura
Geliştirilme aşamasında..
# Başvuru
# Başvuru Kayıt Servisi
v1/membership/formdata\_insert
Amaç, ana firmaların bayilerinin bilgilerini kendi sistemleri üzerinden göndererek Paynet tarafında başvuru sürecinin başlatılmasıdır.
Başvuru sürecinin başlatılabilmesi için **"v1/membership/formdata\_insert"** servisine ilgili parametrelerin post edilerek gönderilmesi gerekir.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ------------------------------ | ----------- | --------------------------------------------------------------------------------------------- |
| **contact\_gsm\_no** | string(10) | Bayinize ait yetkili kişinin gsm numarası başında 0 olmadan 10 karakter olarak girilmelidir. |
| **agent\_reference** | string(10) | Başvurusu yapılacak olan bayinin ana firmadaki bayi kodu girilmelidir. |
| **contact\_name** | string(100) | Bayideki yetkili kişinin adı ve soyadı girilmelidir. |
| **contact\_mail** | string(50) | Bayinize ait yetkili kişinin mail adresi girilmelidir. |
| **company\_name** | string(100) | Bayi adı girilmelidir. |
| **tax\_office** | string(20) | Bayinizin bağlı olduğu vergi dairesi girilmelidir. |
| **tckn\_vkn** | string(20) | Vergi kimlik numarası veya TC kimlik no su girilmelidir. |
| **adres1** | string(50) | Bayinizin adres bilgilerinden Mahalle,Cadde,Sokak kısımları girilmelidir. |
| **adres2** | string(50) | Bayinizin adres bilgilerinden Apartman,Blok ve Bina No kısımları girilmelidir. |
| **city** | string(50) | Bayinizin bulunduğu ilin il kodu bilgisi girilmelidir. |
| **province** | string(50) | Bayinizin bulunduğu ilçe bilgisi girilmelidir. |
| **postal\_code** | string(8) | Bayinizin bulunduğu bölgenin posta kodu bilgisi girilmelidir. |
| **iban** | string(26) | Başında ülke kodu olacak şekilde (örn "TR") toplamda 26 karakter olacak şekilde girilmelidir. |
| **company\_fieldof\_activity** | string(50) | Bayinizin faaliyet alanı girilmelidir. |
| **products\_to\_be\_sold** | string(200) | Bayinizin sattığı ürün grup bilgisi girilmelidir. |
| **phone** | string(12) | Bayinizin telefon numarası başında 0 olmadan 10 karakter olarak girilmelidir. |
| **infrastructure\_provider** | string(50) | Bayinizin altyapı sağlayıcısı girilmelidir.(opsiyonel) |
| **web\_site** | string(50) | Bayinizin web satış ile posların entegre edileceği web sitesi girilmelidir.(opsiyonel) |
| **approx\_creditcard\_budget** | string(50) | Bayinizin Aylık Hedeflenen/Gerçekleşen kredi kartı ciro bilgisi (TL) girilmelidir.(opsiyonel) |
| **is\_web\_sales** | bool | Web satış için true göndermelidirler. |
| **is\_charged** | bool | Tahsilat için true göndermelidirler. |
| **is\_agent\_network** | bool | Bayilik ağı için true göndermelidirler. |
| {% endtab %} | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **object\_name** | string | Dönen cevabın nesne adıdır. |
| **code** | string | İşlemin cevap kodu 0 ise işlem başarılıdır.Dönüş kodları |
| **message** | string | İşlemin cevap koduna göre mesaj bilgisini barındırır. |
| **form\_id** | string | İşlem başarılı olup bayi başvurusu yapıldığında sistem tarafından otomatik oluşan başvuru numarasıdır. |
| **form\_link** | string | İşlem başarılı olup bayi başvurusu yapıldığında sistem tarafından otomatik oluşan başvuru takip linkidir.Başvuruyla ilgili belgeleri bu link üzerinden yükleyebilirsiniz. |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
form_id: 0,
device_id: "2001",
form_type: 2,
company_name: "deneme",
adres1: "maslak mahallesi paynet sokak",
adres2: "uso center kat:17",
province: "Sarıyer",
city: "34",
postal_code: "34098",
tckn: "12345678901",
tckn_vkn: "1234567890",
iban: "",
product_to_be_sold: "",
contact_name: "Ali Duru",
contact_gsm_no: "5556667788",
contact_mail: "aliduru@duruali.com",
platform: "WEB",
company_code: "",
company_fieldof_activity: "",
tax_office: "",
web_site: "",
approx_creditcard_budget: "",
infrastructure_provider: "",
phone: "",
is_web_sales: true,
is_agent_network: false,
is_charged: true,
agent_reference: ""
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name":"membership_formdata_insert",
"code":0,
"message":"Ba\u015far\u0131l\u0131 \u0130\u015flem",
"form_id":4567,
"form_link":"www.paynet.com.tr/basvuru-takip?form_id=*****"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/membership/formdata\\\_insert](https://doc.paynet.com.tr/uornek/servisler/basvuru/https:/api.paynet.com.tr\[/v1/membership/formdata\\_insert)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/membership/formdata\\\_insert](https://doc.paynet.com.tr/uornek/servisler/basvuru/https:/pts-api.paynet.com.tr\[/v1/membership/formdata\\_insert)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# Döküman Tipleri Çekme Servisi
v1/membership/formtypes\_and\_doctypes\_all
Başvurusu yapılan firmanın yüklemesi gereken dokümanlarının çekilme servisidir.
Başvuru id ve bu servisten dönen doctypeid parametresi doküman yükleme/silme servisleri çağrılırken kullanılır.Doküman tipleri çekilebilmesi için **"v1/membership/formtypes\_and\_doctypes\_all"** servisine post isteği atılması gerekir. **İstek atılırken herhangi bir parametre istenilmemektedir.**
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| --------------------- | -------------- | --------------------------------------------------------------------------------------------------------------- |
| **Data\[]** | dizi | |
| **-> formtype\_id** | int | Form tipi parametresi dönülmektedir. |
| **-> doctype\_id** | int | Form tipine bağlı doküman tipi dönülmektedir. |
| **-> formtype\_desc** | string(max 20) | İlgili form tipinin açıklaması dönülmektedir. |
| **-> doctype\_desc** | string(max 50) | İlgili doküman tipinin açıklaması dönülmektedir. |
| **-> is\_required** | bool | ? |
| **object\_name** | string | Dönen cevabın nesne adıdır. |
| **code** | string | İşlemin cevap kodu 0 ise başarılıdır. bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | İşlemin cevap koduna göre mesaj bilgisini barındırır. |
| {% endtab %} | | |
{% tab title="Response" %}
```
{
"Data": [
{
"formtype_id": 4,
"doctype_id": 99,
"formtype_desc": "Bayi Ağı",
"doctype_desc": "Online Sözleşme",
"is_required": false
}
],
"object_name": "membership_formtypes_and_doctypes_all",
"code": 0,
"message": "Başarılı İşlem" }
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/membership/formtypes\\\_and\\\_doctypes\\\_all](https://doc.paynet.com.tr/uornek/servisler/basvuru/https:/api.paynet.com.tr\[/v1/membership/formtypes\\_and\\_doctypes\\_all)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/membership/formtypes\\\_and\\\_doctypes\\\_all](https://doc.paynet.com.tr/uornek/servisler/basvuru/https:/pts-api.paynet.com.tr\[/v1/membership/formtypes\\_and\\_doctypes\\_all)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# Form Tipine Bağlı Doküman Çekme Servisi
v1/membership/formtypes\_and\_doctypes
Başvuru yapılan firmanın başvuru türüne göre zorunlu dokümanlarının çekilme servisidir.
Başvuru id ve bu servisten dönen doctypeid parametresi doküman yükleme/silme servisleri çağrılırken kullanılır.Doküman tipleri çekilebilmesi için **"v1/membership/formtypes\_and\_doctypes"** servisine post isteği atılması gereklidir. Şahıs başvuruları için form\_type parametresine 2, ticari başvurular için 3 değerini gönderebilirsiniz.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| -------------- | ------ | ------- | --------- |
| **form\_type** | string | Evet | Form tipi |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| --------------------- | ---------- | -------------------------------------------------------------------------------------------------------------- |
| **object\_name** | string | Dönen cevabın nesne adıdır. |
| **code** | string | İşlemin cevap kodu 0 ise başarılıdır.Bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | İşlemin cevap koduna göre mesaj bilgisini barındırır. |
| **Data\[]** | dizi | |
| **-> formtype\_id** | int | Form tipi parametresi dönülmektedir. |
| **-> doctype\_id** | int | Form tipine bağlı doküman tipi dönülmektedir. |
| **-> formtype\_desc** | string(20) | İlgili form tipinin açıklaması dönülmektedir. |
| **-> doctype\_desc** | string(50) | İlgili doküman tipinin açıklaması dönülmektedir. |
| **-> is\_required** | bool | Bayinizin bulunduğu ilçe bilgisi girilmelidir. |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
form_type: 2
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"Data":[
{
"formtype_id":2,
"doctype_id":1,
"formtype_desc":"Şahıs Firma",
"doctype_desc":"Kimlik Ön Görseli",
"is_required":true
},
{
"formtype_id":2,
"doctype_id":2,
"formtype_desc":"Şahıs Firma",
"doctype_desc":"Kimlik Arka Görseli",
"is_required":true
},
{
"formtype_id":2,
"doctype_id":3,
"formtype_desc":"Şahıs Firma",
"doctype_desc":"Vergi Levhası Görseli",
"is_required":true
}
],
"object_name":"membership_formtypes_and_doctypes",
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/membership/formtypes\\\_and\\\_doctypes](https://doc.paynet.com.tr/uornek/servisler/basvuru/https:/api.paynet.com.tr\[/v1/membership/formtypes\\_and\\_doctypes)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/membership/formtypes\\\_and\\\_doctypes](https://doc.paynet.com.tr/uornek/servisler/basvuru/https:/pts-api.paynet.com.tr\[/v1/membership/formtypes\\_and\\_doctypes)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# Doküman Yükleme
v1/membership/upload\_file\_insert
Başvuruya ait doküman yüklemek için kullanılan servistir.
Bu servisi kullanabilmek için **"v1/membership/upload\_file\_insert"** servisine post isteği atılması gerekmektedir.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| ---------------- | ------ | ------- | ------------------ |
| **form\_id** | string | Evet | Form id'si |
| **doctype\_id** | string | Evet | Dokuman tipi id'si |
| **pars\_base64** | string | Hayır | ? |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | -------------------------------------------------------------------------------------------------------------- |
| **object\_name** | string | Dönen cevabın nesne adıdır. |
| **code** | string | İşlemin cevap kodu 0 ise başarılıdır.Bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | İşlemin cevap koduna göre mesaj bilgisini barındırır. |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
form_id: 2,
doctype_id : 1,
pars_base64 : ""
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name": "membership_file_upload",
"code": 0,
"message": "Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/membership/upload\\\_file\\\_insert](https://doc.paynet.com.tr/uornek/servisler/basvuru/https:/api.paynet.com.tr\[/v1/membership/upload\\_file\\_insert)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/membership/upload\\\_file\\\_insert](https://doc.paynet.com.tr/uornek/servisler/basvuru/https:/pts-api.paynet.com.tr\[/v1/membership/upload\\_file\\_insert)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# Doküman Silme
v1/membership/upload\_file\_delete
Başvuruya ait yüklenen dokümanın silinmesi için kullanılan servistir.
Bu servisi kullanabilmek için **"v1/membership/upload\_file\_delete"** servisine post isteği atılması gerekmektedir.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Zorunlu | Açıklama |
| --------------- | ------ | ------- | ------------------ |
| **form\_id** | string | Evet | Form id'si |
| **doctype\_id** | string | Evet | Doküman tipi id'si |
| {% endtab %} | | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ---------------- | ------ | -------------------------------------------------------------------------------------------------------------- |
| **object\_name** | string | Dönen cevabın nesne adıdır. |
| **code** | string | İşlemin cevap kodu 0 ise başarılıdır.Bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message** | string | İşlemin cevap koduna göre mesaj bilgisini barındırır. |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
form_id: 2,
doctype_id : 1
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"object_name": "membership_upload_file_delete",
"code": 0,
"message": "Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/membership/upload\\\_file\\\_delete](https://doc.paynet.com.tr/uornek/servisler/basvuru/https:/api.paynet.com.tr\[/v1/membership/upload\\_file\\_delete)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/membership/upload\\\_file\\\_delete](https://doc.paynet.com.tr/uornek/servisler/basvuru/https:/pts-api.paynet.com.tr\[/v1/membership/upload\\_file\\_delete)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# Başvuru Çekme
v1/membership/formdata\_get
Bu servisi kullanabilmek için **"v1/membership/formdata\_get"** servisine post isteği atılması gerekmektedir.
{% hint style="success" %}
{% endhint %}
{% tabs %}
{% tab title="İstek Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| -------------- | ------ | -------------------------------------------------------- |
| **form\_id** | string | Form id'si |
| **Vkn\_Tckn** | string | Vergi kimlik numarası veya TC kimlik no su girilmelidir. |
| {% endtab %} | | |
{% tab title="Dönüş Parametreleri" %}
| Parametre İsmi | Tip | Açıklama |
| ------------------------------ | ---------------- | ----------------------------------------------------------------------------------------------------- |
| **Data** | FormDataModel\[] | Form tipine bağlı doküman tipleri gönderilmektedir. |
| **form\_id** | int | Başvuruya ait unique bir id dönülmektedir. |
| **status** | smallint | Başvurunun durumunu gösterir. |
| **channel** | smallint | Başvurunun organik veya reklam üzerinden gelip gelmediğini gösterir. |
| **channelDesc** | string(max 50) | Başvurunun organik veya reklam üzerinden gelip gelmediğini açıklamalı gösterir. |
| **documentFormid** | int | Forma ait doküman id si dönülmektedir. |
| **platform** | string(20) | Başvurunun yağıldığı platform bilgisidir.Web üzerinden gelen başvurularda "WEB" olarak dönülmektedir. |
| **device\_id** | string(200) | Başvurunun yapıldığı cihaz id veya ip adresi bilgisi dönülmektedir. |
| **contact\_name** | string(100) | Başvuru yapan kişinin isim ve soyisim bilgileri dönülmektedir. |
| **contact\_gsm\_no** | string(12) | Başvuru yapan kişinin gsm bilgisi dönülmektedir. |
| **contact\_mail** | string(50) | Bayinize ait yetkili kişinin mail adresi dönülmektedir. |
| **company\_name** | string(100) | Bayi adı dönülmektedir. |
| **FormID\_Enc** | string | Başvuru id ye ait formid bilgisinin encrypt edilmiş halidir. |
| **form\_type** | smallint | Başvurunun hangi form tipinde olduğu dönülmektedir. |
| **tckn** | string(20) | Tc kimlik no bilgisi dönülmektedir. |
| **vkn** | string(20) | Vergi kimlik numarası bilgisi dönülmektedir. |
| **adres1** | string(50) | Bayinizin adres bilgilerinden Mahalle,Cadde,Sokak kısımları dönülmektedir. |
| **adres2** | string(50) | Bayinizin adres bilgilerinden Apartman,Blok ve Bina No kısımları dönülmektedir. |
| **city** | string(50) | Bayinizin bulunduğu ilin il kodu bilgisi dönülmektedir. |
| **province** | string(50) | Bayinizin bulunduğu ilçe bilgisi dönülmektedir. |
| **postal\_code** | string(8) | Bayinizin bulunduğu bölgenin posta kodu bilgisi dönülmektedir. |
| **iban** | string(26) | Başında ülke kodu olacak şekilde (örn "TR") toplamda 26 karakter olacak şekilde dönülmektedir. |
| **company\_fieldof\_activity** | string(50) | Bayinizin faaliyet alanı dönülmektedir. |
| **products\_to\_be\_sold** | string(200) | Bayinizin sattığı ürün grup bilgisi dönülmektedir. |
| **phone** | string(12) | Bayinizin telefon numarası başında 0 olmadan 10 karakter olarak dönülmektedir. |
| **infrastructure\_provider** | string(50) | Bayinizin altyapı sağlayıcısı dönülmektedir. |
| **web\_site** | string(50) | Bayinizin web satış ile posların entegre edileceği web sitesi dönülmektedir. |
| **approx\_creditcard\_budget** | string(50) | Bayinizin Aylık Hedeflenen/Gerçekleşen kredi kartı ciro bilgisi (TL) dönülmektedir. |
| **is\_web\_sales** | bool | Web satış için true dönülmektedir. |
| **is\_charged** | bool | Tahsilat için true dönülmektedir. |
| **is\_agent\_network** | bool | Bayilik ağı için true dönülmektedir. |
| {% endtab %} | | |
{% tab title="Request" %}
```
{
form_id: 2,
Vkn_Tckn: "12345678901"
}
```
{% endtab %}
{% tab title="Response" %}
```
{
"Data":{
"form_id":5605,
"status":6,
"channel":1,
"channelDesc":"Organic",
"documentFormId":5605,
"platform":"WEB",
"device_id":"91.93.43.114",
"contact_name":"CLARKE ERYERU",
"contact_gsm_no":"5987576556",
"contact_mail":"nygehej@mailinator.net",
"FormID_Enc":"DhhtB1wKcpU%3d",
"form_type":2,
"company_name":"TREVİNO AND KANE LLC",
"adres1":"Fugit ex ab vero ipsa non sit totam enim magnam en",
"adres2":"Est aut ipsam nisi et magni sit",
"province":"ADALAR",
"city":"34",
"postal_code":"35364",
"tckn_vkn":"41732139224",
"tckn":"41732139224",
"vkn":"",
"iban":"TR000000000000000000000000",
"company_code":"1789",
"agent_id":"66043",
"mcc_id":"5072",
"sector_id":"0001",
"modify_user":"",
"modify_user_name":"",
"note":null,
"tax_office":"Voluptatem incidunt ",
"web_site":"http://www.pefykyxekodixux.me.uk",
"phone":"3997897896 ",
"agent_reference":"",
"product_to_be_sold":"Aute aut perspiciatis eos distinctio Dolorem con",
"company_fieldof_activity":"Ratione quia laborum et est temporibus mollitia e",
"approx_creditcard_budget":"50.000-100.000",
"infrastructure_provider":"Eum deserunt ut quis aliquip minim nisi ut molesti",
"assigned_user_mail":"",
"assigned_user_mail_enc":"",
"assigned_user":"",
"is_web_sales":false,
"is_charged":false,
"is_agent_network":false,
"modify_date":"0001-01-01T00:00:00",
"create_date":"2018-07-17T17:53:26.867",
"is_application_created_by_company_and_waitingapply":false
},
"Docs":[
{
"form_doc_id":3338,
"form_id":5605,
"doctype_id":1,
"doc_format":"png",
"docpath":"C:\\web\\pts-statics.paynet.com.tr\\Data\\MembershipUpload\\5605\\1.png",
"docurl":"https://pts-statics.paynet.com.tr/Data/MembershipUpload/5605/1.png",
"create_user":"",
"create_date":"2018-07-17T17:53:35.74"
},
{
"form_doc_id":3339,
"form_id":5605,
"doctype_id":2,
"doc_format":"png",
"docpath":"C:\\web\\pts-statics.paynet.com.tr\\Data\\MembershipUpload\\5605\\2.png",
"docurl":"https://pts-statics.paynet.com.tr/Data/MembershipUpload/5605/2.png",
"create_user":"",
"create_date":"2018-07-17T17:53:42.253"
},
{
"form_doc_id":3340,
"form_id":5605,
"doctype_id":3,
"doc_format":"png",
"docpath":"C:\\web\\pts-statics.paynet.com.tr\\Data\\MembershipUpload\\5605\\3.png",
"docurl":"https://pts-statics.paynet.com.tr/Data/MembershipUpload/5605/3.png",
"create_user":"",
"create_date":"2018-07-17T17:53:46.82"
},
{
"form_doc_id":3341,
"form_id":5605,
"doctype_id":99,
"doc_format":"pdf",
"docpath":"C:\\web\\pts-statics.paynet.com.tr\\Data\\MembershipUpload\\5605\\5605_99.pdf",
"docurl":"https://pts-statics.paynet.com.tr/Data/MembershipUpload/5605/5605_99.pdf",
"create_user":"",
"create_date":"2018-07-17T17:56:01.26"
}
],
"object_name":"membership_formdata",
"code":0,
"message":"Başarılı İşlem"
}
```
{% endtab %}
{% tab title="Service Url" %}
| Sistem | URL |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Canlı Sistem** | [https://api.paynet.com.tr\[/v1/membership/formdata\\\_get](https://doc.paynet.com.tr/uornek/servisler/basvuru/https:/api.paynet.com.tr\[/v1/membership/formdata\\_get)]\() |
| **Test Sistemi** | [https://pts-api.paynet.com.tr\[/v1/membership/formdata\\\_get](https://doc.paynet.com.tr/uornek/servisler/basvuru/https:/pts-api.paynet.com.tr\[/v1/membership/formdata\\_get)]\() |
| {% endtab %} | |
| {% endtabs %} | |
# Banka Kodları
| bank\_id | Açıklama |
| -------- | -------------- |
| **ADVT** | Advantage |
| **AXSS** | Axess |
| **BONS** | Bonus |
| **DENZ** | Denizbank |
| **FINS** | CardFinans |
| **KVYT** | Kuveyt Türk |
| **MAXM** | Maximum |
| **ODEA** | Odea |
| **PARF** | Paraf |
| **VAKF** | Vakıfbank |
| **WRLD** | WorldCard |
| **ZDGR** | Diğer Banka |
| **ZRTB** | Ziraat Bankası |
# Taksit Kodları
| instalment | Açıklama |
| ---------- | ------------- |
| **0** | **Tek çekim** |
| **3** | **3 taksit** |
| **6** | **6 taksit** |
| **9** | **9 taksit** |
# Hata Kodları
HTTP Status Kodlar , Hata Tipleri , Dönüş Kodları
# HTTP Status Kodlar
{% hint style="info" %}
Paynet API Servislerinde isteğin başarısını veya başarısızlığını göstermek için http yanıt kodlarını kullanır. Genel olarak 2XX aralığında kodları başarıyı gösterir. 4XX aralığındaki kodlar verilen bilgilerden kaynaklanan bir hatayı gösterir ve 5XX aralığındaki kodlar ise hatanın sunucu kaynaklı olduğunu işaret eder.Eğer servisler response olarak http 200 dönüyor ise dönen nesnenin içeriğinde “code” ve “message”, eğer http 200 harici bir http kodu dönüyor ise aşağıdaki formatta bir json cevabı döner.
{% endhint %}
#### Error Nesnesi
| Parametre İsmi | Anlamı |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **type** | Hatanın tipi. bknz.[Hata Tipleri](/uornek/genel-bilgiler/hata-kodlari/hata-tipleri) |
| **message** | Hata mesajı |
| **code** | Http Status Kodu bknz. [HTTP Status Kodlar](/uornek/genel-bilgiler/hata-kodlari/http-status-kodlar#http-status-kodlari) |
| **result\_code** | Dönüş kodu bknz.[Dönüş Kodları](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari) |
#### Http Status Kodları
| Hata Kodu | Anlamı |
| --------- | ----------------------------------------------- |
| **200** | **OK** – İşlem Başarılı |
| **400** | **Bad Request** – İstek Hatası |
| **401** | **Unauthorized** – API anahtarınız yanlış |
| **403** | **Forbidden** – Auth için yasak istek |
| **404** | **Not Found** – Bulunamadı |
| **405** | **Method Not Allowed** – izin verilmeyen yöntem |
# Hata Tipleri
| Parametre İsmi | Anlamı |
| --------------------------- | -------------------------------------------------------------- |
| **api\_error** | Paynet api'den kaynaklı beklenmedik bir hata |
| **invalid\_request\_error** | Gönderilen input parametreler doru değil ya da formatı yanlış. |
| **authorization\_error** | Doğrulama hatası |
| **no\_data\_error** | İşlem bulunamadı |
| **404 Not Found** | İstenen öğe yok(item null durumu) |
# Dönüş Kodları
| Dönüş Kodu | Anlamı |
| ---------- | ------------------------ |
| **0** | **successful** |
| **1** | **unsuccessful** |
| **2** | **companyblocked** |
| **3** | **agentblocked** |
| **4** | **agentnotfound** |
| **5** | **duplicatedata** |
| **6** | **noprocess** |
| **7** | **unauthorized** |
| **8** | **servererror** |
| **9** | **notimplemented** |
| **10** | **timeout** |
| **11** | **badrequest** |
| **12** | **nodata** |
| **13** | **paynetjnosession** |
| **14** | **paynetjwrongbin** |
| **15** | **paynetjunmatchtran** |
| **16** | **paynetj3derror** |
| **17** | **paynetjusedsession** |
| **18** | **wrongcarddata** |
| **19** | **wrongtransactiontype** |
| **20** | **wrongpostype** |
| **21** | **wrongratioget** |
| **100** | **oldsuccessful** |
# Veri Tipleri
# Status
| Durum | Açıklama |
| ----- | -------------- |
| **0** | Waiting |
| **3** | Done succeed |
| **4** | Done unsucceed |
| **5** | Cancel |
| **6** | Deleted |
# Kart Tipi
| Kart Tipi | Açıklama |
| --------- | ------------- |
| **bc** | Ticari kart |
| **cc** | Bireysel kart |
| **dc** | Debit kart |
# İşlem Tipi
| İşlem Tipi | Açıklama |
| ---------- | ---------------------- |
| **S** | Satış |
| **R** | İptal |
| **CD** | İade |
| **CR** | Finansallaştırma |
| **PI** | Puan İptal |
| **PK** | Puan Kullanımı |
| **PR** | Provizyon |
| **RC** | Finansallaştırma İptal |
| **RP** | Provizyon İptal |
# Test Kartları
Bu test kartlarını sitemizdeki demolarda ve Paynet API'yi sayfalarınıza entegre ederken kullanabilirsiniz.
| Kredi Kartı | Türü | Kart Numarası | Vade | CVV | 3D Şifresi |
| -------------- | ---------- | ---------------- | ----- | --- | ---------- |
| **AXESS** | Visa | 4355084355084358 | 12/18 | 000 | a |
| **AXESS** | MasterCard | 5571135571135575 | 12/18 | 000 | a |
| **CardFinans** | Visa | 5456165456165454 | 12/18 | 000 | a |
| **CardFinans** | MasterCard | 4022774022774026 | 12/18 | 000 | a |
| **WORLD** | Visa | 4506347011448053 | 02/20 | 000 | 3D Kapalı |
| **WORLD** | MasterCard | 5400637003737150 | 02/20 | 000 | 3D Kapalı |
| **Maximum** | Visa | 4508034508034509 | 12/18 | 000 | a |
| **Maximum** | MasterCard | 5406675406675403 | 12/18 | 000 | a |
| **Bonus** | Visa | 4282209004348015 | 09/18 | 123 | 3D Kapalı |
| **Bonus** | Amex | 375622005485014 | 10/20 | 123 | 3D Kapalı |
| **DenizBank** | Visa | 4090700102323514 | 11/21 | 834 | 123 |
| **Paraf** | Visa | 4531444531442283 | 12/20 | 001 | a |
| **Paraf** | MasterCard | 5818775818772285 | 12/18 | 001 | a |
# Sıkça Sorulan Sorular
## Hizmet bedeli tutarı müşterime yansıtmak istiyorum fakat yansımıyor.Sebebi nedir ?
Paynet script tagleri arasına **"data-add\_commission\_amount"** attribute' ünü **true** olarak setlemelisiniz.Default değeri **false**'dur. True olduğunda hizmet bedeli tutarı kredi kartından çekilecek tutara eklenir.
## Tanımlanan özel oran koduna ait ilgili oran kodlarını görüntüleyemiyorum. Sebebi nedir?
Birden çok özel oran tanımladıysanız ve görmek istediğiniz oranlara ait oran kodunu göndermiyorsanız tanımladıklarınız içerisinde varsayılan olarak işaretlediğiniz oran tanımına ait oranlar gelir. Varsayılan olarak işaretli oran tanımı yok ise default oranlar gelir.
## Api oran tanımındaki gösterilecek oran ve sabit oran arasındaki fark nedir?
Gösterilecek oran seçilirse ; oranlar değişse bile müşterilerinize gösterdiğiniz oranlar aynı olur ,fakat değişen oran miktarı kadar alacağınız tutar değişir. Sabit oranı seçerseniz ; değişen oran miktarı kadar müşterinize gösterdiğiniz oranlar değişir.
## Entegrasyon yapmak istiyorum. Yardımcı olur musunuz?
Paynet **API REST** servislerini kullanmaktadır.HTTP protokolü kullanılmasından dolayı API hatalarını göstermek için HTTP yanıt kodları kullanmak üzere tasarlanmıştır. API ile güvenli etkileşim sağlamak için **basic authentication** yapısı kullanılmaktadır. API Servisleri **json,XML** ve form parametresi olarak **application/x-www-form-urlencoded** formatlarını desteklemektedir. Tüm cevaplar json veya xml formatında dönebilmektedir.2 çeşit entegrasyon yapabilirsiniz:
* Custom Form
* Gömülü Form
Eğer custom form entegrasyonu yaparsanız; tasarımsal olarak istediğiniz şekilde kredi kartı girileceği ekranı tasarlayabilirsiniz.
Gömülü form entegasyonu yapacaksanız; api dokümantasyonundaki anlatıldığı gibi kolayca entegre olabilirsiniz.
Entegrasyon için formunuza eklediğiniz kredi kartı numarasını alacağınız input'a **data-paynet="number"** attribute'unu eklemeniz gerekiyor.Kredi kartından çekilecek tutarı alacağınız input'a **data-paynet="amount**" attribute'unu eklemeniz gerekiyor. Kredi kartı son kullanma tarihinin ay bilgisi aldığınız input'a **data-paynet="exp-month"** attribute'unu eklemeniz gerekiyor.
Script tag’ı içinde data-form attirubute’unde ödeme bilgilerinin alındığı form olmalıdır.Ayrıca data-key alanında ise sizinle paylaşılan publishable key i girmeniz gerekmektedir.Form elementindeki action attribute' ü customform entegrasyonu yapıldığında; charge işlemini yaptığınız linki setlemeniz gerekmektedir.
Ödemeyi onaylamak için **“v1/transaction/charge”** servisini çağırmanız gerekmektedir.Paynet.js ve ya Paynet-custom.js ile başlatılan gömülü ya da custom form entegrasyonlarında kredi kartı ödeme işlemini sonlandırmaya, kredi kartından ilgili tutarın çekiminin yapıldığı servistir. Bu servisi kullanmak için Paynet.js’in formunuza eklediği hidden session\_id ve token\_id bilgilerine ihtiyaç vardır.
Detaylı bilgi için**:** \*\*;
Diğer alanlar için detaylı bilgi : **** adresimizdeki dokümantasyonda bulunmaktadır.
## Tek çekim işlemlerde müşterime hizmet bedelini yansıtmamak için ne yapmalıyım?
Paynet'e **login** olduktan sonra **yönetim paneli** menüsünden yeni bir tane api oran tanımı tanımlamalısınız. Örnek olarak gösterilecek oran tipinde oran tanımınızı seçebilirsiniz.Daha sonra ilgili oran tanımı detayından tek çekim kısmındaki oranları 0 ' a setleyip kaydetmelisiniz. Daha sonra ilgili oran tanımına ait oran kodunu paynet script tagları arasına **"data-ratio\_code"** attribute üne setlemeniz gerekmektedir. **"data-add\_commission\_amount"** attribute' ünü true olarak setlerseniz hizmet bedeli tutarı kredi kartından çekilecek tutara eklenir, fakat tanımladığınız özel oran tanımında tek çekimde oranı 0 yaptığınız için tek çekimler de hizmet bedeli müşteriye yansıtılmamış olacaktır.
## Açılan ödeme popup' ında kendi logomu gösterebilir miyim?
Paynet script taglari arasına **"data-image"** attributende ilgili logonuza ait linki setlemeniz yeterlidir.\
Detaylı bilgi **** adresimizdeki dokümantasyonda bulunmaktadır.
## Sadece tek çekim oranlar gelmektedir.Sebebi nedir?
Paynet script tagları arasına **"data-no\_instalment"** attribute default değeri false dur.True olduğunda taksitli çekime izin vermez,tek çekim yapılır.True gönderdiğiniz halde sadece tek çekim oranları geliyorsa yönetim paneli üzerinden tanımlanan özel oranınız var ise oran tanımınız da diğer taksit seçeneklerinizin aktif olup olmadığını kontrol ediniz.Detaylı bilgi **** adresimizdeki dokümantasyonda bulunmaktadır.
## Unauthorized credential hatasının sebepleri nelerdir?
Bu hatanın 3 sebebi vardır:
1. Bayinizin, Charge işlemi sırasındaki ip adresi, tanımlı ip adresi listenizde yoktur. Bildirmeniz gerekmektedir. İp adresi static olmalıdır.
2. Canlı sistem yerine test sistemine veya test sistemi yerine canlı sisteme istek atıyorsunuzdur.
3. Yanlış keyler ile istek atmaya çalışıyorsunuzudur. Auth, check\_bin ve create\_token servislerinde public key ile istek atarken charge servisine istek atarken secret key ile istek atmalısınız. Detaylı bilgi **** adresimizdeki dokümantasyonda bulunmaktadır
## Ödeme onaylama(charge) servisine istek atılamaması
Ödeme işleminin tamamlanması için **“v1/transaction/charge”** servisinin çağırılması gerekmektedir.PCI güvenlik protokolleri gereği Charge işleminde tls 1.1 veya tls 1.2 üzerinden iletişim kurmanız gerekmektedir.Charge işleminde public key yerine secret key i gönderilmesi gerekmektedir. Ayrıca auth ve create\_token işlemlerinde oluşan session\_id ve token\_id değerlerini hidden bir alana setleyip charge yaparken setlediği değerlerin gönderilmesi gerekmektedir. İşlemin satış mı yoksa önprovizyon mu olduğunu belirleyebilmek için "transaction\_type": 1olarak bir parametre daha göndermelisiniz. ( 1 olarak gönderirseniz satış anlamına gelir.)
Detaylı bilgi için: ****
## MdStatus hata kodları
Aşağıda yer alan listede mdstatus kodlarını ve açıklamalarını görüntüleyebilirsiniz.
| MdStatus Hata Kodu | Açıklama |
| ------------------- | --------------------------------------------------------------------------------------------------- |
| 0 | 3-D Secure imzası geçersiz veya doğrulama yetersiz |
| 1 | Tam doğrulama |
| 2 | Kart sahibi veya bankası sisteme kayıtlı değil - Kart sahibi banka veya kart 3-D Secure üyesi değil |
| 3 | Kartın bankası sisteme kayıtlı değil - Kart prefixi 3-D Secure sisteminde tanımlı değil |
| 4 | Doğrulama denemesi,kart sahibi sisteme daha sonra kayıt olmayı seçmiş. |
| 5 | Doğrulama yapılamıyor - Sistem ulaşılabilir değil |
| 6 | 3-D Secure hatası |
| 7 | Sistem hatası |
| 8 | Bilinmeyen veya geçersiz kart no |
| 9 | Üye işyeri 3-D Secure sisteminde kayıtlı değil |
## Canlı sistemde karttan işlem geçememe hatası
Canlı sistemde test kartları ile işlem geçemezsiniz.Test kartı ile işlem geçmeye çalışmıyorsanız ekteki **mdstatus.xls** aracılığıyla sebebini öğrenebilirsiniz. İstek sonucunda response olarak eğer hata aldıysanız message kısmında ilgili sebebini sizlere dönmekteyiz.Ayrıca scriptte **“data-show\_tds\_error”** parametresini false olarak gönderip en sonda charge işlemi yaparsanız responseda **“is\_succeed”** false ise, **“paynet\_error\_message”** veya **“bank\_error\_message”** alanlarındaki açıklamayı kullanıcıya gösterebilirsiniz.
Detaylı bilgi **** adresimizdeki dokümantasyonda bulunmaktadır.
## 3D'siz işlem hatası
Paynet script tagları arasına **"data-tds\_required"** attribute default değeri false dur.False : Eğer işlem yapılacak POS 3D’siz işlemi destekliyor ise, kullanıcının 3D’siz de işlem yapmasına izin verir.True: Eğer işlem yapılacak POS 3D’siz işlemi destekliyor ise, kullanıcının 3D’siz de işlem yapmasını engeller.
Detaylı bilgi **** adresimizdeki dokümantasyonda bulunmaktadır
# Kart Saklama Süreci Hakkında
### Kart saklama ve saklı kart ile işlem yapma
* İşlem sırasında kartı saklamak istiyorsanız müşterinizin benzersiz (unique) bir bilgisine ihtiyacınız vardır ( userid, gsm no, e\_mail vs..).
* İlk defa kart saklama işlemi yaptığınızda **user\_unique\_id** parametresinde bu değeri göndermelisiniz.
* Daha sonra Paynet sizin müşterinize ait benzersiz **card\_owner\_id** üretir.
* Sizin de kendi sisteminizde kendi müşteri benzersiz değeri ile card\_owner\_id değerini ilişkilendirip saklamanız gerekir.
* Bir müşterinize bir kere kart saklama işlemi yaptıktan sonra kart saklama ya da saklı karttan işlem alma isteklerinde **card\_owner\_id** parametresi kullanılır.
{% hint style="info" %}
Bir müşterinizde ilk defa kart saklama yapılacaksa aşağıdaki bilgileri göndermelisiniz.
* **user\_unique\_id**
* **card\_save = "true"**
* **card\_desc = "kart açıklaması"**
{% endhint %}
{% hint style="info" %}
Daha önce kart saklama yapmış müşteriniz kart saklama yapacaksa aşağıdaki bilgileri göndermelisiniz.
* **card\_owner\_id**
* **card\_save = "true"**
* **card\_desc = "kart açıklaması"**
{% endhint %}
# Başlarken
Ödeme alma entegrasyon methodlarından birini seçip kolayca Paynet üzerinden ödemelerinizi alabilir, platform bağımsız REST servislerimizi kullanarak sistemlerinize entegre edebilirsiniz.
## Ödeme Metotları
| [**API Entegrasyonu**](/oedeme-metotlari/api-entegrasyonu) |
| ----------------------------------------------------------------------------------------------------------------------------------------- |
| Tüm platformlara uyumlu REST API servislerini kullanarak entegrasyon. Detaylı bilgi için [tıklayınız](/oedeme-metotlari/api-entegrasyonu) |
| [**Ortak Ödeme Sayfası**](/oedeme-metotlari/ortak-odeme-sayfasi) |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Ödeme sayfasını kendi altyapınızda barındırmak istemiyorsanız, PayLink entegrasyonumuzu ortak ödeme sayfası olarak kullanabilir, ödemelerinizi Paynet platformu üzerinden alabilirsiniz. Detaylı bilgi için [tıklayınız](/oedeme-metotlari/ortak-odeme-sayfasi). |
| [**PayLink**](/oedeme-metotlari/ortak-odeme-sayfasi) |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| SMS veya E-Posta ile göndereceğiniz güvenli bir link ile her yerden anında ödeme alın. Detaylı bilgi için [tıklayınız](/oedeme-metotlari/ortak-odeme-sayfasi) |
| [**Hazır Form**](/oedeme-metotlari/oedeme-butonu) |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Mevcut web sitenize ekleyeceğiniz bir JavaScript kodu ile kolayca ve hemen kredi kartı ödemelerinizi alabilirsiniz. Eklediğiniz JavaScript kodu web sitenize bir ödeme butonu ekler. Bu butona tıkladığınızda aşağıdaki gibi bir formda ödemelerinizi alabilirsiniz. Detaylı bilgi için tıklayınız
Demo için tıklayınız.
|
| [**Özelleştirilebilir Form**](/oedeme-metotlari/oezellestirilmis-form) |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Web sitenizde tasarımını ve şeklini kendiniz oluşturduğunuz formunuza ekleyeceğiniz bir JavaScript kodu ile Paynet ile ödemelerinizi alabilirsiniz. Detaylı bilgi için tıklayınız.
Demo için tıklayınız.
|
---
[Next Page](/llms-full.txt/1)