Submerchant (Alt Üye İşyeri / Alt Bayi) İşlemleri

Bu sayfa, Submerchant (Alt Üye İşyeri) modeliyle çalışan işyerleri için işlemlerin yönetilmesini sağlar.

Çalışma Modellerine Genel Bakış

HalkÖde sistemi, farklı işyeri yapılarına uyum sağlayabilmek için iki ayrı çalışma modelini destekler:

Ana Bayi Modeli ve Zincir & Alt Bayi Modeli

Her modelin sistem üzerindeki davranışları, işlem gönderim şekilleri ve raporlama yetkileri detaylı şekilde açıklanmıştır. Entegrasyon sürecinizde doğru modeli seçmek, işlem akışının sorunsuz ilerlemesi açısından kritik öneme sahiptir.

Not : Hangi modelin kullanılacağı, işyeri tanımı sırasında belirlenir. İşlem gönderimi ve raporlama yetkileri bu yapıya göre şekillenir.

1️) Ana Bayi Modeli

Bu modelde sisteme yalnızca ana bayi tanımı yapılır. Alt bayiler fiziksel olarak mevcut olsa da, VPOS sisteminde ayrı birer işyeri olarak tanımlanmaz. Tüm işlemler ana bayi üzerinden yürütülür.

Model Özellikleri

• Sistemde yalnızca ana bayi tanımlıdır; alt bayiler sistemde bağımsız işyeri olarak yer almaz.

• Ana bayi, tüm işlemleri kendi x_client_token ve x_client_secretkey ile gerçekleştirilir.

• Alt bayilere ait işlemler, sistemde ana bayi üzerinden yürütülür.

Teknik Detaylar

• API işlem isteği gönderilirken, default istek parametrelerine ek olarak aşağıdaki alanın zorunlu olarak iletilmesi gerekir. "subMerchantName":"Alt Bayi Adı"

• Bu alan, işlemin hangi alt bayi adına yapıldığını belirtmek için kullanılır.

• subMerchantName alanı gönderilmediği takdirde, işlem isteği geçersiz sayılır ve API tarafından hata dönebilir.

Servis Parametresi: subMerchantName

Alan Adı	Veri Tipi	Uzunluk	Açıklama
subMerchantName*	string	40	Alt bayinin adı bilgisidir. Bu alan, ödeme aracısı (facilitator) ve ana bayi tarafından kullanılır.

2️) Zincir & Alt Bayi Modeli

Bu modelde hem zincir işyeri hem de ona bağlı alt bayiler sisteme tanımlanarak işlem ve raporlama yetkileri esnek şekilde yönetilir.

Zincir İşyeri Yetkileri

• Zincir işyeri, hem kendi adına hem de bağlı alt bayiler adına işlem gerçekleştirebilir.

• Tüm alt bayilere ait işlem raporlarını görüntüleyebilir.

• Rapor ve ekran erişim yetkilerini alt bayilere tanımlayabilir.

Alt Bayi Yetkileri

• Alt bayiler yalnızca kendi adlarına işlem yapabilir.

• Sadece kendi raporlarını görüntüleyebilir.

• Eğer zincir tarafından yetki verilmişse, arayüze bağlanarak raporlarını görüntüleyebilir ve manuel işlem gerçekleştirebilir.

• API isteklerini default şekilde gönderir; ek özel alan beklenmez.

• Kendi x_client_token ve x_client_secretkey bilgilerini kullanmaları yeterlidir.

Teknik Detaylar

• Zincir işyeri, alt bayi adına işlem yapacaksa API işlem isteği gönderilirken, default istek parametrelerine ek olarak aşağıdaki alanın zorunlu olarak iletilmesi gerekir.

"subMerchantId": "000000001015721"

• Bu alan, işlemin hangi alt bayi adına yapıldığını belirtir.

Servis Parametresi: subMerchantId

Alan Adı	Veri Tipi	Uzunluk	Açıklama
subMerchantId*	string	15	Alt bayiye ait benzersiz işyeri ID’sidir. Bu alan, ödeme aracısı (facilitator) ve Zincir tarafından kullanılır.

Zincir kendi adına işlem yapacaksa, API isteğinde subMerchantId alanı gönderilmemelidir.