> ## 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.

# Platform fraud uyarısını reddet



## OpenAPI

````yaml /api-reference/fraud/openapi.json post /api/v1/platform/fraud/alerts/{id}/reject
openapi: 3.0.4
info:
  title: Payven Fraud API
  description: Payven Fraud — gerçek zamanlı risk skorlama ve fraud kural motoru.
  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://fraud-sandbox.payven.com.tr
    description: Sandbox
  - url: https://fraud.payven.com.tr
    description: Production
security:
  - bearerAuth: []
tags:
  - name: PlatformFraudAlerts
    x-displayName: Platform Fraud Uyarıları
  - name: PlatformFraudBlacklist
    x-displayName: Platform Kara Liste
  - name: PlatformFraudRules
    x-displayName: Platform Fraud Kuralları
  - name: TenantFraudAlerts
    x-displayName: Fraud Uyarıları
  - name: TenantFraudBlacklist
    x-displayName: Kara Liste
  - name: TenantFraudLogs
    x-displayName: Fraud Logları
  - name: TenantFraudMerchantPolicies
    x-displayName: Bayi Fraud Politikaları
  - name: TenantFraudRules
    x-displayName: Fraud Kuralları
paths:
  /api/v1/platform/fraud/alerts/{id}/reject:
    post:
      tags:
        - PlatformFraudAlerts
      summary: Platform fraud uyarısını reddet
      operationId: rejectPlatformFraudAlert
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: Idempotency-Key
          in: header
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResolveBody'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FraudAlertDto'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '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:
    ResolveBody:
      type: object
      properties:
        notes:
          type: string
          nullable: true
      additionalProperties: false
    FraudAlertDto:
      type: object
      properties:
        id:
          type: string
          format: uuid
        fraud_check_log_id:
          type: string
          format: uuid
        tenant_id:
          type: string
          format: uuid
        merchant_external_id:
          type: string
          nullable: true
        process:
          $ref: '#/components/schemas/FraudProcess'
        external_txn_id:
          type: string
          nullable: true
        amount_minor:
          type: integer
          format: int64
        currency:
          type: string
          nullable: true
        score:
          type: integer
          format: int32
        reason_codes:
          type: string
          nullable: true
        status:
          $ref: '#/components/schemas/FraudAlertStatus'
        assigned_to:
          type: string
          nullable: true
        reviewed_by:
          type: string
          nullable: true
        reviewed_at:
          type: string
          format: date-time
          nullable: true
        notes:
          type: string
          nullable: true
        expires_at:
          type: string
          format: date-time
        created:
          type: string
          format: date-time
      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: {}
    FraudProcess:
      enum:
        - sanal_pos
        - para_transferi
        - fatura_odeme
      type: string
    FraudAlertStatus:
      enum:
        - open
        - approved
        - rejected
        - expired
      type: string
  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>`. Token alma: POST /api/v1/auth/{slug}/token

````