Alt Üye
Pazaryeri çözümünde işlem onaylandıktan sonra satıcılara para transferi yapılabilmesi için bu satıcıların iyzico’da kaydının bulunması gerekir. Pazaryeri; zaten bu satıcı bilgilerine sahip olduğu için, iyzico Onboarding API’sine satıcı bilgilerini göndererek satıcı kaydını oluşturduktan sonra bu bilgileri çekip güncelleyebilir.
Alt Üye İşyeri Servisleri
Alt Üye Oluşturma
Pazaryeri altındaki alt üye işyerleri 3 tipte olabilirler :
Her tip için alt üye işyeri kaydında gönderilen parametreler farklılık göstermektedir. Alt üye işyeri kaydı yapıldığında response alanında dönen subMerchantKey, o satıcı için tekil değerdir, bu değeri sisteminizde saklamalısınız, ödeme esnasında satıcıyı belirtmek için subMerchantKey’i göndermeniz gerekecektir.
iyzico’ya iletilen tüm parametreler gerçek değerleri içerecek şekilde iletilmelidir. Rastgele, test veya gerçek olmayan bilgiler iletilmemelidir.
Bireysel Alt Üye Oluşturma
POST
https://api.iyzipay.com/onboarding/submerchant
Request Body
Bireysel Alt Üye Oluşturma Yanıtı
{
"status":"success",
"locale":"tr",
"systemTime":1685650370980,
"conversationId":"123456789",
"subMerchantKey":"b2gUmE4RdWiUMQQrC7nv99qMSQQ="
}
Şahıs Şirketi Alt Üye Oluşturma
POST
https://api.iyzipay.com/onboarding/submerchant
Request Body
Şahıs Şirketi Alt Üye Oluşturma Yanıtı
{
"status":"success",
"locale":"tr",
"systemTime":1685650370980,
"conversationId":"123456789",
"subMerchantKey":"b2gUmE4RdWiUMQQrC7nv99qMSQQ="
}
Limited/Anonim Şirket Alt Üye Oluşturma
POST
https://api.iyzipay.com/onboarding/submerchant
Request Body
Limited/Anonim Şirket Alt Üye Oluşturma Yanıtı
{
"status":"success",
"locale":"tr",
"systemTime":1685650370980,
"conversationId":"123456789",
"subMerchantKey":"b2gUmE4RdWiUMQQrC7nv99qMSQQ="
}
Dönen Parametreler
Örnek Kodlar
Bireysel Alt Üye Oluşturma
$request = new \Iyzipay\Request\CreateSubMerchantRequest();
$request->setLocale(\Iyzipay\Model\Locale::TR);
$request->setConversationId("123456789");
$request->setSubMerchantExternalId("S49222");
$request->setSubMerchantType(\Iyzipay\Model\SubMerchantType::PERSONAL);
$request->setAddress("Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1");
$request->setContactName("John");
$request->setContactSurname("Doe");
$request->setEmail("email@submerchantemail.com");
$request->setGsmNumber("+905350000000");
$request->setName("John's market");
$request->setIban("TR180006200119000006672315");
$request->setIdentityNumber("31300864726");
$request->setCurrency(\Iyzipay\Model\Currency::TL);
$subMerchant = \Iyzipay\Model\SubMerchant::create($request, Config::options());
CreateSubMerchantRequest request = new CreateSubMerchantRequest();
request.Locale = Locale.TR.ToString();
request.ConversationId = "123456789";
request.SubMerchantExternalId = "S49222";
request.SubMerchantType = SubMerchantType.PERSONAL.ToString();
request.Address = "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1";
request.ContactName = "John";
request.ContactSurname = "Doe";
request.Email = "email@submerchantemail.com";
request.GsmNumber = "+905350000000";
request.Name = "John's market";
request.Iban = "TR180006200119000006672315";
request.IdentityNumber = "31300864726";
request.Currency = Currency.TRY.ToString();
SubMerchant subMerchant = SubMerchant.Create(request, options);
CreateSubMerchantRequest request = new CreateSubMerchantRequest();
request.setLocale(Locale.TR.getValue());
request.setConversationId("123456789");
request.setSubMerchantExternalId("S49222");
request.setSubMerchantType(SubMerchantType.PERSONAL.name());
request.setAddress("Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1");
request.setContactName("John");
request.setContactSurname("Doe");
request.setEmail("email@submerchantemail.com");
request.setGsmNumber("+905350000000");
request.setName("John's market");
request.setIban("TR180006200119000006672315");
request.setIdentityNumber("31300864726");
request.setCurrency(Currency.TRY.name());
SubMerchant subMerchant = SubMerchant.create(request, options);
iyzipay.subMerchant.create({
locale: Iyzipay.LOCALE.TR,
conversationId: '123456789',
subMerchantExternalId: 'S49222',
subMerchantType: Iyzipay.SUB_MERCHANT_TYPE.PERSONAL,
address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
ContactName: 'John',
ContactSurname: 'Doe',
email: 'email@submerchantemail.com',
gsmNumber: '+905350000000',
name: 'John\'s market',
iban: 'TR180006200119000006672315',
identityNumber: '31300864726',
currency: Iyzipay.CURRENCY.TRY
}, function (err, result) {
console.log(err, result);
done();
});
request = dict([('locale', 'tr')])
request['conversationId'] = '123456789'
request['subMerchantExternalId'] = 'S49222'
request['subMerchantType'] = 'PERSONAL'
request['address'] = 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1'
request['ContactName'] = 'John'
request['ContactSurname'] = 'Doe'
request['email'] = 'email@submerchantemail.com'
request['gsmNumber'] = '+905350000000'
request['name'] = 'John\'s market'
request['iban'] = 'TR180006200119000006672315'
request['identityNumber'] = '31300864726'
request['currency'] = 'TRY'
sub_merchant = iyzipay.SubMerchant()
sub_merchant_response = sub_merchant.create(request, options)
request = {
locale: 'tr',
conversationId: '123456789',
subMerchantExternalId: 'S49222',
subMerchantType: Iyzipay::Model::SubMerchantType::PERSONAL,
address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
ContactName: 'John',
ContactSurname: 'Doe',
email: 'email@submerchantemail.com',
gsmNumber: '+905350000000',
name: 'John\'s market',
iban: 'TR180006200119000006672315',
identityNumber: '31300864726',
currency: Iyzipay::Model::Currency::TRY
}
sub_merchant = Iyzipay::Model::SubMerchant.new.create(request, @options)
//Request
{
"locale": "tr",
"conversationId": "123456789",
"name": "John's market",
"email": "email@submerchantemail.com",
"gsmNumber": "+905350000000",
"address": "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
"iban": "TR180006200119000006672315",
"ContactName": "John",
"ContactSurname": "Doe",
"currency": "TRY",
"subMerchantExternalId": "S49222",
"identityNumber": "31300864726",
"subMerchantType": "PERSONAL"
}
//Response
{
"status": "success",
"locale": "tr",
"systemTime": 1470732341410,
"conversationId": "123456789",
"subMerchantKey": "PPFFZPedVQSvaOqZu5xpvpLEqmc="
}
Şahıs Şirketi Alt Üye Oluşturma
$request = new \Iyzipay\Request\CreateSubMerchantRequest();
$request->setLocale(\Iyzipay\Model\Locale::TR);
$request->setConversationId("123456789");
$request->setSubMerchantExternalId("S49222");
$request->setSubMerchantType(\Iyzipay\Model\SubMerchantType::PRIVATE_COMPANY);
$request->setAddress("Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1");
$request->setTaxOffice("Tax office");
$request->setLegalCompanyTitle("John Doe inc");
$request->setEmail("email@submerchantemail.com");
$request->setGsmNumber("+905350000000");
$request->setName("John's market");
$request->setIban("TR180006200119000006672315");
$request->setIdentityNumber("31300864726");
$request->setCurrency(\Iyzipay\Model\Currency::TL);
$subMerchant = \Iyzipay\Model\SubMerchant::create($request, Config::options());
CreateSubMerchantRequest request = new CreateSubMerchantRequest();
request.Locale = Locale.TR.ToString();
request.ConversationId = "123456789";
request.SubMerchantExternalId = "S49222";
request.SubMerchantType = SubMerchantType.PRIVATE_COMPANY.ToString();
request.Address = "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1";
request.TaxOffice = "Tax office";
request.LegalCompanyTitle = "John Doe inc";
request.Email = "email@submerchantemail.com";
request.GsmNumber = "+905350000000";
request.Name = "John's market";
request.Iban = "TR180006200119000006672315";
request.IdentityNumber = "31300864726";
request.Currency = Currency.TRY.ToString();
SubMerchant subMerchant = SubMerchant.Create(request, options);
CreateSubMerchantRequest request = new CreateSubMerchantRequest();
request.setLocale(Locale.TR.getValue());
request.setConversationId("123456789");
request.setSubMerchantExternalId("S49222");
request.setSubMerchantType(SubMerchantType.PRIVATE_COMPANY.name());
request.setAddress("Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1");
request.setTaxOffice("Tax office");
request.setLegalCompanyTitle("John Doe inc");
request.setEmail("email@submerchantemail.com");
request.setGsmNumber("+905350000000");
request.setName("John's market");
request.setIban("TR180006200119000006672315");
request.setIdentityNumber("31300864726");
request.setCurrency(Currency.TRY.name());
SubMerchant subMerchant = SubMerchant.create(request, options);
iyzipay.subMerchant.create({
locale: Iyzipay.LOCALE.TR,
conversationId: '123456789',
subMerchantExternalId: 'S49222',
subMerchantType: Iyzipay.SUB_MERCHANT_TYPE.PRIVATE_COMPANY,
address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
taxOffice: 'Tax office',
legalCompanyTitle: 'John Doe inc',
email: 'email@submerchantemail.com',
gsmNumber: '+905350000000',
name: 'John\'s market',
iban: 'TR180006200119000006672315',
identityNumber: '31300864726',
currency: Iyzipay.CURRENCY.TRY
}, function (err, result) {
console.log(err, result);
done();
});
request = dict([('locale', 'tr')])
request['conversationId'] = '123456789'
request['subMerchantExternalId'] = 'S49222'
request['subMerchantType'] = 'PRIVATE_COMPANY'
request['address'] = 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1'
request['taxOffice'] = 'Tax Office'
request['legalCompanyTitle'] = 'John Doe inc'
request['email'] = 'email@submerchantemail.com'
request['gsmNumber'] = '+905350000000'
request['name'] = 'John\'s market'
request['iban'] = 'TR180006200119000006672315'
request['identityNumber'] = '31300864726'
request['currency'] = 'TRY'
sub_merchant = iyzipay.SubMerchant()
sub_merchant_response = sub_merchant.create(request, options)
request = {
locale: 'tr',
conversationId: '123456789',
subMerchantExternalId: 'S49222',
subMerchantType: Iyzipay::Model::SubMerchantType::PRIVATE_COMPANY,
address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
taxOffice: 'Tax office',
legalCompanyTitle: 'John Doe inc',
email: 'email@submerchantemail.com',
gsmNumber: '+905350000000',
name: 'John\'s market',
iban: 'TR180006200119000006672315',
identityNumber: '31300864726',
currency: Iyzipay::Model::Currency::TRY
}
sub_merchant = Iyzipay::Model::SubMerchant.new.create(request, @options)
//Request
{
"locale": "tr",
"conversationId": "123456789",
"name": "John's market",
"email": "email@submerchantemail.com",
"gsmNumber": "+905350000000",
"address": "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
"iban": "TR180006200119000006672315",
"taxOffice": "Tax office",
"legalCompanyTitle": "John Doe inc",
"currency": "TRY",
"subMerchantExternalId": "S49222",
"identityNumber": "31300864726",
"subMerchantType": "PRIVATE_COMPANY"
}
//Response
{
"status": "success",
"locale": "tr",
"systemTime": 1470732341410,
"conversationId": "123456789",
"subMerchantKey": "PPFFZPedVQSvaOqZu5xpvpLEqmc="
}
Limited / Anonim Şirket Alt Üye Oluşturma
$request = new \Iyzipay\Request\CreateSubMerchantRequest();
$request->setLocale(\Iyzipay\Model\Locale::TR);
$request->setConversationId("123456789");
$request->setSubMerchantExternalId("S49222");
$request->setSubMerchantType(\Iyzipay\Model\SubMerchantType::LIMITED_OR_JOINT_STOCK_COMPANY);
$request->setAddress("Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1");
$request->setTaxOffice("Tax office");
$request->setTaxNumber("31300864726");
$request->setLegalCompanyTitle("John Doe inc");
$request->setEmail("email@submerchantemail.com");
$request->setGsmNumber("+905350000000");
$request->setName("John's market");
$request->setIban("TR180006200119000006672315");
$request->setCurrency(\Iyzipay\Model\Currency::TL);
$subMerchant = \Iyzipay\Model\SubMerchant::create($request, Config::options());
CreateSubMerchantRequest request = new CreateSubMerchantRequest();
request.Locale = Locale.TR.ToString();
request.ConversationId = "123456789";
request.SubMerchantExternalId = "S49222";
request.SubMerchantType = SubMerchantType.LIMITED_OR_JOINT_STOCK_COMPANY.ToString();
request.Address = "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1";
request.TaxOffice = "Tax office";
request.TaxNumber = "31300864726";
request.LegalCompanyTitle = "John Doe inc";
request.Email = "email@submerchantemail.com";
request.GsmNumber = "+905350000000";
request.Name = "John's market";
request.Iban = "TR180006200119000006672315";
request.Currency = Currency.TRY.ToString();
SubMerchant subMerchant = SubMerchant.Create(request, options);
CreateSubMerchantRequest request = new CreateSubMerchantRequest();
request.setLocale(Locale.TR.getValue());
request.setConversationId("123456789");
request.setSubMerchantExternalId("S49222");
request.setSubMerchantType(SubMerchantType.LIMITED_OR_JOINT_STOCK_COMPANY.name());
request.setAddress("Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1");
request.setTaxOffice("Tax office");
request.setTaxNumber("31300864726");
request.setLegalCompanyTitle("John Doe inc");
request.setEmail("email@submerchantemail.com");
request.setGsmNumber("+905350000000");
request.setName("John's market");
request.setIban("TR180006200119000006672315");
request.setCurrency(Currency.TRY.name());
SubMerchant subMerchant = SubMerchant.create(request, options);
iyzipay.subMerchant.create({
locale: Iyzipay.LOCALE.TR,
conversationId: '123456789',
subMerchantExternalId: 'S49222',
subMerchantType: Iyzipay.SUB_MERCHANT_TYPE.LIMITED_OR_JOINT_STOCK_COMPANY,
address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
taxOffice: 'Tax office',
taxNumber: '31300864726',
legalCompanyTitle: 'John Doe inc',
email: 'email@submerchantemail.com',
gsmNumber: '+905350000000',
name: 'John\'s market',
iban: 'TR180006200119000006672315',
currency: Iyzipay.CURRENCY.TRY
}, function (err, result) {
console.log(err, result);
done();
});
request = dict([('locale', 'tr')])
request['conversationId'] = '123456789'
request['subMerchantExternalId'] = 'S49222'
request['subMerchantType'] = 'LIMITED_OR_JOINT_STOCK_COMPANY'
request['address'] = 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1'
request['taxOffice'] = 'Tax Office'
request['taxNumber'] = '31300864726'
request['legalCompanyTitle'] = 'John Doe inc'
request['email'] = 'email@submerchantemail.com'
request['gsmNumber'] = '+905350000000'
request['name'] = 'John\'s market'
request['iban'] = 'TR180006200119000006672315'
request['currency'] = 'TRY'
sub_merchant = iyzipay.SubMerchant()
sub_merchant_response = sub_merchant.create(request, options)
request = {
locale: 'tr',
conversationId: '123456789',
subMerchantExternalId: 'S49222',
subMerchantType: Iyzipay::Model::SubMerchantType::LIMITED_OR_JOINT_STOCK_COMPANY,
address: 'Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1',
taxOffice: 'Tax office',
taxNumber: '31300864726',
legalCompanyTitle: 'John Doe inc',
email: 'email@submerchantemail.com',
gsmNumber: '+905350000000',
name: 'John\'s market',
iban: 'TR180006200119000006672315',
currency: Iyzipay::Model::Currency::TRY
}
sub_merchant = Iyzipay::Model::SubMerchant.new.create(request, @options)
//Request
{
"locale": "tr",
"conversationId": "123456789",
"name": "John's market",
"email": "email@submerchantemail.com",
"gsmNumber": "+905350000000",
"address": "Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
"iban": "TR180006200119000006672315",
"taxOffice": "Tax office",
"taxNumber": "31300864726",
"legalCompanyTitle": "John Doe inc",
"currency": "TRY",
"subMerchantExternalId": "S49222",
"subMerchantType": "LIMITED_OR_JOINT_STOCK_COMPANY"
}
//Response
{
"status": "success",
"locale": "tr",
"systemTime": 1470732341410,
"conversationId": "123456789",
"subMerchantKey": "PPFFZPedVQSvaOqZu5xpvpLEqmc="
}
Last updated