API referansı · 6 uç nokta

Admin · Sellers

Satıcı kaydı ve makine anahtarı üretimi. ADMIN rolü gerekir. Self-servis kayıt bilerek yoktur: satıcı, arkasında sözleşme olan ticari bir ilişkidir. Anahtar yalnızca üretim yanıtında bir kez görünür.

GET /v1/admin/sellers Bearer

Satıcıları listeler

Yanıtlar

Durum	Gövde	Açıklama
200	`SellerDto[]`	Satıcılar.
401	`ApiError`	`missing_token`, `invalid_token` veya `unauthenticated`.
403	`ApiError`	`insufficient_role` — kimlik doğru, rol yetkili değil.

POST /v1/admin/sellers Bearer

Satıcı oluşturur

paymentCollector varsayılanı PLATFORM'dur: parayı KDM tahsil eder, satıcıya mutabakatla ödenir. SELLER seçilirse satıcının kendi POS'u tahsil eder — bu yol için satıcı POS ağ geçidinin bağlanmış olması gerekir, aksi hâlde o satıcının siparişlerinde ödeme başlatılamaz.

İstek gövdesi CreateSellerRequest

Yanıtlar

Durum	Gövde	Açıklama
201	`SellerDto`	Satıcı oluşturuldu.
400	`ApiError`	`validation_failed` — gövde veya query şemaya uymuyor (`details`).
401	`ApiError`	`missing_token`, `invalid_token` veya `unauthenticated`.
403	`ApiError`	`insufficient_role` — kimlik doğru, rol yetkili değil.
409	`ApiError`	`seller_code_taken` veya `platform_seller_exists`.

PATCH /v1/admin/sellers/{id} Bearer

Satıcıyı günceller

Parametreler

Ad	Yer	Tip	Açıklama
`id` *	path	`string`

İstek gövdesi UpdateSellerRequest

Yanıtlar

Durum	Gövde	Açıklama
200	`SellerDto`	Güncel satıcı.
400	`ApiError`	`validation_failed` — gövde veya query şemaya uymuyor (`details`).
401	`ApiError`	`missing_token`, `invalid_token` veya `unauthenticated`.
403	`ApiError`	`insufficient_role` — kimlik doğru, rol yetkili değil.
404	`ApiError`	`seller_not_found`.
409	`ApiError`	`seller_code_taken`.

GET /v1/admin/sellers/{id}/keys Bearer

Satıcının anahtarlarını listeler

Anahtarın kendisi dönmez — yalnızca prefix. Bu, "sonu … olan anahtarı iptal et" cümlesini anahtarı hiç saklamadan cevaplanabilir kılar.

Parametreler

Ad	Yer	Tip	Açıklama
`id` *	path	`string`

Yanıtlar

Durum	Gövde	Açıklama
200	`IntegrationKeyDto[]`	Anahtarlar.
401	`ApiError`	`missing_token`, `invalid_token` veya `unauthenticated`.
403	`ApiError`	`insufficient_role` — kimlik doğru, rol yetkili değil.
404	`ApiError`	`seller_not_found`.

POST /v1/admin/sellers/{id}/keys Bearer

Anahtar üretir

Anahtarın tamamını taşıyan tek yanıt budur. argon2 ile hash'lenerek saklandığı için sonradan kurtarılamaz; kaybolan anahtar yeniden üretilir, aranmaz.

Parametreler

Ad	Yer	Tip	Açıklama
`id` *	path	`string`

İstek gövdesi CreateIntegrationKeyRequest

Yanıtlar

Durum	Gövde	Açıklama
201	`IssuedKeyDto`	Anahtar üretildi — `key` alanı yalnızca burada döner.
400	`ApiError`	`validation_failed` — gövde veya query şemaya uymuyor (`details`).
401	`ApiError`	`missing_token`, `invalid_token` veya `unauthenticated`.
403	`ApiError`	`insufficient_role` — kimlik doğru, rol yetkili değil.
404	`ApiError`	`seller_not_found`.

DELETE /v1/admin/sellers/{id}/keys/{keyId} Bearer

Anahtarı iptal eder

Parametreler

Ad	Yer	Tip	Açıklama
`id` *	path	`string`
`keyId` *	path	`string`

Yanıtlar

Durum	Gövde	Açıklama
204	`—`	İptal edildi.
401	`ApiError`	`missing_token`, `invalid_token` veya `unauthenticated`.
403	`ApiError`	`insufficient_role` — kimlik doğru, rol yetkili değil.
404	`ApiError`	`seller_not_found` veya `integration_key_not_found`.