Lead - Başvuru Oluşturma

Ödeal’da bir üye işyeri oluşturmak ve oluşturulan üye iş yerine bir terminal tanımlayabilmek için kullanılan, POST metoduyla çalışan servistir.

Servise iletilen isteğin başarılı olması durumunda, servis registerRefCode değeri döndürür. registerRefCode değeri Ödeal üzerinde oluşan Başvuru ID'sini temsil etmektedir. POST isteği başarısız olduğunda hata kodu ve mesajı response çıktısında görüntülenecektir.

API Reference: Create Lead

Not: Request'deki mobile alanı hariç tüm alanlar varsayılan olarak boş bırakılabilir. İş ortağı ile yürütülen süreçlere bağlı olarak alanların zorunlu, boş ve belirli bir format ile veri kabul etmesi sağlanabilmektedir.

Register servisinden farklı olarak bir başvuru için bir terminal talebine karşılık gelmektedir. Bir üye iş yeri için birden fazla terminal talebinden bulunmak istendiğinde Register servisi kullanılmalıdır.

Örnek Request

{
    "firstName": "Testİsim",
    "lastName": "TestSoyisim",
    "tcNumber": "11111111111",
    "mobile": "5555555555",
    "taxNumber": "2222222222",
    "optionalFields": {
        "companyTitle": "Tabela İsmi",
        "businessType": "Tüzel",
        "mccCode": "3000",
       "posInstallmentType": "Tek Çekim",
        "iban": "TR200058307462136019246697",
        "setupCity": "İstanbul",
        "setupTown": "Kadıköy",
        "setupAddress": "Kadıköy/İstanbul",
        "terminalSerialNumber": "PAX721000018",
        "routingModel": "MODEL1",
        "salesType": "EDOC_POS",
        "cashRegisterType": "A910S"
      }
}

Response Örnekleri

Başarılı (200)

Request

{
  "firstName": "Test",
  "lastName": "Test",
  "tcNumber": "11111111111",
  "mobile": "5555555555",
  "taxNumber": "2222222222",
  "optionalFields": {
    "companyTitle": "Tabela İsmi",
    "businessType": "Tüzel",
    "mccCode": "3000",
    "posInstallmentType": "Tek Çekim",
    "iban": "TR200058307462136019246697",
    "setupCity": "İstanbul",
    "setupTown": "Kadıköy",
    "setupAddress": "Kadıköy/İstanbul",
    "terminalSerialNumber": "PAX721000018",
    "routingModel": "MODEL1",
    "salesType": "EDOC_POS",
    "cashRegisterType": "A910S"
  }
}

Response

{
  "status": true,
  "data": {
    "registerRefCode": "22820cf7-40f4-4a14-9845-46f94bd5082c"
  }
}

Başarısız (400)

Request

{
  "firstName": "Test",
  "lastName": "Test",
  "tcNumber": "11111111111",
  "mobile": "5555555555",
  "taxNumber": "2222222222",
  "optionalFields": {
    "cashRegisterType":"D230"
  }
}

Response

{
  "status": false,
  "message": "Alan ön kontrolleri başarısız",
  "errors": [
    "Girmiş olduğunuz cashRegisterType alan değeri geçersiz. İzin verilen değerler: [A910, A920Pro]."
  ]
}