Alt Üye Güncelleme

Pazaryeri çözümünde alt üyelerinizin bilgilerini güncellemek için aşağıdaki servisleri kullanabilirsiniz.

Alt üye işyerlerini güncelleme sürecinde alt üye işyeri türünü değiştirilememektedir. Belirli bir türde bir alt satıcı oluşturulduktan sonra farklı bir türe değiştirilemez. Bu nedenle, ilk kurulum sırasında doğru bayi tipinin seçildiğinden emin olmak çok önemlidir.

Submerchant türlerinin tümü güncelleme işlemlerini gerçekleştirebilir;

• Bireysel

• Şahıs Şirketi

• Limited / Anonim Şirketi

Bireysel Alt Üye Güncelleme

PUT https://api.iyzipay.com/onboarding/submerchant

Request Body

Name	Type	Description
locale	String	iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri tr’dir.
conversationId	String	İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir.
name	String	Alt üye işyeri adı.
email*	String	Alt üye işyeri e-posta adresi.
identityNumber	String	Alt üye işyeri T.C. kimlik numarası. Eğer alt üye işyeri ekleme esnasında boş bırakılırsa, ürüne onay vermeden önce mutlaka doldurulmalıdır.
currency	String	Para birimi default TL olarak belirlenmiştir. USD, EUR, GBP, RUB, CHF ve NOK para birimleri de belirlenebilir.
contactSurname*	String	Alt üye işyeri iletişim soyadı.
contactname*	String	Alt üye işyeri iletişim adı.
iban*	String	Alt üye işyeri IBAN bilgisi. legalCompanyTitle ile uyumlu bir IBAN olmalı.
address*	String	Alt üye işyeri adresi.
subMerchantKey*	String	Güncellenmek isteyen alt üye işyerinin anahtarı.
gsmNumber	String	Alt üye işyeri telefon numarası.

200: OK

Bireysel Alt Üye Güncelleme Yanıtı

{
    "status":"success",
    "locale":"tr",
    "systemTime":1686437115197,
    "conversationId":"123456789"
}

Şahıs Şirketi Alt Üye Güncelleme

PUT https://api.iyzipay.com/onboarding/submerchant

Request Body

Name	Type	Description
locale	String	iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri tr’dir.
conversationId	String	İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir.
name	String	Alt üye işyeri adı.
email*	String	Alt üye işyeri e-posta adresi.
identityNumber	String	Alt üye işyeri T.C. kimlik numarası. Eğer alt üye işyeri ekleme esnasında boş bırakılırsa, ürüne onay vermeden önce mutlaka doldurulmalıdır.
currency	String	Para birimi default TL olarak belirlenmiştir. USD, EUR, GBP, RUB, CHF ve NOK para birimleri de belirlenebilir.
legalCompanyTitle*	String	Alt üye işyeri yasal şirket ünvanı.
taxOffice*	String	Alt üye işyeri vergi dairesi.
iban*	String	Alt üye işyeri IBAN bilgisi. legalCompanyTitle ile uyumlu bir IBAN olmalı.
address*	String	Alt üye işyeri adresi.
subMerchantKey*	String	Güncellenmek isteyen alt üye işyerinin anahtarı.
gsmNumber	String	Alt üye işyeri telefon numarası.

200: OK

Şahıs Şirketi Alt Üye Güncelleme Yanıtı

{
    "status":"success",
    "locale":"tr",
    "systemTime":1686437115197,
    "conversationId":"123456789"
}

Limited / Ananim Şirket Alt Üye Güncelleme

PUT https://api.iyzipay.com/onboarding/submerchant

Request Body

Name	Type	Description
locale	String	iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri tr’dir.
conversationId	String	İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir.
name	String	Alt üye işyeri adı.
email*	String	Alt üye işyeri e-posta adresi.
taxNumber	String	Alt üye işyeri vergi numarası.
currency	String	Para birimi default TL olarak belirlenmiştir. USD, EUR, GBP, RUB, CHF ve NOK para birimleri de belirlenebilir.
legalCompanyTitle*	String	Alt üye işyeri yasal şirket ünvanı.
taxOffice*	String	Alt üye işyeri vergi dairesi.
iban*	String	Alt üye işyeri IBAN bilgisi. legalCompanyTitle ile uyumlu bir IBAN olmalı.
address*	String	Alt üye işyeri adresi.
subMerchantKey*	String	Güncellenmek isteyen alt üye işyerinin anahtarı.
gsmNumber	String	Alt üye işyeri telefon numarası.

200: OK

Limited / Ananim Şirket Alt Üye Güncelleme Yanıtı

{
    "status":"success",
    "locale":"tr",
    "systemTime":1686437115197,
    "conversationId":"123456789"
}

Dönen Parametreler

Parametre ismi	Tip	Açıklama
status	String	Yapılan isteğin sonucunu bildirir. İşlem başarılı ise success, hatalı ise failure döner.
locale	String	İstekte belirtilen locale değeri geri dönülür, varsayılan değeri tr’dir.
systemTime	Integer	Dönen sonucun o anki unix timestamp değeridir.
conversationId	String	İstek esnasında gönderilmişse, sonuçta aynen geri iletilir.
errorCode	String	İşlem hatalıysa, bu hataya dair belirtilen koddur.
errorMessage	String	İşlem hatalıysa, bu hataya dair belirtilen mesajdır, locale parametresine göre dil desteği sunar.
errorGroup	String	İşlem hatalıysa, bu hataya dair belirtilen gruptur.

Örnek Request

Bireysel Alt Üye Güncelleme

PHP

$request = new \Iyzipay\Request\UpdateSubMerchantRequest();
    $request->setLocale(\Iyzipay\Model\Locale::TR);
    $request->setConversationId("123456789");
    $request->setSubMerchantKey("sub merchant key");
    $request->setIban("TR630006200027700006678204");
    $request->setAddress("Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1");
    $request->setContactName("Jane");
    $request->setContactSurname("Doe");
    $request->setEmail("[e-mail]");
    $request->setGsmNumber("[phone]");
    $request->setName("Jane's market");
    $request->setIdentityNumber("31300864726");
    $request->setCurrency(\Iyzipay\Model\Currency::TL);

    # make request
    $subMerchant = \Iyzipay\Model\SubMerchant::update($request, Config::options());

.NET

UpdateSubMerchantRequest request = new UpdateSubMerchantRequest();
request.Locale = Locale.TR.ToString();
request.ConversationId = "123456789";
request.SubMerchantKey = "sub merchant key";
request.Address = "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1";
request.TaxOffice = "Tax office";
request.ContactName = "John";
request.ContactSurname = "Doe";
request.Email = "[e-mail]";
request.GsmNumber = "[phone]";
request.Name = "Jane's market";
request.Iban = "TR180006200119000006672315";
request.Currency = Currency.TRY.ToString();

SubMerchant subMerchant = SubMerchant.Update(request, options);

JAVA

UpdateSubMerchantRequest request = new UpdateSubMerchantRequest();
request.setLocale(Locale.TR.getValue());
request.setConversationId("123456789");
request.setSubMerchantKey("sub merchant key");
request.setAddress("Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1");
request.setContantName("John");
request.setContactSurname("Doe");
request.setEmail("[e-mail]");
request.setGsmNumber("[phone]");
request.setName("Jane's market");
request.setIban("TR180006200119000006672315");
request.setIdentityNumber("31300864726");
request.setCurrency(Currency.TRY.name());

SubMerchant subMerchant = SubMerchant.update(request, options);

NodeJS

iyzipay.subMerchant.update({
    locale: Iyzipay.LOCALE.TR,
    conversationId: '123456789',
    subMerchantKey: 'sub merchant key',
    address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
    contactName: 'John',
    contactSurname: 'Doe',
    email: '[e-mail]',
    gsmNumber: '[phone]',
    name: 'Jane\'s market',
    iban: 'TR180006200119000006672315',
    identityNumber: '31300864726',
    currency: Iyzipay.CURRENCY.TRY
}, function (err, result) {
    console.log(err, result);
    done();
});

Python

request = dict([('locale', 'tr')])
request['conversationId'] = '123456789'
request['subMerchantKey'] = 'sub merchant key'
request['address'] = 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1'
request['contactName'] = 'John'
request['contactSurname'] = 'Doe'
request['email'] = '[e-mail]'
request['gsmNumber'] = '[phone]'
request['name'] = 'John\'s market'
request['iban'] = 'TR180006200119000006672315'
request['identityNumber'] = '31300864726'
request['currency'] = 'TRY'

sub_merchant = iyzipay.SubMerchant()
sub_merchant_response = sub_merchant.update(request, options)

Ruby

request = {
    locale: 'tr',
    conversationId: '123456789',
    subMerchantExternalId: 'S49222',
    subMerchantKey: 'sub merchant key',
    address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
    contactName: 'John',
    contactSurname: 'Doe',
    email: '[e-mail]',
    gsmNumber: '[phone]',
    name: 'Jane\'s market',
    iban: 'TR180006200119000006672315',
    identityNumber: '31300864726',
    currency: Iyzipay::Model::Currency::TRY
}
sub_merchant = Iyzipay::Model::SubMerchant.new.update(request, @options)

JSON

//Request
{
    "locale": "tr",
    "conversationId": "123456789",
    "name": "Jane's market",
    "email": "[e-mail]",
    "gsmNumber": "[phone]",
    "address": "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
    "iban": "TR180006200119000006672315",
    "contactName": "John",
    "contactSurname": "Doe",
    "currency": "TRY",
    "subMerchantKey": "PPFFZPedVQSvaOqZu5xpvpLEqmc=",
    "identityNumber": "31300864726"
}

//Response
{
    "status": "success",
    "locale": "tr",
    "systemTime": 1470732942251,
    "conversationId": "123456789"
}

Şahıs Şirketi Alt Üye Güncelleme

PHP

$request = new \Iyzipay\Request\UpdateSubMerchantRequest();
$request->setLocale(\Iyzipay\Model\Locale::TR);
$request->setConversationId("123456789");
$request->setSubMerchantKey("sub merchant key");
$request->setIban("TR630006200027700006678204");
$request->setAddress("Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1");
$request->setContactName("Jane");
$request->setContactSurname("Doe");
$request->setEmail("[e-mail]");
$request->setGsmNumber("[phone]");
$request->setName("Jane's market");
$request->setIdentityNumber("31300864726");
$request->setCurrency(\Iyzipay\Model\Currency::TL);

$subMerchant = \Iyzipay\Model\SubMerchant::update($request, Config::options());

.NET

UpdateSubMerchantRequest request = new UpdateSubMerchantRequest();
request.Locale = Locale.TR.ToString();
request.ConversationId = "123456789";
request.SubMerchantKey = "sub merchant key";
request.Address = "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1";
request.TaxOffice = "Tax office";
request.LegalCompanyTitle = "Jane Doe inc";
request.Email = "[e-mail]";
request.GsmNumber = "[phone]";
request.Name = "Jane's market";
request.Iban = "TR180006200119000006672315";
request.IdentityNumber = "31300864726";
request.Currency = Currency.TRY.ToString();

SubMerchant subMerchant = SubMerchant.Update(request, options);

JAVA

UpdateSubMerchantRequest request = new UpdateSubMerchantRequest();
request.setLocale(Locale.TR.getValue());
request.setConversationId("123456789");
request.setSubMerchantKey("sub merchant key");
request.setAddress("Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1");
request.setTaxOffice("Tax office");
request.setLegalCompanyTitle("Jane Doe inc");
request.setEmail("[e-mail]");
request.setGsmNumber("[phone]");
request.setName("Jane's market");
request.setIban("TR180006200119000006672315");
request.setIdentityNumber("31300864726");
request.setCurrency(Currency.TRY.name());

SubMerchant subMerchant = SubMerchant.update(request, options);

NodeJS

iyzipay.subMerchant.update({
    locale: Iyzipay.LOCALE.TR,
    conversationId: '123456789',
    subMerchantKey: 'sub merchant key',
    address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
    taxOffice: 'Tax office',
    legalCompanyTitle: 'Jane Doe inc',
    email: '[e-mail]',
    gsmNumber: '[phone]',
    name: 'Jane\'s market',
    iban: 'TR180006200119000006672315',
    identityNumber: '31300864726',
    currency: Iyzipay.CURRENCY.TRY
}, function (err, result) {
    console.log(err, result);
    done();
});

Python

request = dict([('locale', 'tr')])
request['conversationId'] = '123456789'
request['subMerchantKey'] = 'sub merchant key'
request['address'] = 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1'
request['taxOffice'] = 'Tax Office'
request['legalCompanyTitle'] = 'John Doe inc'
request['email'] = '[e-mail]'
request['gsmNumber'] = '[phone]'
request['name'] = 'John\'s market'
request['iban'] = 'TR180006200119000006672315'
request['identityNumber'] = '31300864726'
request['currency'] = 'TRY'

sub_merchant = iyzipay.SubMerchant()
sub_merchant_response = sub_merchant.update(request, options)

Ruby

request = {
    locale: 'tr',
    conversationId: '123456789',
    subMerchantExternalId: 'S49222',
    subMerchantKey: 'sub merchant key',
    address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
    taxOffice: 'Tax office',
    legalCompanyTitle: 'Jane Doe inc',
    email: '[e-mail]',
    gsmNumber: '[phone]',
    name: 'Jane\'s market',
    iban: 'TR180006200119000006672315',
    identityNumber: '31300864726',
    currency: Iyzipay::Model::Currency::TRY
}
sub_merchant = Iyzipay::Model::SubMerchant.new.update(request, @options)

JSON

//Request
{
    "locale": "tr",
    "conversationId": "123456789",
    "name": "Jane's market",
    "email": "[e-mail]",
    "gsmNumber": "[phone]",
    "address": "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
    "iban": "TR180006200119000006672315",
    "taxOffice": "Tax office",
    "legalCompanyTitle": "Jane Doe inc",
    "currency": "TRY",
    "subMerchantKey": "PPFFZPedVQSvaOqZu5xpvpLEqmc=",
    "identityNumber": "31300864726"
}

//Response
{
    "status": "success",
    "locale": "tr",
    "systemTime": 1470732942251,
    "conversationId": "123456789"
}

Limited / Anonim Şirket Alt Üye Güncelleme

PHP

$request = new \Iyzipay\Request\UpdateSubMerchantRequest();
$request->setLocale(\Iyzipay\Model\Locale::TR);
$request->setConversationId("123456789");
$request->setSubMerchantKey("sub merchant key");
$request->setAddress("Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1");
$request->setTaxOffice("Tax office");
$request->setTaxNumber("9261877");
$request->setLegalCompanyTitle("ABC inc");
$request->setEmail("[e-mail]");
$request->setGsmNumber("[phone]");
$request->setName("Jane's market");
$request->setIban("TR180006200119000006672315");
$request->setCurrency(\Iyzipay\Model\Currency::TL);

$subMerchant = \Iyzipay\Model\SubMerchant::update($request, Config::options());

.NET

UpdateSubMerchantRequest request = new UpdateSubMerchantRequest();
request.Locale = Locale.TR.ToString();
request.ConversationId = "123456789";
request.SubMerchantKey = "sub merchant key";
request.Address = "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1";
request.TaxOffice = "Tax office";
request.TaxNumber = "9261877";
request.LegalCompanyTitle = "ABC inc";
request.Email = "[e-mail]";
request.GsmNumber = "[phone]";
request.Name = "Jane's market";
request.Iban = "TR180006200119000006672315";
request.Currency = Currency.TRY.ToString();

SubMerchant subMerchant = SubMerchant.Update(request, options);

JAVA

UpdateSubMerchantRequest request = new UpdateSubMerchantRequest();
request.setLocale(Locale.TR.getValue());
request.setConversationId("123456789");
request.setSubMerchantKey("sub merchant key");
request.setAddress("Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1");
request.setTaxOffice("Tax office");
request.setTaxNumber("9261877");
request.setLegalCompanyTitle("ABC inc");
request.setEmail("[e-mail]");
request.setGsmNumber("[phone]");
request.setName("Jane's market");
request.setIban("TR180006200119000006672315");
request.setCurrency(Currency.TRY.name());

SubMerchant subMerchant = SubMerchant.update(request, options);

NodeJS

iyzipay.subMerchant.update({
    locale: Iyzipay.LOCALE.TR,
    conversationId: '123456789',
    subMerchantKey: 'sub merchant key',
    address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
    taxOffice: 'Tax office',
    taxNumber: '9261877',
    legalCompanyTitle: 'ABC inc',
    email: '[e-mail]',
    gsmNumber: '[phone]',
    name: 'Jane\'s market',
    iban: 'TR180006200119000006672315',
    currency: Iyzipay.CURRENCY.TRY
}, function (err, result) {
    console.log(err, result);
    done();
});

Python

request = dict([('locale', 'tr')])
request['conversationId'] = '123456789'
request['subMerchantKey'] = 'sub merchant key'
request['address'] = 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1'
request['taxOffice'] = 'Tax Office'
request['taxNumber'] = '9261877'
request['legalCompanyTitle'] = 'ABC inc'
request['email'] = '[e-mail]'
request['gsmNumber'] = '[phone]'
request['name'] = 'John\'s market'
request['iban'] = 'TR180006200119000006672315'
request['currency'] = 'TRY'

sub_merchant = iyzipay.SubMerchant()
sub_merchant_response = sub_merchant.update(request, options)

Ruby

request = {
    locale: Iyzipay::Model::Locale::TR,
    conversationId: '123456789',
    subMerchantKey: 'sub merchant key',
    address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
    taxOffice: 'Tax office',
    taxNumber: '9261877',
    legalCompanyTitle: 'ABC inc',
    email: '[e-mail]',
    gsmNumber: '[phone]',
    name: 'Jane\'s market',
    iban: 'TR180006200119000006672315',
    currency: Iyzipay::Model::Currency::TRY
}
sub_merchant = Iyzipay::Model::SubMerchant.new.update(request, @options)

JSON

//Request
{
    "locale": "tr",
    "conversationId": "123456789",
    "name": "Jane's market",
    "email": "[e-mail]",
    "gsmNumber": "[phone]",
    "address": "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
    "iban": "TR180006200119000006672315",
    "taxOffice": "Tax office",
    "legalCompanyTitle": "ABC inc",
    "currency": "TRY",
    "subMerchantKey": "jsLbNEUu8XOKyxLdqqqqHUuu9bQ=",
    "taxNumber": "9261877"
}

//Response
{
    "status": "success",
    "locale": "tr",
    "systemTime": 1470733009785,
    "conversationId": "123456789"
}