> 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/ceppos-app2app/app2app-v3.md).

# App2App V3

iyzico In-Store API V3, fiziksel satış noktalarında (POS) dijital ödeme deneyimi sunmak için tasarlanmış bir REST API'dir. Tüm istekler `x-api-key`, `x-secret-key` ve `x-merchant-id` header'ları ile kimlik doğrulamasından geçer; yanıtlar JSON formatında döner.

### **Entegrasyon Akışı**

```mermaid
sequenceDiagram
    participant App as Müşteri Uygulaması
    participant BE as Backend Sunucu
    participant CP as iyzico CepPOS

    Note over App,CP: 1. Kullanıcı Listeleme (Opsiyonel)
    App->>BE: Kullanıcı listesi talep et
    BE->>CP: GET /user/list
    CP-->>BE: userList 
    BE-->>App: Liste gösterilir
    App->>App: Kullanıcı seçilir (userId alınır)

    Note over App,CP: 2. Ödeme Başlatma
    App->>BE: Ödeme başlat 
    BE->>CP: POST /payment/init
    CP-->>BE: deepLinkUrl + paymentSessionToken + paymentId döner
    BE-->>App: deepLinkUrl iletilir
    App->>CP: deepLinkUrl ile iyzico uygulaması açılır
    App->>CP: Müşteri ödemeyi onaylar
    CP-->>BE: Şifreli data callback URL'e POST edilir

    Note over App,CP: 3. Şifre Çözme
    BE->>CP: POST /crypt/decrypt (data + paymentSessionToken)
    CP-->>BE: paymentStatus (SUCCESS/FAILURE) + amount + orderId döner
    BE-->>App: Ödeme sonucu gösterilir

    Note over App,CP: 4. Sorgulama 
    App->>BE: Ödeme durumu sorgula
    BE->>CP: GET /payment/query
    CP-->>BE: paymentStatus + amount + orderId + userId döner
    BE-->>App: Ödeme sonucu gösterilir
```

<table><thead><tr><th data-type="content-ref">Prod APK</th><th data-type="files">Test APK</th></tr></thead><tbody><tr><td><a href="https://play.google.com/store/apps/details?id=com.provisionpay.softpos.iyzico&#x26;hl=tr">https://play.google.com/store/apps/details?id=com.provisionpay.softpos.iyzico&#x26;hl=tr</a></td><td><a href="/files/8b5pseqD1euM2RJ0Ge1h">/files/8b5pseqD1euM2RJ0Ge1h</a></td></tr></tbody></table>

Cep POS özelliğini kullanabilmek için iyzico üye iş yerleri, hiçbir ek başvuru sürecine ihtiyaç duymadan “iyzico İşim İçin” mobil uygulamasının son sürümü üzerinden iyzico Cep POS’u aktif hale getirebilir ve ödeme almaya başlayabilir.