> ## Documentation Index > Fetch the complete documentation index at: https://docs.payven.com.tr/llms.txt > Use this file to discover all available pages before exploring further. # IBAN doğrula ## OpenAPI ````yaml /api-reference/identity/openapi.json post /api/v1/validation/iban openapi: 3.0.4 info: title: Payven Identity API description: >- Payven Identity — OAuth 2.0 kimlik doğrulama, API anahtarı yönetimi ve banka/BIN/MCC referans servisleri. termsOfService: https://payven.com.tr/sozlesmeler contact: name: Payven Developer Support url: https://docs.payven.com.tr email: destek@payven.com.tr license: name: Payven API License url: https://payven.com.tr/sozlesmeler/api-lisansi version: '1.0' servers: - url: https://identity-sandbox.payven.com.tr description: Sandbox - url: https://identity.payven.com.tr description: Production security: - bearerAuth: [] tags: - name: Auth x-displayName: Kimlik Doğrulama - name: Lookups x-displayName: Lookup Servisleri - name: Me x-displayName: Oturum - name: Merchants x-displayName: Bayiler - name: Permissions x-displayName: İzinler - name: PlatformFeatures x-displayName: Platform Özellikleri - name: PlatformPlans x-displayName: Platform Planları - name: PlatformTenantApiKeys x-displayName: Platform Tenant API Anahtarları - name: PlatformTenants x-displayName: Platform Tenant'lar - name: TenantApiKeys x-displayName: API Anahtarları - name: TenantRoles x-displayName: Roller - name: Users x-displayName: Kullanıcılar - name: Validation x-displayName: Validasyon paths: /api/v1/validation/iban: post: tags: - Validation summary: IBAN doğrula operationId: validateIban parameters: - name: Idempotency-Key in: header schema: type: string requestBody: content: application/json; ver=1.0: schema: $ref: '#/components/schemas/ValidateIbanRequest' text/json; ver=1.0: schema: $ref: '#/components/schemas/ValidateIbanRequest' application/*+json; ver=1.0: schema: $ref: '#/components/schemas/ValidateIbanRequest' responses: '200': description: OK content: text/plain; ver=1.0: schema: $ref: '#/components/schemas/IbanValidationResultDto' application/json; ver=1.0: schema: $ref: '#/components/schemas/IbanValidationResultDto' text/json; ver=1.0: schema: $ref: '#/components/schemas/IbanValidationResultDto' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '409': $ref: '#/components/responses/Conflict' '422': $ref: '#/components/responses/UnprocessableEntity' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' '503': $ref: '#/components/responses/ServiceUnavailable' components: schemas: ValidateIbanRequest: type: object properties: iban: type: string nullable: true resolve: type: boolean additionalProperties: false IbanValidationResultDto: type: object properties: is_valid: type: boolean checksum_valid: type: boolean format_valid: type: boolean country_code: type: string nullable: true check_digits: type: string nullable: true bank_code: type: string nullable: true formatted_iban: type: string nullable: true masked_iban: type: string nullable: true bank: $ref: '#/components/schemas/BankDto' error_message: type: string nullable: true additionalProperties: false BankDto: type: object properties: id: type: string format: uuid code: type: string nullable: true name: type: string nullable: true swift_code: type: string nullable: true logo_url: type: string nullable: true is_active: type: boolean additionalProperties: false ProblemDetails: type: object properties: type: type: string nullable: true title: type: string nullable: true status: type: integer format: int32 nullable: true detail: type: string nullable: true instance: type: string nullable: true additionalProperties: {} responses: BadRequest: description: Geçersiz istek (eksik alan, bozuk JSON). content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: https://docs.payven.com.tr/errors/bad_request title: Geçersiz istek status: 400 code: bad_request detail: amount.amount alanı zorunlu. correlation_id: 9f1c8e76-2a3b-4f12-9c8d-12cb24a8a8a8 Unauthorized: description: '`Authorization` header eksik, geçersiz veya süresi dolmuş.' content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: https://docs.payven.com.tr/errors/invalid_token title: Geçersiz token status: 401 code: invalid_token detail: Access token geçersiz veya süresi dolmuş — refresh edin. Forbidden: description: Yetki yok, lisans yok veya merchant pasif. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: https://docs.payven.com.tr/errors/forbidden title: Yetki yok status: 403 code: forbidden detail: Bu rol bu kaynağı göremez. Conflict: description: Idempotency çakışması veya geçersiz durum geçişi. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: https://docs.payven.com.tr/errors/idempotency_key_in_use title: Idempotency-Key çakışması status: 409 code: idempotency_key_in_use detail: >- Bu Idempotency-Key daha önce farklı bir istek gövdesi ile kullanıldı. UnprocessableEntity: description: >- Validasyon veya iş kuralı ihlali (`bank_declined`, `validation_failed`, `fraud_blocked` vb.). content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: https://docs.payven.com.tr/errors/bank_declined title: Banka işlemi reddetti status: 422 code: bank_declined detail: 'Yetersiz bakiye (banka kodu: 51)' provider_error_code: '51' TooManyRequests: description: Rate limit aşıldı. `Retry-After` header'ına uyun. headers: Retry-After: description: Yeniden denemeden önce beklemeniz gereken saniye sayısı. schema: type: integer content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: https://docs.payven.com.tr/errors/rate_limit_exceeded title: İstek limiti aşıldı status: 429 code: rate_limit_exceeded ServerError: description: >- Sunucu hatası. Exponential backoff ile tekrar deneyin (Idempotency-Key ile). content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: https://docs.payven.com.tr/errors/internal_server_error title: Sunucu hatası status: 500 code: internal_server_error ServiceUnavailable: description: >- Hedef konnektör geçici olarak devre dışı (circuit breaker açık) veya bağımlılık servisi erişilemez. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: https://docs.payven.com.tr/errors/connector_unavailable title: Konnektör erişilemez status: 503 code: connector_unavailable securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Identity servisinden alinan Keycloak JWT. Format: `Authorization: Bearer `. Token alma: POST /api/v1/auth/{slug}/token ````