Create Customer - Payantis Platform

Yeni bir müşteri oluşturmak için kullanılır. Kurumlar, bu API aracılığıyla müşterilerini Platform'a kaydeder ve ardından kart verilmesini sağlayabilirler.

Kurumun müşteri kaydı sırasında her müşteri için kendi ürettiği unique bir ID (customerNo) vermesi gerekmektedir, bu ID platform ile yapılacak tüm işlemlerde kullanılır. customerNo alanının formatı ve içeriği kurum tarafından belirlenir. Kurum bu alanda kendi ürettiği bir numarayı kullanabileceği gibi, TCKN, Cep telefonu numarası, PasaportNo gibi bilgileri de kullanabilir.

Müşteri oluşturulması sırasında müşteri tipi, müşteri numarası, isim ve soyisim alanları zorunludur, bu alanlar dışında kalan adres, iletişim ve kimlik bilgileri gibi bilgiler zorunlu değildir. Bununla birlikte adres ve iletişim gibi bilgilere kart oluşturma sırasında fiziksel kart teslimi gibi süreçlerde ihtiyaç duyulabilir. Bu nedenle müşteriye verilecek kartların niteliğine göre ihtiyaç olabilecek müşteri bilgilerinin girilmesi gereklidir.

Adres Bilgileri: Müşteriye her adres tipinden (Bireysel müşteriler için Home, Work, Other, şirket ve kurumsal müşteriler için HeadOffice, Branch, Other) bir adres girilebilir.

İletişim Bilgileri: Müşteriye her iletişim tipinden (Email, MobilePhone, WorkPhone, HomePhone) bir adet iletişim bilgisi girilebilir.

Kimlik Bilgileri: Müşteriye her kimlik bilgisi tipinden ( Bireysel müşteriler için NationalIdentityNo, PassportNo, DriverLicenceNo, şirket ve kurumsal müşteriler içinTaxpayerReferenceNo, BusinessNo ) bir adet kimlik bilgisi girilebilir.

Request

Body Params application/json

Example

{
    "type": "Individual",
    "customerNo": "string",
    "segmentId": 0,
    "name": "string",
    "midname": "string",
    "surname": "string",
    "nationality": "string",
    "communicationLanguage": "English",
    "gender": "Male",
    "birthDate": "2019-08-24",
    "birthPlace": "string",
    "motherName": "string",
    "fatherName": "string",
    "motherMaidenName": "string",
    "maritalStatus": "Single",
    "disabledType": "None",
    "businessDetail": {
        "companyName": "string",
        "taxNumber": "string",
        "taxOffice": "string"
    },
    "customerIdentifications": [
        {
            "type": "NationalIdentityNo",
            "value": "string",
            "dateOfIssue": "2019-08-24",
            "dateOfExpiry": "2019-08-24"
        }
    ],
    "customerAddresses": [
        {
            "addressLine1": "string",
            "addressLine2": "string",
            "addressLine3": "string",
            "district": "string",
            "city": "string",
            "state": "string",
            "postalCode": "string",
            "addressCode": "string",
            "country": "string",
            "type": "Home"
        }
    ],
    "customerCommunications": [
        {
            "type": "Email",
            "info": "string"
        }
    ]
}

Responses

🟢200OK

application/json

Body

Example

{
    "id": 0,
    "type": "Individual",
    "customerNo": "string",
    "segmentId": 0,
    "communicationLanguage": "English",
    "name": "string",
    "midname": "string",
    "surname": "string",
    "birthPlace": "string",
    "motherName": "string",
    "fatherName": "string",
    "motherMaidenName": "string",
    "birthDate": "2019-08-24",
    "nationality": "string",
    "gender": "Male",
    "maritalStatus": "Single",
    "disabledType": "None",
    "isConversion": true,
    "businessDetail": {
        "companyName": "string",
        "taxNumber": "string",
        "taxOffice": "string"
    },
    "customerIdentifications": [
        {
            "type": "NationalIdentityNo",
            "value": "string",
            "dateOfIssue": "2019-08-24",
            "dateOfExpiry": "2019-08-24",
            "id": 0,
            "lastModificationTime": "2019-08-24T14:15:22.123Z",
            "creationTime": "2019-08-24T14:15:22.123Z"
        }
    ],
    "customerAddresses": [
        {
            "addressLine1": "string",
            "addressLine2": "string",
            "addressLine3": "string",
            "district": "string",
            "city": "string",
            "state": "string",
            "postalCode": "string",
            "addressCode": "string",
            "country": "string",
            "type": "Home",
            "id": 0,
            "lastModificationTime": "2019-08-24T14:15:22.123Z",
            "creationTime": "2019-08-24T14:15:22.123Z"
        }
    ],
    "customerCommunications": [
        {
            "type": "Email",
            "info": "string",
            "id": 0,
            "lastModificationTime": "2019-08-24T14:15:22.123Z",
            "creationTime": "2019-08-24T14:15:22.123Z"
        }
    ],
    "creationTime": "2019-08-24T14:15:22.123Z",
    "passportNo": "string"
}