---
title: "Alt Üye Oluşturma"
method: POST
path: "/onboarding/submerchant"
tags: ["Pazaryeri"]
---

# Alt Üye Oluşturma

`POST /onboarding/submerchant`

Pazaryeri (marketplace) modelinde alt üye işyerini oluşturur. **Bireysel**, **Şahıs Şirketi** ve **Limited/Anonim** tipleri desteklenir. Oluşturulacak alt üye işyeri tipi, **subMerchantType** parametresine göre belirlenir.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- union — Oluşturulacak **subMerchantType**’a göre gövde alanları değişir.
  - SubmerchantPersonalRequest — Bireysel Alt Üye İşyeri
    - `subMerchantType` 'PERSONAL' | 'PRIVATE_COMPANY' | 'LIMITED_OR_JOINT_STOCK_COMPANY', required — Alt üye işyeri tipi. Bireysel için PERSONAL gönderilmelidir.
    - `name` string — Alt üye işyeri adı.
    - `email` string, required — Alt üye e-posta adresi.
    - `gsmNumber` string, required — Alt üye telefon numarası.
    - `address` string, required — Alt üye adresi.
    - `iban` string — Alt üye IBAN bilgisi. **contactName/contactSurname** ile uyumlu olmalıdır. Alt üye işyeri oluşturulurken gönderilmezse, para gönderimi yapılabilmesi için ürün onayı öncesi mutlaka doldurulmalıdır.
    - `contactName` string, required — Alt üye iletişim adı.
    - `contactSurname` string, required — Alt üye iletişim soyadı.
    - `subMerchantExternalId` string, required — Alt üye işyeri tekil dış ID’si. Üye işyeri tarafından oluşturulan bir değerdir. Sisteminizdeki alt üye ile eşleştirmek için bir değer belirleyebilirsiniz.
    - `identityNumber` string, required — TCKN Bilgisi
    - `currency` 'TRY' | 'USD' | 'EUR' | 'GBP' | 'RUB' | 'CHF' | 'NOK' — Para birimi (varsayılan TL).
    - `locale` 'tr' | 'en' — Yanıt dili.
    - `conversationId` string — İstek/yanıt eşleştirmesi için ID.
  - SubmerchantPrivateCompanyRequest — Şahıs Şirketi
    - `subMerchantType` 'PERSONAL' | 'PRIVATE_COMPANY' | 'LIMITED_OR_JOINT_STOCK_COMPANY', required — Alt üye tipi. Şahıs şirketi için "PRIVATE_COMPANY" olarak gönderilmelidir.
    - `name` string — Alt üye işyeri adı.
    - `email` string, required — Alt üye e-posta adresi.
    - `gsmNumber` string, required — Alt üye telefon numarası.
    - `address` string, required — Alt üye adresi.
    - `iban` string — Alt üye IBAN bilgisi. **legalCompanyTitle** ile uyumlu olmalıdır. Alt üye işyeri oluşturulurken gönderilmezse, para gönderimi yapılabilmesi için ürün onayı öncesi mutlaka doldurulmalıdır.
    - `taxOffice` string, required — Vergi dairesi.
    - `taxNumber` string — Vergi numarası.
    - `legalCompanyTitle` string, required — Yasal şirket unvanı.
    - `subMerchantExternalId` string, required — Alt üye işyeri tekil dış ID’si. Üye işyeri tarafından oluşturulan bir değerdir. Sisteminizdeki alt üye ile eşleştirmek için bir değer belirleyebilirsiniz.
    - `identityNumber` string — TCKN Bilgisi
    - `currency` 'TRY' | 'USD' | 'EUR' | 'GBP' | 'RUB' | 'CHF' | 'NOK' — Para birimi (varsayılan TL).
    - `locale` 'tr' | 'en'
    - `conversationId` string
  - SubmerchantLimitedJointRequest — Limited/Anonim Şirketi
    - `subMerchantType` 'PERSONAL' | 'PRIVATE_COMPANY' | 'LIMITED_OR_JOINT_STOCK_COMPANY', required — Alt üye tipi. Limited/Anonim şirket tipi için "LIMITED_OR_JOINT_STOCK_COMPANY" olarak gönderilmelidir.
    - `name` string — Alt üye işyeri adı.
    - `email` string, required — Alt üye e-posta adresi.
    - `gsmNumber` string, required — Alt üye telefon numarası.
    - `address` string, required — Alt üye adresi.
    - `iban` string — Alt üye IBAN bilgisi. **legalCompanyTitle** ile uyumlu olmalıdır. Alt üye işyeri oluşturulurken gönderilmezse, para gönderimi yapılabilmesi için ürün onayı öncesi mutlaka doldurulmalıdır.
    - `taxOffice` string, required — Vergi dairesi.
    - `taxNumber` string, required — Vergi numarası.
    - `legalCompanyTitle` string, required — Yasal şirket unvanı.
    - `subMerchantExternalId` string, required — Alt üye işyeri tekil dış ID’si. Üye işyeri tarafından oluşturulan bir değerdir. Sisteminizdeki alt üye ile eşleştirmek için bir değer belirleyebilirsiniz.
    - `identityNumber` string — TCKN Bilgisi
    - `currency` 'TRY' | 'USD' | 'EUR' | 'GBP' | 'RUB' | 'CHF' | 'NOK' — Para birimi (varsayılan TL).
    - `locale` 'tr' | 'en'
    - `conversationId` string

## Response `200`

Başarılı yanıt

- SubmerchantCreateResponse
  - `status` 'success' | 'failure' — İşlem sonucu.
  - `locale` 'tr' | 'en' — Yanıt dili.
  - `systemTime` integer — İşlem zamanı (epoch ms).
  - `conversationId` string — İstek sırasında gönderilen ID.
  - `subMerchantKey` string — Oluşturulan alt üye anahtarı.

## Other responses

- `400` — Başarısız yanıt

---

[API](https://skmtc.net/iyzico/apis/bin-and-installment.md) · [All operations](https://skmtc.net/iyzico/apis/bin-and-installment/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iyzico/bin-and-installment/versions/46976ce5eed9/schema)