> ## 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. # Transferi getir ## OpenAPI ````yaml /api-reference/transfer/openapi.json get /api/v1/transfers/{id} openapi: 3.0.4 info: title: Payven Para Transferi API description: >- Payven Para Transferi — çoklu banka EFT, FAST, havale ve banka hesabı transferi 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://transfer-sandbox.payven.com.tr description: Sandbox - url: https://transfer.payven.com.tr description: Production security: - bearerAuth: [] tags: - name: Accounts x-displayName: Hesaplar - name: ApiRequestLogs x-displayName: API İstek Kayıtları - name: BankBins x-displayName: Banka BIN'leri - name: Banks x-displayName: Bankalar - name: ConnectorAccounts x-displayName: Konnektör Hesapları - name: ConnectorAccountTransferRules x-displayName: Konnektör Hesap Transfer Kuralları - name: ConnectorConfigurations x-displayName: Konnektör Konfigürasyonları - name: Connectors x-displayName: Konnektörler - name: Dashboard x-displayName: Dashboard - name: Me x-displayName: Oturum - name: ReceiverAccounts x-displayName: Alıcı Hesapları - name: Recipients x-displayName: Alıcılar - name: RecurringTransfers x-displayName: Tekrarlayan Transferler - name: Settings x-displayName: Ayarlar - name: Transfers x-displayName: Transferler - name: Validation x-displayName: Validasyon - name: Webhooks x-displayName: Webhook'lar paths: /api/v1/transfers/{id}: get: tags: - Transfers summary: Transferi getir operationId: getTransfer parameters: - name: id in: path required: true schema: type: string format: uuid responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/TransferDto' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' '503': $ref: '#/components/responses/ServiceUnavailable' x-codeSamples: - lang: curl label: cURL source: >- curl -X GET https://transfer-sandbox.payven.com.tr/api/v1/transfers/8e3f5c12-9a7b-4c8d-bc4e-2c963f66afa6 \ -H "Authorization: Bearer $PAYVEN_TOKEN" - lang: javascript label: Node.js source: |- const res = await fetch( "https://transfer-sandbox.payven.com.tr/api/v1/transfers/8e3f5c12-9a7b-4c8d-bc4e-2c963f66afa6", { method: "GET", headers: { Authorization: `Bearer ${accessToken}`, "Content-Type": "application/json", }, }, ); const data = await res.json(); - lang: python label: Python source: |- import httpx res = httpx.get( "https://transfer-sandbox.payven.com.tr/api/v1/transfers/8e3f5c12-9a7b-4c8d-bc4e-2c963f66afa6", headers={ "Authorization": f"Bearer {access_token}", }, ) data = res.json() - lang: csharp label: C# source: >- var req = new HttpRequestMessage(HttpMethod.Get, "https://transfer-sandbox.payven.com.tr/api/v1/transfers/8e3f5c12-9a7b-4c8d-bc4e-2c963f66afa6"); req.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken); var resp = await http.SendAsync(req); - lang: go label: Go source: >- req, _ := http.NewRequest("GET", "https://transfer-sandbox.payven.com.tr/api/v1/transfers/8e3f5c12-9a7b-4c8d-bc4e-2c963f66afa6", nil) req.Header.Set("Authorization", "Bearer "+accessToken) resp, _ := http.DefaultClient.Do(req) - lang: php label: PHP source: >- $ch = curl_init("https://transfer-sandbox.payven.com.tr/api/v1/transfers/8e3f5c12-9a7b-4c8d-bc4e-2c963f66afa6"); curl_setopt_array($ch, [ CURLOPT_CUSTOMREQUEST => "GET", CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer $accessToken", ], ]); $data = json_decode(curl_exec($ch), true); components: schemas: TransferDto: allOf: - $ref: '#/components/schemas/ExtraPropertiesDto' - type: object properties: id: type: string format: uuid merchant_id: type: string format: uuid request_id: type: string nullable: true external_id: type: string nullable: true receipt_no: type: string nullable: true description: type: string nullable: true receiver_account_id: type: string format: uuid nullable: true request_sender_account_id: type: string format: uuid nullable: true success_sender_account_id: type: string format: uuid nullable: true amount: type: integer format: int64 currency: allOf: - $ref: '#/components/schemas/CurrencyCode' request_transfer_type: allOf: - $ref: '#/components/schemas/TransferType' success_transfer_type: allOf: - $ref: '#/components/schemas/TransferType' nullable: true fee_amount: type: integer format: int64 scheduled_date: type: string format: date-time processed_date: type: string format: date-time nullable: true validate_date: type: string format: date-time nullable: true sent_date: type: string format: date-time nullable: true status: allOf: - $ref: '#/components/schemas/TransferStatus' retry_count: type: integer format: int32 receiver_account: allOf: - $ref: '#/components/schemas/ReceiverAccountDto' nullable: true request_sender_connector_account: allOf: - $ref: '#/components/schemas/ConnectorAccountDto' nullable: true success_sender_connector_account: allOf: - $ref: '#/components/schemas/ConnectorAccountDto' nullable: true additionalProperties: false ExtraPropertiesDto: type: object properties: extra_properties_dict: type: object additionalProperties: type: string nullable: true additionalProperties: false CurrencyCode: enum: - TRY - USD - EUR type: string TransferType: enum: - EFT - Fast - Remittance - CreditCard type: string TransferStatus: enum: - Pending - Approved - Rejected - Processing - Delivered - Completed - Failed - Refunded type: string ReceiverAccountDto: allOf: - $ref: '#/components/schemas/ExtraPropertiesDto' - type: object properties: id: type: string format: uuid bank_id: type: string format: uuid recipient_id: type: string format: uuid nullable: true holder_name: type: string nullable: true description: type: string nullable: true account_number: type: string nullable: true iban: type: string nullable: true masked_card_no: type: string nullable: true card_token: type: string nullable: true bank_name: type: string nullable: true bank_code: type: string nullable: true additionalProperties: false ConnectorAccountDto: allOf: - $ref: '#/components/schemas/ExtraPropertiesDto' - type: object properties: id: type: string format: uuid connector_configuration_id: type: string format: uuid bank_id: type: string format: uuid holder_name: type: string nullable: true description: type: string nullable: true account_number: type: string nullable: true iban: type: string nullable: true masked_card_no: type: string nullable: true card_token: type: string nullable: true connector_configuration_name: type: string nullable: true connector_name: type: string nullable: true connector_code: type: string nullable: true bank_name: type: string nullable: true bank_code: type: string 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: {} 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. NotFound: description: Kaynak bulunamadı. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' example: type: https://docs.payven.com.tr/errors/resource_not_found title: Kaynak bulunamadı status: 404 code: resource_not_found 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 ````