> 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/fiziksel-pos/terminal-api-entegrasyonu/vuk-507-servisleri.md).

# VUK 507 Servisleri

### Genel Bakış

VUK 507 servisleri, fiziksel POS cihazları üzerinden gerçekleştirilen standart satış, iade, iptal ve gün sonu işlemlerini kapsar.

Bu yapı, e-fatura süreçlerinden bağımsız olarak çalışır ve klasik POS ödeme akışını temel alır.

### Kapsam

Bu bölümde aşağıdaki işlemler ele alınmaktadır:

* Satış (Payment)
* İade (Refund)
* İptal (Void)
* İşlem Sorgulama (Query)
* İade Edilebilir Satış Bilgisi
* Kısmi Ödeme (Partial Payment)
* Gün Sonu (End of Day)

### Authentication

Tüm servis çağrılarında OAuth2 tabanlı kimlik doğrulama kullanılmaktadır.

> Authorization: Bearer {access\_token}\
> Content-Type: application/json

{% hint style="warning" %}
Not: Access token, Login İşlemleri adımında alınır ve tüm servislerde zorunludur.
{% endhint %}

### Genel Ödeme Akışı

```mermaid
sequenceDiagram
    autonumber
    participant CashRegister as Satış Uygulaması
    participant Iyzico as iyzico Terminal API
    participant GMU as GMU Cihazı
    participant Bank as Banka / Acquirer

    CashRegister->>Iyzico: POST /v2/terminal-host/gmu/payment
    Note right of CashRegister: Authorization Bearer access_token
    Iyzico->>GMU: Satış isteğini iletir
    GMU->>Bank: Ödeme provizyonu başlatılır
    Bank-->>GMU: İşlem sonucu
    GMU-->>Iyzico: Ödeme sonucu ve işlem detayları
    Iyzico-->>CashRegister: Sale response döner

    alt İşlem başarılı
        Note over CashRegister,Iyzico: paymentId, authCode, hostReference döner
    else İşlem başarısız
        Note over CashRegister,Iyzico: status failure, errorCode, errorMessage döner
    end
```