# Payment Facilitator (Ödeme Aracısı) İşlemleri

### Payment Facilitator (Ödeme Aracısı) İşlemleri

**Payment Facilitator (PF) modeli**, bir **ana işyerinin (PF)** kendi çatısı altında birden fazla **alt işyeri (submerchant)** adına işlem gerçekleştirebilmesini sağlayan özel bir ödeme altyapısıdır.

***

#### PF Modelinin Temel Yapısı

* **PF,** VPOS sisteminde tanımlı bir ana işyeri olarak işlem yapar.
* **Alt işyerleri (submerchant)** VPOS sisteminde **tanımlanmaz veya kayıt altına alınmaz**.
* Alt işyeri bilgileri, **her işlem sırasında dinamik olarak** gönderilir.
* **PF,** VPOS sisteminde tanımlı tüm servisleri, yetkisi dahilinde alt işyerleri için kullanabilir. [Servis listeleri için bknz](/api-listesi.md)
* Alt işyeri bilgileri yalnızca işlem bazlı olarak **raporlarda izlenebilir.**

####  İşlem Akışı

1. **PF,** alt işyeri adına işlem başlatır.
2. İlgili servis çağrısında **alt işyeri bilgileri (subMerchant alanları) eksiksiz şekilde iletilir.**
3. VPOS sistemi, bu bilgileri işlem kaydına ekler.
4. İşlem, **PF** üzerinden yönlendirilerek güvenli şekilde tamamlanır.
5. Alt işyeri bilgileri, **işlem raporlarında görüntülenebilir.**

#### Dikkat Edilmesi Gerekenler

* **PF** işlemleri yalnızca bu yetkiye sahip işyerleri tarafından yapılabilir.
* Alt işyeri bilgileri **VPOS sisteminde kayıtlı değildir**, bu nedenle her işlemde yeniden gönderilmelidir.
* `subMerchantId` alanı **zorunludur** ve değer hatalı gönderilirse işlem onaylanmaz.
* **Diğer subMerchant alanlarının eksik veya hatalı olması işlem reddine veya raporlama sorunlarına yol açabilir.**

#### İstekte beklenen ek subMerchant Alanları

<table data-full-width="false"><thead><tr><th>Alan Adı</th><th width="89">Tip</th><th width="116">Uzunluk</th><th>Açıklama</th></tr></thead><tbody><tr><td>subMerchantId<mark style="color:red;">*</mark></td><td>string</td><td>15</td><td>Alt işyerinin benzersiz kimliği</td></tr><tr><td>subMerchantName<mark style="color:red;">*</mark></td><td>string</td><td>40</td><td>Alt işyerinin ticari adı</td></tr><tr><td>subMerchantMcc<mark style="color:red;">*</mark></td><td>string</td><td>4</td><td>Alt işyerinin MCC (iş kolu) kodu</td></tr><tr><td>subMerchantPostalCode<mark style="color:red;">*</mark></td><td>string</td><td>10</td><td>Alt işyerinin posta kodu</td></tr><tr><td>subMerchantCity<mark style="color:red;">*</mark></td><td>string</td><td>20</td><td>Alt işyerinin şehir bilgisi</td></tr><tr><td>subMerchantCountryCode<mark style="color:red;">*</mark></td><td>string</td><td>3</td><td>Alt işyerinin ülke kodu (numerik ISO formatı)</td></tr></tbody></table>

{% hint style="warning" %}
&#x20;Not: Bu alanlar, PF işlemlerinde ilgili servis çağrısına dahil edilmelidir. Eksik veya hatalı gönderim durumunda işlem geçersiz sayılabilir.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-vpos.halkode.com.tr/api-listesi/payment-facilitator-odeme-aracisi-islemleri.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.