> For the complete documentation index, see [llms.txt](https://docs.iyzico.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iyzico.com/urunler/fiziki-pos/terminal-api-entegrasyonu/vuk-509-servisleri/odeme-ve-islem-servisleri.md). # Ödeme ve İşlem Servisleri ### Complete Payment ## POST /v2/terminal-host/payment > Bu servis, terminal üzerinde ödeme işlemini başlatır. Pos cihazı üzerinde kart okutularak ödeme işlemi tamamlanır.\ > Örnek: "Satış uygulamasının başlattığı işlemi complete ederek ödemeId/authCode vb. alanları alırsınız."\ > \ > Authorization (Bearer Token):\ > \- Token değeri OAuth token servisinden dönen access\_token'dır.\ > \- Header formatı:\ > Authorization: Bearer {access\_token}
```json {"openapi":"3.0.3","info":{"title":"Terminal API – Outside Flow","version":"1.0.3"},"tags":[{"name":"Terminal Host"}],"servers":[{"url":"https://api.iyzipay.com"},{"url":"https://sandbox-api.iyzipay.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer Token ile yetkilendirme.\nHeader formatı:\nAuthorization: Bearer {access_token}\n\naccess_token, OAuth token servisinden üretilir ve Terminal Host servislerinde kullanılır.\n"}},"schemas":{"CompletePaymentRequest":{"type":"object","required":["conversationId","locale","deviceUniqueId","transactionReferenceId","price","currency","installment","salesType"],"properties":{"conversationId":{"type":"string","description":"İstek ve yanıt eşleşmesi yapılacak ID değeri. Üye işyeri tarafından belirlenir, istekte gönderilen bilgi yanıtta geri döner."},"locale":{"type":"string","description":"Yanıt dili.","enum":["tr","en"]},"deviceUniqueId":{"type":"string","description":"İşlemin gerçekleştirildiği terminal / cihaz için tanımlı benzersiz kimlik bilgisi."},"transactionReferenceId":{"type":"string","description":"Satış uygulaması tarafından üretilen, bu satış işlemine ait uniqueId değeri."},"price":{"type":"number","format":"double","description":"Fiyat Değeri"},"currency":{"type":"string","description":"Para birimi"},"salesType":{"type":"string","description":"Satış Türü.","enum":["SALE","PRE_AUTH","POST_AUTH"]},"paymentId":{"type":"string","description":"Ödeme Numarası. Provizyon kapama, (postAuth) işlemi yapılacağı zaman gönderilmesi zorunlu bilgidir."},"installment":{"type":"integer","format":"int32","description":"Taksit Sayısı","enum":[0,1,2,3,4,5,6,7,8,9,10,11,12]}}},"TerminalPaymentSuccessResponse":{"type":"object","properties":{"conversationId":{"type":"string","description":"İstek–cevap eşleştirmesi ve işlem takibi için üye işyeri tarafından gönderilen benzersiz değer."},"locale":{"type":"string","description":"Yanıt dili","enum":["tr","en"]},"deviceUniqueId":{"type":"string","description":"İşlemin gerçekleştirildiği terminal / cihaz için tanımlı benzersiz kimlik bilgisi."},"transactionReferenceId":{"type":"string","description":"Satış uygulaması tarafından üretilen, işlem bazında benzersiz referans numarası."},"status":{"type":"string","description":"İşlem sonucu. (SUCCESS, FAILURE vb.)"},"errorCode":{"type":"string","description":"İşlem başarısız ise dönen hata kodu. Başarılı işlemlerde boş döner."},"errorMessage":{"type":"string","description":"\tHata oluşması durumunda açıklayıcı hata mesajı."},"errorGroup":{"type":"string","description":"Hatanın ait olduğu grup / kategori bilgisi."},"systemTime":{"type":"integer","format":"int64","description":"İşlemin iyzico sistemlerinde işlendiği zamanın Unix timestamp değeri."},"transactionDateTime":{"type":"string","description":"İşlemin terminal/host üzerinde gerçekleştiği tarih ve saat bilgisi (ISO-8601)."},"authCode":{"type":"string","description":"Banka/host tarafından üretilen onay (authorization) kodu."},"paymentId":{"type":"string","description":"iyzico tarafından üretilen, işlem bazında benzersiz ödeme kimliği."},"paymentDate":{"type":"string","description":"İşlemin muhasebeleştirildiği tarih (YYYYMMDD)."},"price":{"type":"number","format":"double","description":"İşlem tutarı."},"installment":{"type":"integer","format":"int32","description":"Taksit sayısı. Tek çekim işlemlerde 0 veya 1 olarak döner."},"currency":{"type":"string","description":"İşlem para birimi (örn. TRY)."},"binNumber":{"type":"string","description":"Kartın ilk 6 hanesi (BIN)."},"lastFourDigits":{"type":"string","description":"Kart numarasının son 4 hanesi."},"hostReference":{"type":"string","description":"Banka/host sistemi tarafından üretilen işlem referans numarası."},"cardType":{"type":"string","description":"Kart tipi. (CREDIT_CARD, DEBIT_CARD vb.)"},"acquirerId":{"type":"string","description":"İşlemi gerçekleştiren banka (acquirer) kurum kimliği."},"issuerId":{"type":"string","description":"Kartı çıkaran banka (issuer) kurum kimliği."},"bankMerchantId":{"type":"string","description":"Banka nezdinde üye işyerine tanımlı merchant numarası."},"bankTerminalId":{"type":"string","description":"Banka nezdinde terminal için tanımlı terminal numarası."},"batchNo":{"type":"string","description":"İşlemin dahil olduğu batch (günsonu) numarası."},"stanNo":{"type":"string","description":"Sistem Takip Numarası (STAN – System Trace Audit Number)."},"posEntryModeCode":{"type":"string","description":"Kart bilgilerinin POS'a giriş yöntemini belirten kod (örn. chip, manyetik, contactless)."},"cancelHostReference":{"type":"string","description":"İptal işlemi referans numarası"},"refundHostReference":{"type":"string","description":"İade işlemi referans numarası"}}},"TerminalFailureResponse":{"type":"object","properties":{"status":{"type":"string","description":"İşlem sonucu. (SUCCESS, FAILURE vb.)"},"errorCode":{"type":"string","description":"İşlem başarısız ise dönen hata kodu. Başarılı işlemlerde boş döner."},"errorMessage":{"type":"string","description":"Hata oluşması durumunda açıklayıcı hata mesajı."},"errorGroup":{"type":"string","description":"Hatanın ait olduğu grup / kategori bilgisi."},"systemTime":{"type":"integer","format":"int64","description":"İşlemin iyzico sistemlerinde işlendiği zamanın Unix timestamp değeri."},"consumerErrorMessage":{"type":"string","description":"Son kullanıcıya gösterilmek üzere üretilmiş, teknik detay içermeyen hata mesajı."}}}}},"paths":{"/v2/terminal-host/payment":{"post":{"tags":["Terminal Host"],"description":"Bu servis, terminal üzerinde ödeme işlemini başlatır. Pos cihazı üzerinde kart okutularak ödeme işlemi tamamlanır.\nÖrnek: \"Satış uygulamasının başlattığı işlemi complete ederek ödemeId/authCode vb. alanları alırsınız.\"\n\nAuthorization (Bearer Token):\n- Token değeri OAuth token servisinden dönen access_token'dır.\n- Header formatı:\n Authorization: Bearer {access_token}\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompletePaymentRequest"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TerminalPaymentSuccessResponse"}}}},"400":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TerminalFailureResponse"}}}}}}}}} ``` ### Örnek Collection
Postman
### Query Transaction Status ## POST /v2/terminal-host/payment/query-transaction-status > Bu servis, daha önce gerçekleşen bir işlemin durumunu sorgular.\ > Örnek: "paymentId ile ödeme durumunu ve varsa hata bilgilerini öğrenirsiniz."\ > \ > Authorization (Bearer Token):\ > \- Token değeri OAuth token servisinden dönen access\_token'dır.\ > \- Header formatı:\ > Authorization: Bearer {access\_token}\
```json {"openapi":"3.0.3","info":{"title":"Terminal API – Outside Flow","version":"1.0.3"},"tags":[{"name":"Terminal Host"}],"servers":[{"url":"https://api.iyzipay.com"},{"url":"https://sandbox-api.iyzipay.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer Token ile yetkilendirme.\nHeader formatı:\nAuthorization: Bearer {access_token}\n\naccess_token, OAuth token servisinden üretilir ve Terminal Host servislerinde kullanılır.\n"}},"schemas":{"QueryTransactionStatusRequest":{"type":"object","description":"İşlemin Durumunu Sorgulayan Servis.","required":["conversationId","locale","paymentId","deviceUniqueId","transactionReferenceId"],"properties":{"conversationId":{"type":"string","description":"İstek ve yanıt eşleşmesi yapılacak ID değeri. Üye işyeri tarafından belirlenir, istekte gönderilen bilgi yanıtta geri döner."},"locale":{"type":"string","description":"Yanıt dili.","enum":["tr","en"]},"paymentId":{"type":"string","description":"Sorgulanacak Ödeme Numarası"},"deviceUniqueId":{"type":"string","description":"İşlemin gerçekleştirildiği terminal / cihaz için tanımlı benzersiz kimlik bilgisi."},"transactionReferenceId":{"nullable":true,"oneOf":[{"type":"string"},{"type":"null"}],"description":"Sorgulanmak istenen payment/ void/refund işlemi için işlem sırasında üretilmiş eşsiz referans numarasıdır."}}},"TerminalPaymentSuccessResponse":{"type":"object","properties":{"conversationId":{"type":"string","description":"İstek–cevap eşleştirmesi ve işlem takibi için üye işyeri tarafından gönderilen benzersiz değer."},"locale":{"type":"string","description":"Yanıt dili","enum":["tr","en"]},"deviceUniqueId":{"type":"string","description":"İşlemin gerçekleştirildiği terminal / cihaz için tanımlı benzersiz kimlik bilgisi."},"transactionReferenceId":{"type":"string","description":"Satış uygulaması tarafından üretilen, işlem bazında benzersiz referans numarası."},"status":{"type":"string","description":"İşlem sonucu. (SUCCESS, FAILURE vb.)"},"errorCode":{"type":"string","description":"İşlem başarısız ise dönen hata kodu. Başarılı işlemlerde boş döner."},"errorMessage":{"type":"string","description":"\tHata oluşması durumunda açıklayıcı hata mesajı."},"errorGroup":{"type":"string","description":"Hatanın ait olduğu grup / kategori bilgisi."},"systemTime":{"type":"integer","format":"int64","description":"İşlemin iyzico sistemlerinde işlendiği zamanın Unix timestamp değeri."},"transactionDateTime":{"type":"string","description":"İşlemin terminal/host üzerinde gerçekleştiği tarih ve saat bilgisi (ISO-8601)."},"authCode":{"type":"string","description":"Banka/host tarafından üretilen onay (authorization) kodu."},"paymentId":{"type":"string","description":"iyzico tarafından üretilen, işlem bazında benzersiz ödeme kimliği."},"paymentDate":{"type":"string","description":"İşlemin muhasebeleştirildiği tarih (YYYYMMDD)."},"price":{"type":"number","format":"double","description":"İşlem tutarı."},"installment":{"type":"integer","format":"int32","description":"Taksit sayısı. Tek çekim işlemlerde 0 veya 1 olarak döner."},"currency":{"type":"string","description":"İşlem para birimi (örn. TRY)."},"binNumber":{"type":"string","description":"Kartın ilk 6 hanesi (BIN)."},"lastFourDigits":{"type":"string","description":"Kart numarasının son 4 hanesi."},"hostReference":{"type":"string","description":"Banka/host sistemi tarafından üretilen işlem referans numarası."},"cardType":{"type":"string","description":"Kart tipi. (CREDIT_CARD, DEBIT_CARD vb.)"},"acquirerId":{"type":"string","description":"İşlemi gerçekleştiren banka (acquirer) kurum kimliği."},"issuerId":{"type":"string","description":"Kartı çıkaran banka (issuer) kurum kimliği."},"bankMerchantId":{"type":"string","description":"Banka nezdinde üye işyerine tanımlı merchant numarası."},"bankTerminalId":{"type":"string","description":"Banka nezdinde terminal için tanımlı terminal numarası."},"batchNo":{"type":"string","description":"İşlemin dahil olduğu batch (günsonu) numarası."},"stanNo":{"type":"string","description":"Sistem Takip Numarası (STAN – System Trace Audit Number)."},"posEntryModeCode":{"type":"string","description":"Kart bilgilerinin POS'a giriş yöntemini belirten kod (örn. chip, manyetik, contactless)."},"cancelHostReference":{"type":"string","description":"İptal işlemi referans numarası"},"refundHostReference":{"type":"string","description":"İade işlemi referans numarası"}}},"TerminalFailureResponse":{"type":"object","properties":{"status":{"type":"string","description":"İşlem sonucu. (SUCCESS, FAILURE vb.)"},"errorCode":{"type":"string","description":"İşlem başarısız ise dönen hata kodu. Başarılı işlemlerde boş döner."},"errorMessage":{"type":"string","description":"Hata oluşması durumunda açıklayıcı hata mesajı."},"errorGroup":{"type":"string","description":"Hatanın ait olduğu grup / kategori bilgisi."},"systemTime":{"type":"integer","format":"int64","description":"İşlemin iyzico sistemlerinde işlendiği zamanın Unix timestamp değeri."},"consumerErrorMessage":{"type":"string","description":"Son kullanıcıya gösterilmek üzere üretilmiş, teknik detay içermeyen hata mesajı."}}}}},"paths":{"/v2/terminal-host/payment/query-transaction-status":{"post":{"tags":["Terminal Host"],"summary":null,"description":"Bu servis, daha önce gerçekleşen bir işlemin durumunu sorgular.\nÖrnek: \"paymentId ile ödeme durumunu ve varsa hata bilgilerini öğrenirsiniz.\"\n\nAuthorization (Bearer Token):\n- Token değeri OAuth token servisinden dönen access_token'dır.\n- Header formatı:\n Authorization: Bearer {access_token}\n\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryTransactionStatusRequest"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TerminalPaymentSuccessResponse"}}}},"400":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TerminalFailureResponse"}}}}}}}}} ``` {% hint style="warning" %} #### Query Status – Önemli Not Query Status servisinde paymentId, transactionReferenceId ve deviceUniqueId alanlarının **tamamı aynı anda zorunlu değildir**.\ Servisin çalışabilmesi için aşağıdaki alan kombinasyonlarından **en az biri** gönderilmelidir: * **Sadece paymentId gönderilirse**\ İlgili satış (payment) işleminin bilgileri döner. * **transactionReferenceId + deviceUniqueId birlikte gönderilirse**\ İlgili payment / void / refund işlemleri sorgulanabilir. * **paymentId + transactionReferenceId birlikte gönderilirse**\ Satış işlemi ile birlikte, ödeme ilişkili void ve refund işlemleri de sorgulanabilir. {% endhint %} ### Örnek Collection
Postman
### Void Payment ## POST /v2/terminal-host/payment/void > Bu servis, uygun durumdaki bir ödemeyi iptal eder.\ > Örnek: "paymentId ve paymentDate ile iptal işlemi başlatılır. Kart pos cihazı üzerinde okutularak iptal işlemi tamamlanır."\ > \ > Authorization (Bearer Token):\ > \- Token değeri OAuth token servisinden dönen access\_token'dır.\ > \- Header formatı:\ > Authorization: Bearer {access\_token}
```json {"openapi":"3.0.3","info":{"title":"Terminal API – Outside Flow","version":"1.0.3"},"tags":[{"name":"Terminal Host"}],"servers":[{"url":"https://api.iyzipay.com"},{"url":"https://sandbox-api.iyzipay.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer Token ile yetkilendirme.\nHeader formatı:\nAuthorization: Bearer {access_token}\n\naccess_token, OAuth token servisinden üretilir ve Terminal Host servislerinde kullanılır.\n"}},"schemas":{"VoidPaymentRequest":{"description":"Ödeme İade Servisi.","type":"object","required":["conversationId","locale","paymentId","paymentDate","deviceUniqueId","transactionReferenceId"],"properties":{"conversationId":{"type":"string","description":"İstek ve yanıt eşleşmesi yapılacak ID değeri. Üye işyeri tarafından belirlenir, istekte gönderilen bilgi yanıtta geri döner."},"locale":{"type":"string","description":"Yanıt dili.","enum":["tr","en"]},"paymentId":{"type":"string","description":"İptal Edilecek Ödeme Numarası"},"paymentDate":{"type":"string","description":"İşlemin muhasebeleştirildiği tarih (YYYYMMDD)."},"deviceUniqueId":{"type":"string","description":"İşlemin gerçekleştirildiği terminal / cihaz için tanımlı benzersiz kimlik bilgisi."},"transactionReferenceId":{"type":"string","description":"İptal işlemine ait üretilen benzersiz bir referans numarası"},"reason":{"type":"string","description":"İptal nedi"},"description":{"type":"string","description":"İptal açıklaması"}}},"TerminalPaymentSuccessResponse":{"type":"object","properties":{"conversationId":{"type":"string","description":"İstek–cevap eşleştirmesi ve işlem takibi için üye işyeri tarafından gönderilen benzersiz değer."},"locale":{"type":"string","description":"Yanıt dili","enum":["tr","en"]},"deviceUniqueId":{"type":"string","description":"İşlemin gerçekleştirildiği terminal / cihaz için tanımlı benzersiz kimlik bilgisi."},"transactionReferenceId":{"type":"string","description":"Satış uygulaması tarafından üretilen, işlem bazında benzersiz referans numarası."},"status":{"type":"string","description":"İşlem sonucu. (SUCCESS, FAILURE vb.)"},"errorCode":{"type":"string","description":"İşlem başarısız ise dönen hata kodu. Başarılı işlemlerde boş döner."},"errorMessage":{"type":"string","description":"\tHata oluşması durumunda açıklayıcı hata mesajı."},"errorGroup":{"type":"string","description":"Hatanın ait olduğu grup / kategori bilgisi."},"systemTime":{"type":"integer","format":"int64","description":"İşlemin iyzico sistemlerinde işlendiği zamanın Unix timestamp değeri."},"transactionDateTime":{"type":"string","description":"İşlemin terminal/host üzerinde gerçekleştiği tarih ve saat bilgisi (ISO-8601)."},"authCode":{"type":"string","description":"Banka/host tarafından üretilen onay (authorization) kodu."},"paymentId":{"type":"string","description":"iyzico tarafından üretilen, işlem bazında benzersiz ödeme kimliği."},"paymentDate":{"type":"string","description":"İşlemin muhasebeleştirildiği tarih (YYYYMMDD)."},"price":{"type":"number","format":"double","description":"İşlem tutarı."},"installment":{"type":"integer","format":"int32","description":"Taksit sayısı. Tek çekim işlemlerde 0 veya 1 olarak döner."},"currency":{"type":"string","description":"İşlem para birimi (örn. TRY)."},"binNumber":{"type":"string","description":"Kartın ilk 6 hanesi (BIN)."},"lastFourDigits":{"type":"string","description":"Kart numarasının son 4 hanesi."},"hostReference":{"type":"string","description":"Banka/host sistemi tarafından üretilen işlem referans numarası."},"cardType":{"type":"string","description":"Kart tipi. (CREDIT_CARD, DEBIT_CARD vb.)"},"acquirerId":{"type":"string","description":"İşlemi gerçekleştiren banka (acquirer) kurum kimliği."},"issuerId":{"type":"string","description":"Kartı çıkaran banka (issuer) kurum kimliği."},"bankMerchantId":{"type":"string","description":"Banka nezdinde üye işyerine tanımlı merchant numarası."},"bankTerminalId":{"type":"string","description":"Banka nezdinde terminal için tanımlı terminal numarası."},"batchNo":{"type":"string","description":"İşlemin dahil olduğu batch (günsonu) numarası."},"stanNo":{"type":"string","description":"Sistem Takip Numarası (STAN – System Trace Audit Number)."},"posEntryModeCode":{"type":"string","description":"Kart bilgilerinin POS'a giriş yöntemini belirten kod (örn. chip, manyetik, contactless)."},"cancelHostReference":{"type":"string","description":"İptal işlemi referans numarası"},"refundHostReference":{"type":"string","description":"İade işlemi referans numarası"}}},"TerminalFailureResponse":{"type":"object","properties":{"status":{"type":"string","description":"İşlem sonucu. (SUCCESS, FAILURE vb.)"},"errorCode":{"type":"string","description":"İşlem başarısız ise dönen hata kodu. Başarılı işlemlerde boş döner."},"errorMessage":{"type":"string","description":"Hata oluşması durumunda açıklayıcı hata mesajı."},"errorGroup":{"type":"string","description":"Hatanın ait olduğu grup / kategori bilgisi."},"systemTime":{"type":"integer","format":"int64","description":"İşlemin iyzico sistemlerinde işlendiği zamanın Unix timestamp değeri."},"consumerErrorMessage":{"type":"string","description":"Son kullanıcıya gösterilmek üzere üretilmiş, teknik detay içermeyen hata mesajı."}}}}},"paths":{"/v2/terminal-host/payment/void":{"post":{"tags":["Terminal Host"],"summary":null,"description":"Bu servis, uygun durumdaki bir ödemeyi iptal eder.\nÖrnek: \"paymentId ve paymentDate ile iptal işlemi başlatılır. Kart pos cihazı üzerinde okutularak iptal işlemi tamamlanır.\"\n\nAuthorization (Bearer Token):\n- Token değeri OAuth token servisinden dönen access_token'dır.\n- Header formatı:\n Authorization: Bearer {access_token}\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VoidPaymentRequest"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TerminalPaymentSuccessResponse"}}}},"422":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TerminalFailureResponse"}}}}}}}}} ``` ### Örnek Collection
Postman
### Refund Payment ## POST /v2/terminal-host/payment/refund > Bu servis, uygun durumdaki bir ödemeye iade işlemi uygular (partial/total).\ > Örnek: "paymentId ve price ile iade işlemi başlatılır. Kart pos cihazı üzerinde okutularak iptal işlemi tamamlanır."\ > \ > Authorization (Bearer Token):\ > \- Token değeri OAuth token servisinden dönen access\_token'dır.\ > \- Header formatı:\ > Authorization: Bearer {access\_token}
```json {"openapi":"3.0.3","info":{"title":"Terminal API – Outside Flow","version":"1.0.3"},"tags":[{"name":"Terminal Host"}],"servers":[{"url":"https://api.iyzipay.com"},{"url":"https://sandbox-api.iyzipay.com"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer Token ile yetkilendirme.\nHeader formatı:\nAuthorization: Bearer {access_token}\n\naccess_token, OAuth token servisinden üretilir ve Terminal Host servislerinde kullanılır.\n"}},"schemas":{"RefundPaymentRequest":{"type":"object","required":["conversationId","locale","paymentId","deviceUniqueId","price","transactionReferenceId","paymentDate"],"properties":{"conversationId":{"type":"string","description":"İstek ve yanıt eşleşmesi yapılacak ID değeri. Üye işyeri tarafından belirlenir, istekte gönderilen bilgi yanıtta geri döner."},"locale":{"type":"string","description":"İstek dili.","enum":["tr","en"]},"paymentId":{"type":"string","description":"İade yapılacak ödeme numarası"},"deviceUniqueId":{"type":"string","description":"İşlemin gerçekleştirildiği terminal / cihaz için tanımlı benzersiz kimlik bilgisi."},"price":{"type":"number","format":"double","description":"İşlem tutarı."},"transactionReferenceId":{"type":"string","description":"İade işlemi için satış uygulaması tarafından üretilen, benzersiz referans numarası."},"paymentDate":{"type":"string","description":"İşlemin muhasebeleştirildiği tarih (YYYYMMDD)."},"reason":{"type":"string","description":"İade Nedeni"},"description":{"type":"string","description":"İade Açıklaması"}}},"TerminalPaymentSuccessResponse":{"type":"object","properties":{"conversationId":{"type":"string","description":"İstek–cevap eşleştirmesi ve işlem takibi için üye işyeri tarafından gönderilen benzersiz değer."},"locale":{"type":"string","description":"Yanıt dili","enum":["tr","en"]},"deviceUniqueId":{"type":"string","description":"İşlemin gerçekleştirildiği terminal / cihaz için tanımlı benzersiz kimlik bilgisi."},"transactionReferenceId":{"type":"string","description":"Satış uygulaması tarafından üretilen, işlem bazında benzersiz referans numarası."},"status":{"type":"string","description":"İşlem sonucu. (SUCCESS, FAILURE vb.)"},"errorCode":{"type":"string","description":"İşlem başarısız ise dönen hata kodu. Başarılı işlemlerde boş döner."},"errorMessage":{"type":"string","description":"\tHata oluşması durumunda açıklayıcı hata mesajı."},"errorGroup":{"type":"string","description":"Hatanın ait olduğu grup / kategori bilgisi."},"systemTime":{"type":"integer","format":"int64","description":"İşlemin iyzico sistemlerinde işlendiği zamanın Unix timestamp değeri."},"transactionDateTime":{"type":"string","description":"İşlemin terminal/host üzerinde gerçekleştiği tarih ve saat bilgisi (ISO-8601)."},"authCode":{"type":"string","description":"Banka/host tarafından üretilen onay (authorization) kodu."},"paymentId":{"type":"string","description":"iyzico tarafından üretilen, işlem bazında benzersiz ödeme kimliği."},"paymentDate":{"type":"string","description":"İşlemin muhasebeleştirildiği tarih (YYYYMMDD)."},"price":{"type":"number","format":"double","description":"İşlem tutarı."},"installment":{"type":"integer","format":"int32","description":"Taksit sayısı. Tek çekim işlemlerde 0 veya 1 olarak döner."},"currency":{"type":"string","description":"İşlem para birimi (örn. TRY)."},"binNumber":{"type":"string","description":"Kartın ilk 6 hanesi (BIN)."},"lastFourDigits":{"type":"string","description":"Kart numarasının son 4 hanesi."},"hostReference":{"type":"string","description":"Banka/host sistemi tarafından üretilen işlem referans numarası."},"cardType":{"type":"string","description":"Kart tipi. (CREDIT_CARD, DEBIT_CARD vb.)"},"acquirerId":{"type":"string","description":"İşlemi gerçekleştiren banka (acquirer) kurum kimliği."},"issuerId":{"type":"string","description":"Kartı çıkaran banka (issuer) kurum kimliği."},"bankMerchantId":{"type":"string","description":"Banka nezdinde üye işyerine tanımlı merchant numarası."},"bankTerminalId":{"type":"string","description":"Banka nezdinde terminal için tanımlı terminal numarası."},"batchNo":{"type":"string","description":"İşlemin dahil olduğu batch (günsonu) numarası."},"stanNo":{"type":"string","description":"Sistem Takip Numarası (STAN – System Trace Audit Number)."},"posEntryModeCode":{"type":"string","description":"Kart bilgilerinin POS'a giriş yöntemini belirten kod (örn. chip, manyetik, contactless)."},"cancelHostReference":{"type":"string","description":"İptal işlemi referans numarası"},"refundHostReference":{"type":"string","description":"İade işlemi referans numarası"}}},"TerminalFailureResponse":{"type":"object","properties":{"status":{"type":"string","description":"İşlem sonucu. (SUCCESS, FAILURE vb.)"},"errorCode":{"type":"string","description":"İşlem başarısız ise dönen hata kodu. Başarılı işlemlerde boş döner."},"errorMessage":{"type":"string","description":"Hata oluşması durumunda açıklayıcı hata mesajı."},"errorGroup":{"type":"string","description":"Hatanın ait olduğu grup / kategori bilgisi."},"systemTime":{"type":"integer","format":"int64","description":"İşlemin iyzico sistemlerinde işlendiği zamanın Unix timestamp değeri."},"consumerErrorMessage":{"type":"string","description":"Son kullanıcıya gösterilmek üzere üretilmiş, teknik detay içermeyen hata mesajı."}}}}},"paths":{"/v2/terminal-host/payment/refund":{"post":{"tags":["Terminal Host"],"description":"Bu servis, uygun durumdaki bir ödemeye iade işlemi uygular (partial/total).\nÖrnek: \"paymentId ve price ile iade işlemi başlatılır. Kart pos cihazı üzerinde okutularak iptal işlemi tamamlanır.\"\n\nAuthorization (Bearer Token):\n- Token değeri OAuth token servisinden dönen access_token'dır.\n- Header formatı:\n Authorization: Bearer {access_token}\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefundPaymentRequest"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TerminalPaymentSuccessResponse"}}}},"400":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TerminalFailureResponse"}}}}}}}}} ``` ### Örnek Collection
Postman