> ## 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. # Konnektör detaylı bilgisini getir ## OpenAPI ````yaml /api-reference/sanal-pos/openapi.json get /api/v1/connectors/{id}/detail openapi: 3.0.4 info: title: Payven Sanal POS API description: >- Payven Sanal POS — çoklu banka kart ödemeleri, 3D Secure, akıllı yönlendirme, mutabakat ve webhook altyapısı. 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://vpos-sandbox.payven.com.tr description: Sandbox - url: https://vpos.payven.com.tr description: Production security: - bearerAuth: [] tags: - name: ApiRequestLogs x-displayName: API İstek Kayıtları - name: CancellationRequests x-displayName: İptal Talepleri - name: Chargebacks x-displayName: Chargeback - name: CheckoutSessions x-displayName: Hosted Checkout - name: ConnectorConfigurations x-displayName: Konnektör Konfigürasyonları - name: ConnectorErrorCodes x-displayName: Konnektör Hata Kodları - name: Connectors x-displayName: Konnektörler - name: Dashboard x-displayName: Dashboard - name: Health x-displayName: Sağlık - name: MerchantBankProfiles x-displayName: Bayi Banka Profilleri - name: Payments x-displayName: Ödemeler - name: Reconciliations x-displayName: Mutabakat - name: Refunds x-displayName: İadeler - name: RoutingRules x-displayName: Yönlendirme Kuralları - name: Settings x-displayName: Ayarlar - name: Settlements x-displayName: Settlement - name: SimpleRoutingRules x-displayName: Basit Yönlendirme Kuralları - name: TestCards x-displayName: Test Kartları - name: Trace x-displayName: Trace - name: Transactions x-displayName: İşlemler - name: Webhooks x-displayName: Webhook'lar paths: /api/v1/connectors/{id}/detail: get: tags: - Connectors summary: Konnektör detaylı bilgisini getir operationId: getConnectorDetail parameters: - name: id in: path required: true schema: type: string format: uuid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ConnectorDetailDto' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': description: Not Found content: application/json: schema: oneOf: - $ref: '#/components/schemas/ProblemDetails' - $ref: '#/components/schemas/HttpValidationProblemDetails' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' '503': $ref: '#/components/responses/ServiceUnavailable' components: schemas: ConnectorDetailDto: required: - connector - health type: object properties: connector: allOf: - $ref: '#/components/schemas/ConnectorDto' nullable: true configurations: type: array items: $ref: '#/components/schemas/ConnectorConfigurationDto' nullable: true health: allOf: - $ref: '#/components/schemas/ConnectorHealthDto' nullable: true error_codes: type: array items: $ref: '#/components/schemas/ConnectorErrorCodeDto' nullable: true changelog: type: array items: $ref: '#/components/schemas/ConnectorChangelogEntryDto' nullable: true 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: {} HttpValidationProblemDetails: allOf: - $ref: '#/components/schemas/ProblemDetails' - type: object properties: errors: type: object additionalProperties: type: array items: type: string nullable: true additionalProperties: {} ConnectorDto: allOf: - $ref: '#/components/schemas/ExtraPropertiesDto' - type: object properties: id: type: string format: uuid name: type: string nullable: true code: type: string nullable: true type: allOf: - $ref: '#/components/schemas/ConnectorType' is_active: type: boolean created: type: string format: date-time last_modified: type: string format: date-time configuration_count: type: integer format: int32 additionalProperties: false ConnectorConfigurationDto: allOf: - $ref: '#/components/schemas/ExtraPropertiesDto' - type: object properties: id: type: string format: uuid connector_id: type: string format: uuid connector_name: type: string nullable: true connector_code: type: string nullable: true name: type: string nullable: true mode: allOf: - $ref: '#/components/schemas/ConnectorMode' api_key: type: string nullable: true secret_key: type: string nullable: true username: type: string nullable: true password: type: string nullable: true terminal_id: type: string nullable: true store_id: type: string nullable: true api_endpoint_url: type: string nullable: true three_d_secure_endpoint_url: type: string nullable: true extra_credentials: type: string nullable: true bank_code: type: string nullable: true priority: type: integer format: int32 is_active: type: boolean created: type: string format: date-time last_modified: type: string format: date-time additionalProperties: false ConnectorHealthDto: required: - rollup type: object properties: rollup: allOf: - $ref: '#/components/schemas/ConnectorHealthRollupDto' nullable: true per_configuration: type: array items: $ref: '#/components/schemas/ConnectorConfigurationHealthDto' nullable: true additionalProperties: false ConnectorErrorCodeDto: type: object properties: id: type: string format: uuid connector_code: type: string nullable: true provider_error_code: type: string nullable: true category: type: string nullable: true turkish_message: type: string nullable: true english_message: type: string nullable: true internal_description: type: string nullable: true should_retry: type: boolean http_status_suggestion: type: integer format: int32 nullable: true mapped_to_id: type: string format: uuid nullable: true mapped_to_code: type: string nullable: true additionalProperties: false ConnectorChangelogEntryDto: required: - action - actor - entity_kind - id type: object properties: id: type: string nullable: true at: type: string format: date-time actor: type: string nullable: true action: type: string nullable: true entity_kind: type: string nullable: true entity_id: type: string format: uuid note: type: string nullable: true diff: type: array items: $ref: '#/components/schemas/ConnectorChangelogDiffDto' nullable: true additionalProperties: false ExtraPropertiesDto: type: object properties: extra_properties_dict: type: object additionalProperties: type: string nullable: true additionalProperties: false ConnectorType: enum: - NestPay - HalkBankVPOS - GarantiVPOS - VakifbankVPOS - IsBankVPOS - QNBFinansbankVPOS - DenizBankVPOS - YapiKrediVPOS - ZiraatVPOS - KuveytTurkVPOS - EnparaVPOS - Custom type: string ConnectorMode: enum: - Test - Production type: string ConnectorHealthRollupDto: required: - status type: object properties: status: type: string nullable: true success_rate: type: integer format: int32 sample_size: type: integer format: int32 success_count: type: integer format: int32 failure_count: type: integer format: int32 last_transaction_at: type: string format: date-time nullable: true last_calculated_at: type: string format: date-time sparkline: type: array items: type: integer format: int32 nullable: true last_error: allOf: - $ref: '#/components/schemas/LastErrorDto' nullable: true additionalProperties: false ConnectorConfigurationHealthDto: required: - status type: object properties: connector_configuration_id: type: string format: uuid status: type: string nullable: true success_rate: type: integer format: int32 sample_size: type: integer format: int32 success_count: type: integer format: int32 failure_count: type: integer format: int32 last_transaction_at: type: string format: date-time nullable: true last_calculated_at: type: string format: date-time sparkline: type: array items: type: integer format: int32 nullable: true last_error: allOf: - $ref: '#/components/schemas/LastErrorDto' nullable: true additionalProperties: false ConnectorChangelogDiffDto: required: - field type: object properties: field: type: string nullable: true before: type: string nullable: true after: type: string nullable: true additionalProperties: false LastErrorDto: required: - message type: object properties: code: type: string nullable: true message: type: string nullable: true at: type: string format: date-time additionalProperties: false responses: 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. 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 ````