> ## Documentation Index > Fetch the complete documentation index at: https://docs.sarraf.pro/llms.txt > Use this file to discover all available pages before exploring further. # Yeni müşteri oluşturma (müşteri tanı formatında) > Müşteri tanı (KYC) formatında yeni kayıt oluşturur: sarraf_accord.verifications içine onay bekleyen bir form yazılır (isApproval daima false doğar; API doğrudan onaylı müşteri yaratmaz). Aynı idNo ile onay bekleyen form varsa 409 CONFLICT döner ve details içinde existingId verilir. Salt okunur alanlar (isApproval, masakStatus, companiesId vb.) gönderilirse 400 döner. ## OpenAPI ````yaml /api-reference/openapi.json post /v1/customers openapi: 3.0.3 info: title: Sarraf API v1 version: 1.0.0 description: >- Sarraf sürümlü dış API yüzeyi. Bu sürüm salt okunurdur; e-ticaret siteleri ve muhasebe programları için mevcut kayıtların okunmasını sağlar. Kimlik doğrulama mevcut dış API ile aynıdır: HTTP Basic, base64(apiUserId:secretKey). Tüm yanıtlar sabit zarf formatındadır: başarılı yanıtta success/data/meta, hatalı yanıtta success/error{code,message,details}/traceId. Her yanıtta x-request-id başlığı döner ve traceId ile aynıdır. servers: - url: https://api.sarraf.pro description: Canlı ortam security: - BasicAuth: [] tags: - name: Customers description: Cari hesaplar — listeleme, detay ve müşteri tanı formatında oluşturma x-group: Müşteriler - name: Bank accounts description: Banka hesapları, bakiyeler ve sorgu tetikleme x-group: Banka - name: Bank transactions description: Gelen/giden banka hareketleri — detayda gömülü MASAK özeti x-group: Banka - name: Invoices description: Sistem üzerinden kesilen faturalar ve kalem şablonları x-group: Faturalar - name: Expenses description: Gider pusulası kayıtları x-group: Giderler - name: Compliance description: >- Müşteri tanı formları, kimlik belgeleri, yaptırım sorguları, sicil, denetim ve IDV kayıtları x-group: Uyum (Compliance) paths: /v1/customers: post: tags: - Customers summary: Yeni müşteri oluşturma (müşteri tanı formatında) description: >- Müşteri tanı (KYC) formatında yeni kayıt oluşturur: sarraf_accord.verifications içine onay bekleyen bir form yazılır (isApproval daima false doğar; API doğrudan onaylı müşteri yaratmaz). Aynı idNo ile onay bekleyen form varsa 409 CONFLICT döner ve details içinde existingId verilir. Salt okunur alanlar (isApproval, masakStatus, companiesId vb.) gönderilirse 400 döner. operationId: createCustomer requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CustomerCreateRequest' responses: '201': description: >- Müşteri tanı formu oluşturuldu; durum takibi GET /v1/compliance/verifications/{id} ile yapılır. headers: x-request-id: description: İstek kimliği; yanıt gövdesindeki meta.requestId ile aynıdır. schema: type: string format: uuid content: application/json: schema: $ref: '#/components/schemas/CustomerCreateResponse' '400': $ref: '#/components/responses/ValidationFailed' '401': $ref: '#/components/responses/Unauthorized' '409': description: >- Aynı idNo ile onay bekleyen form zaten var (details[0].existingId mevcut kaydı gösterir). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': $ref: '#/components/responses/InternalError' components: schemas: CustomerCreateRequest: type: object description: >- Yazma uçlarında gövde zarfı: data zorunludur. Salt okunur alanlar (isApproval, isSigned, isDeleted, masakStatus, companiesId, userId, approval*, requirementsSnapshot, printSnapshot, contractVersion, uuid vb.) ve bilinmeyen alanlar 400 döner. properties: data: type: object properties: idNo: type: string description: TCKN / VKN / belge numarası (zorunlu). nameSurname: type: string description: Ad soyad / ünvan (zorunlu). idType: type: string enum: - person - company default: person idCardType: type: string enum: - idCard - passport - dlCard - other default: idCard nationality: type: string default: TR birthplace: type: string birthday: type: string phone: type: string phone2: type: string email: type: string iban: type: string taxOffice: type: string registryNo: type: string activityName: type: string naceCode: type: string countriesCode: type: string countries: type: string statesCode: type: string states: type: string cities: type: string address: type: string motherName: type: string fatherName: type: string jobName: type: string isAbroad: type: boolean onlyInvoice: type: boolean description: Yalnız fatura kaydı olarak oluştur. customerRelation: $ref: '#/components/schemas/CustomerRelation' required: - idNo - nameSurname required: - data CustomerCreateResponse: type: object properties: success: type: boolean enum: - true data: $ref: '#/components/schemas/CustomerListItem' meta: $ref: '#/components/schemas/MetaBase' required: - success - data - meta ErrorResponse: type: object properties: success: type: boolean enum: - false error: $ref: '#/components/schemas/ErrorBody' traceId: type: string format: uuid description: x-request-id başlığı ile aynı değer. required: - success - error - traceId CustomerRelation: type: object description: Kurumsal formda temsilci/ortak/gerçek faydalanıcı bilgisi. properties: types: type: string enum: - representative - shareholder - beneficialOwner nameSurname: type: string nullable: true nationality: type: string nullable: true idCardType: type: string nullable: true idNo: type: string nullable: true birthplace: type: string nullable: true birthday: type: string nullable: true phone: type: string nullable: true email: type: string nullable: true beneficialDescription: type: string nullable: true title: type: string nullable: true authorityStartDate: type: string format: date-time nullable: true authorityEndDate: type: string format: date-time nullable: true isPrimary: type: boolean nullable: true CustomerListItem: type: object properties: id: type: string description: Kayıt kimliği (ObjectId). idNo: type: string description: TCKN / VKN / belge numarası. Tam ve maskesiz döner. idType: type: string enum: - person - company idCardType: type: string enum: - idCard - passport - dlCard - other description: dlCard = ehliyet. nameSurname: type: string phone: type: string nullable: true email: type: string nullable: true nationality: type: string example: TR countries: type: string nullable: true states: type: string nullable: true cities: type: string nullable: true labels: type: array items: type: string recordLevel: type: integer enum: - 0 - 1 - 2 - 3 - 4 description: 0 kayıt yok, 1 normal, 2 güvenli, 3 riskli, 4 yasaklı. isVerify: type: boolean description: Müşteri tanı (doğrulama) durumu. isValid: type: boolean description: Kimlik doğrulama (TCKN/NVI) durumu. isPhoto: type: boolean description: Fotoğraf/belge görseli varlığı. saveType: type: string enum: - bank - manual - idCard - accord description: Kaydın oluşma kaynağı. createdDate: type: string format: date-time lastDate: type: string format: date-time updatedAt: type: string format: date-time MetaBase: type: object properties: requestId: type: string format: uuid timestamp: type: string format: date-time required: - requestId - timestamp ErrorBody: type: object properties: code: type: string enum: - VALIDATION_FAILED - AUTH_INVALID_CREDENTIALS - AUTH_FORBIDDEN - RESOURCE_NOT_FOUND - CONFLICT - UPSTREAM_ERROR - INTERNAL_ERROR message: type: string details: type: array items: $ref: '#/components/schemas/ErrorDetail' required: - code - message - details ErrorDetail: type: object properties: field: type: string rule: type: string responses: ValidationFailed: description: Doğrulama hatası (geçersiz parametre). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: Kimlik doğrulama başarısız. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalError: description: Beklenmeyen sunucu hatası. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: BasicAuth: type: http scheme: basic description: >- Kullanıcı adı apiUserId, parola secretKey. Authorization: Basic base64(apiUserId:secretKey) ````