> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 은행 연결 새로고침 API: 지금 동기화

> Didit의 은행 연결 새로고침 엔드포인트는 즉시 동기화합니다. 202 응답과 sync_id를 반환하며, 최대 25초까지 기다리면 완료된 동기화 결과를 200으로 받을 수 있습니다.

Didit의 Refresh a Bank Connection 엔드포인트는 지금 동기화를 요청하며, `202`와 함께 `sync_id`를 응답합니다.
`"wait": true`를 보내면 최대 25초 동안 대기한 뒤 한 번의 호출로 완료된 동기화 결과를 받을 수 있으며, 추가 요금은 없습니다.
은행이 사용자가 없는 상태에서의 접근을 제한하므로, 호출 시 `429 refresh_limit_reached` 응답과 `Retry-After`가 반환될 수 있습니다.
[온디맨드로 은행 데이터 새로 고침](https://docs.didit.me/ko/use-cases/refresh-bank-data-on-demand.md)을 참고하세요.


## OpenAPI

````yaml ko/openapi-25.json POST /v3/bank/connections/{id}/refresh/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: 신원 인증 API입니다. x-api-key 헤더로 인증하십시오.
servers:
  - url: https://verification.didit.me
security: []
tags:
  - name: Bank Data
    description: >-
      Bank Link, 연결, 계정, 잔액, 거래, 기관 및 적용 범위. 은행 데이터는 샌드박스 애플리케이션에서 사용할 수 있습니다.
      라이브 애플리케이션의 호출은 라이브 액세스가 공지될 때까지 `404`로 응답합니다. 샌드박스에서는 요금이 부과되지 않습니다. API
      키로 수행하는 호출에는 은행 데이터 권한(`bank-data`)이 있는 키가 필요합니다. 읽기에는 read, 무언가를 변경하는
      작업에는 write 권한이 필요합니다. 계정 확인은 예외입니다. 이 경우에는 은행 데이터 권한이 아니라 세션에 대한 write 액세스
      또는 전체 액세스가 필요합니다. 은행 데이터는 전체 액세스에 포함되지 않습니다. 전체 액세스 키는 거부되며, 해당 권한이 있는 키를
      생성할 때까지 호출은 `403 bank_data_access_denied`로 응답합니다. 원시 은행 데이터(계정, 잔액, 거래 및
      변경 피드)도 API 키가 없는 요청은 거부합니다.


      `/v3/bank/` 아래에서 계정 확인을 제외한 모든 거부 응답은 동일한 JSON 본문(`code`, `message`,
      `request_id`, `field`, `next_action`, `retry_after`)을 가집니다. 작업이 아닌 경로,
      UUID가 아닌 ID 또는 알 수 없는 하위 리소스는 모든 메서드에 대해 `404 not_found`로 응답하며, 예상치 못한 오류는
      `request_id`와 함께 `500 internal_error`로 응답합니다. 은행 데이터를 사용할 수 없는 경우 모든 작업은 알
      수 없는 경로와 마찬가지로 플랫폼의 표준 `404`로 응답합니다.
paths:
  /v3/bank/connections/{id}/refresh/:
    post:
      tags:
        - Bank Data
      summary: 은행 연결 새로 고침
      description: >-
        즉시 동기화합니다. 이 호출은 언제든지 은행에 새 데이터를 요청합니다. `202`와 `sync_id`로 응답합니다. 동기화가 이미
        실행 중이면 새 작업을 만들지 않고 같은 `sync_id`를 반환합니다. 요청 본문에 `"wait": true`를 넣거나 헤더
        `Prefer: wait=<seconds>`(최대 25)를 보내면, 호출은 최대 25초 동안 기다린 후 완료된
        동기화(`outcome`, 계좌별 건수, `balances_changed`)와 함께 `200`으로 응답합니다. 따라서 요청 한
        번으로 최신 데이터를 받을 수 있습니다. 그 시간 안에 은행이 응답하지 않으면 `202`로 응답합니다. 이 경우
        `sync_id`로 `get_sync_run`을 호출해 동기화를 조회하거나 `bank.sync.completed` 이벤트를
        구독합니다. `bank.data.updated`는 동기화가 변경 사항을 저장한 경우에만 전송됩니다.


        실시간 동기화는 자동 동기화와 마찬가지로 연결의 월간 가격에 포함되므로 추가 요금은 없습니다. 유일한 제한은 은행이 정한
        제한입니다. 은행은 고객이 함께 있지 않은 상태에서의 조회 횟수를 제한합니다. 예를 들어 하루 네 번으로 제한하며, 샌드박스의
        Didit Test Bank도 같은 방식으로 동작합니다. 그날의 자동 동기화(`sync.frequency_per_day`)가 먼저
        할당되고, 나머지 횟수는 사용자가 사용할 수 있습니다. `sync.budgets`는 남은 할당량을,
        `sync.live_syncs_left_today`는 오늘 남은 실시간 동기화 횟수를 보여 줍니다. 자동 일정은 하루의 마지막 두
        번의 조회를 사용하지 않으므로, 실시간 동기화는 항상 두 번 남습니다. 할당량을 모두 사용하면 호출은 `429
        refresh_limit_reached`로 응답합니다. 이때 `Retry-After`(할당량이 재설정될 때까지 남은 초,
        1~86400)가 함께 반환되며, `live_syncs_left_today`와 `budgets`가 포함된 `sync` 객체도 함께
        제공됩니다. 이 제한은 은행이 정한 상한이며, 동기화 횟수를 보장하는 값이 아닙니다.


        동기화에서 변경 사항이 저장되면 `bank.data.updated`로 알려 드리며, 그다음 변경 피드를 조회합니다.


        이 작업은 데이터를 변경하므로 은행 데이터 권한(`bank-data`)이 있는 API 키가 필요합니다. 쓰기 권한이 필요합니다.
        전체 액세스 권한이 있는 키에는 이 권한이 포함되지 않으므로, 키를 생성할 때 명시적으로 부여해야 합니다. 그렇지 않으면 호출은
        `403 bank_data_access_denied`로 응답합니다.


        삭제된 연결을 새로 고치려고 하면 `409 connection_not_active`로 응답합니다.
      operationId: refreshBankConnection
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: 연결 ID입니다.
        - $ref: '#/components/parameters/IdempotencyKey'
        - name: Prefer
          in: header
          required: false
          schema:
            type: string
            example: wait=25
          description: >-
            `wait=<seconds>`는 지정한 초 수만큼 호출을 대기시키며, 최대 25초까지 설정할 수 있습니다. 본문의
            `wait: true`와 같은 역할을 합니다.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BankRefreshRequest'
            examples:
              Wait for the result:
                summary: 결과를 기다리기
                value:
                  wait: true
      responses:
        '200':
          description: 동기화가 25초 이내에 완료되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankSyncCompleted'
              examples:
                Finished:
                  summary: 완료된 라이브 동기화
                  value:
                    id: d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14
                    connection_id: 5e1d2a70-6b3c-4f8e-a1d9-0c7b2e4f8a36
                    trigger: requested
                    status: succeeded
                    started_at: '2026-11-21T12:30:02Z'
                    finished_at: '2026-11-21T12:30:09Z'
                    results:
                      - account_id: a71f0c2e-4d85-4b1a-9e63-2f8c0d5b7a14
                        resource: transactions
                        outcome: succeeded
                        added: 3
                        modified: 0
                        removed: 1
                        error: null
                    outcome: succeeded
                    balances_changed: true
                    error: null
        '202':
          description: >-
            새로 고침 요청이 수락되었습니다. 대기 중이거나 이미 실행 중입니다. `wait`를 사용했는데 은행이 25초 안에 응답하지
            않았다면, `sync_id`를 사용해 동기화 결과를 조회합니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankRefreshAccepted'
              examples:
                Queued:
                  summary: 동기화가 대기열에 추가되었습니다
                  value:
                    sync_id: d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14
                    status: queued
                    next_refresh_at: null
        '400':
          description: 요청 본문이 올바르지 않습니다. 예를 들어 `wait`가 불리언이 아닙니다. `field`에 해당 필드명이 표시됩니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Invalid request:
                  summary: 잘못된 요청
                  value:
                    code: invalid_request
                    message: The request is not valid.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: wait
                    next_action: null
                    retry_after: null
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/BankDataAccessDenied'
        '404':
          description: 이 애플리케이션과 환경에 리소스가 존재하지 않습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Not found:
                  summary: 찾을 수 없음
                  value:
                    code: not_found
                    message: The resource does not exist.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: null
                    retry_after: null
        '409':
          description: >-
            연결을 새로 고칠 수 없습니다. `connection_not_active`(취소됨, 일시 중지됨, 실패함 또는 삭제됨)
            또는 `consent_expired`(먼저 갱신해야 함)입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Not active:
                  summary: 활성 상태가 아님
                  value:
                    code: connection_not_active
                    message: This connection is not active.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: create_link
                    retry_after: null
                Consent expired:
                  summary: 동의가 만료됨
                  value:
                    code: consent_expired
                    message: The consent ended. Renew the connection to sync again.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: renew_connection
                    retry_after: null
        '429':
          description: 사용자가 없는 상태에서 이루어지는 조회에 대한 은행의 예산이 모두 소진되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankRefreshLimitError'
              examples:
                Refresh limit reached:
                  summary: 새로 고침 한도에 도달했습니다.
                  value:
                    code: refresh_limit_reached
                    message: >-
                      The bank's limit on fetches without the person present is
                      used up for today.
                    request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                    field: null
                    next_action: retry_later
                    retry_after: 3600
                    sync:
                      live_syncs_left_today: 0
                      budgets:
                        - scope: connection
                          resource: all
                          limit: 4
                          remaining: 0
                          resets_at: '2026-11-22T00:00:00Z'
          headers:
            Retry-After:
              description: 다시 요청하기 전에 기다릴 시간(초)입니다.
              schema:
                type: integer
        '500':
          $ref: '#/components/responses/BankDataInternalError'
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X POST
            'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/refresh/'
            \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.bank.refresh_connection(
                "11111111-2222-3333-4444-555555555555",
                wait=True,
            )
            print(result)
        - lang: javascript
          label: Node.js
          source: >-
            import Didit from "@didit-protocol/sdk-node";


            // Reads DIDIT_API_KEY.

            const didit = new Didit();


            const result = await
            didit.bank.refreshConnection("11111111-2222-3333-4444-555555555555",
            {
              wait: true,
            });

            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Bank.RefreshConnection(ctx, \"11111111-2222-3333-4444-555555555555\", didit.BankRefreshConnectionParams{\n\tBody: didit.BankRefreshRequest{\n\t\tWait: didit.Bool(true),\n\t},\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: >-
            import me.didit.Didit;

            import me.didit.types.BankRefreshConnectionParams;

            import me.didit.types.BankRefreshRequest;


            // Reads DIDIT_API_KEY.

            Didit client = new Didit();


            var result =
            client.bank().refreshConnection("11111111-2222-3333-4444-555555555555",
            BankRefreshConnectionParams.builder()
                    .wait_(true)
                    .build());
            System.out.println(result);
        - lang: php
          label: PHP
          source: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $result =
            $didit->bank->refreshConnection('11111111-2222-3333-4444-555555555555',
            [
                'wait' => true,
            ]);

            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY.
            didit = Didit::Client.new

            result = didit.bank.refresh_connection(
              "11111111-2222-3333-4444-555555555555",
              wait: true
            )
            puts result.to_h
        - lang: csharp
          label: .NET
          source: >-
            using System;

            using System.Text.Json;

            using Didit;


            // Reads DIDIT_API_KEY.

            using var client = new DiditClient();


            var result = await
            client.Bank.RefreshConnectionAsync("11111111-2222-3333-4444-555555555555",
            new BankRefreshRequest

            {
                Wait = true,
            });

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  parameters:
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      required: false
      description: >-
        한 작업을 위해 직접 정하는 선택적 재시도 안전 키입니다. 최대 255자이며 UUID를 사용할 수 있습니다. 같은 키,
        엔드포인트, 쿼리, 본문으로 반복된 요청에는 첫 번째 응답이 같은 상태 코드와 같은 본문으로 반환되며, 다시 실행되거나 다시
        과금되지 않습니다. 같은 키를 다른 엔드포인트, 쿼리 또는 본문과 함께 사용하면 `409`
        `idempotency_key_reused`가 반환되고, 첫 번째 요청이 아직 실행 중이면 `Retry-After`와 함께
        `409` `idempotency_key_in_progress`가 반환됩니다. 실패한 요청(모든 `4xx` 또는 `5xx`)은
        저장되지 않으므로 같은 키로 다시 보낼 수 있습니다. 키는 API 키로 호출하든 액세스 토큰으로 호출하든 사용자의 애플리케이션에
        속합니다. [재시도 및 멱등성](/ko/integration/api-errors#재시도와-멱등성)을 참고하세요.
      schema:
        type: string
        minLength: 1
        maxLength: 255
  schemas:
    BankRefreshRequest:
      type: object
      description: 선택 사항입니다. 새로 고침 요청의 본문입니다.
      properties:
        wait:
          type: boolean
          default: false
          description: >-
            `true`이면 최대 25초 동안 호출을 대기시키고, 동기화가 완료되면 `200`으로 응답하므로 한 번의 요청으로 최신
            데이터를 받을 수 있습니다. 그 시간 안에 은행이 응답하지 않으면 호출은 `202`로 응답합니다. 이 경우
            `sync_id`를 사용해 `get_sync_run`으로 동기화를 조회하거나 `bank.sync.completed`를
            구독하십시오. `bank.data.updated`는 동기화에서 변경 사항이 저장된 경우에만 발송됩니다. `Prefer:
            wait=<seconds>` 헤더(최대 25)도 같은 역할을 합니다.
    BankSyncCompleted:
      allOf:
        - $ref: '#/components/schemas/BankSyncRun'
        - type: object
          properties:
            outcome:
              type: string
              enum:
                - succeeded
                - partial
                - failed
              description: 동기화가 종료된 방식입니다.
            balances_changed:
              type: boolean
              description: 잔액이 하나라도 변경되었는지 여부입니다.
          required:
            - outcome
            - balances_changed
      description: >-
        `wait`와 함께 요청한 갱신에서 반환된 완료된 동기화입니다. `outcome`이 포함된 동기화 실행, `results`의
        계좌별 건수, `balances_changed`를 포함합니다.
    BankRefreshAccepted:
      type: object
      description: 갱신 요청이 수락되었습니다. 동기화가 실행 중일 때 두 번째 호출은 같은 `sync_id`를 반환합니다.
      properties:
        sync_id:
          type: string
          description: 대기열에 추가된 동기화 또는 이미 실행 중인 동기화입니다.
          format: uuid
        status:
          type: string
          enum:
            - queued
            - running
        next_refresh_at:
          type: string
          description: >-
            새 새로고침을 요청할 수 있는 가장 이른 시점입니다. 예산이 소진된 경우에만 값이 있으며, 그렇지 않으면
            `null`입니다.
          format: date-time
          nullable: true
      required:
        - sync_id
        - status
        - next_refresh_at
    BankDataError:
      type: object
      description: 모든 은행 데이터 작업의 오류 본문입니다. 모든 필드가 항상 포함됩니다.
      properties:
        code:
          type: string
          enum:
            - ongoing_access_not_available
            - segment_not_available
            - window_not_available
            - history_window_ambiguous
            - redirect_url_not_registered
            - link_origin_not_allowed
            - bank_data_access_denied
            - connection_not_active
            - consent_expired
            - renewal_not_needed
            - renewal_window_expired
            - access_removed
            - refresh_limit_reached
            - cursor_expired
            - page_expired
            - invalid_cursor
            - page_token_mismatch
            - contract_rate_missing
            - insufficient_credits
            - invalid_request
            - not_found
            - internal_error
          description: 기계가 읽을 수 있는 오류 코드입니다. 분기 처리는 이 값으로 하고, `message`로는 하지 마십시오.
        message:
          type: string
          description: 개발자를 위한 쉬운 설명입니다. 문구는 변경될 수 있으므로 파싱하지 않아야 합니다.
        request_id:
          type: string
          description: 이 요청의 ID입니다. 지원팀에 문의할 때 이 값을 알려 주십시오.
        field:
          type: string
          description: 오류가 하나의 필드와 관련된 경우 수정해야 할 요청 필드입니다. 그렇지 않으면 `null`입니다.
          nullable: true
        next_action:
          type: string
          enum:
            - retry_later
            - renew_connection
            - create_link
            - restart_from_cursor
            - restart_read
            - top_up_balance
            - enable_bank_data_access
            - contact_support
            - null
          description: 클라이언트가 추측하지 않고 조치할 수 있도록 다음 단계를 안내합니다. 표준 다음 단계가 없으면 `null`입니다.
          nullable: true
        retry_after:
          type: integer
          description: 재시도 전에 기다릴 시간(초)입니다. 속도 제한 및 일시적 오류에 설정되며, 그 외에는 `null`입니다.
          nullable: true
      required:
        - code
        - message
        - request_id
        - field
        - next_action
        - retry_after
      example:
        code: ongoing_access_not_available
        message: >-
          This bank cannot keep access open. Use access one_time or choose
          another bank.
        request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
        field: institution_id
        next_action: create_link
        retry_after: null
    BankRefreshLimitError:
      allOf:
        - $ref: '#/components/schemas/BankDataError'
        - type: object
          properties:
            sync:
              type: object
              description: 연결의 현재 동기화 한도입니다.
              properties:
                live_syncs_left_today:
                  type: integer
                  nullable: true
                  minimum: 0
                budgets:
                  type: array
                  items:
                    $ref: '#/components/schemas/BankSyncBudget'
              required:
                - live_syncs_left_today
                - budgets
          required:
            - sync
      description: >-
        연결의 `sync` 한도가 적용된 새로 고침 한도 오류입니다. `Retry-After`에는 사용 한도가 재설정될 때까지의 초 단위
        시간이 담기며, 값은 1에서 86400 사이입니다.
    BankSyncRun:
      type: object
      description: 연결의 동기화 한 번입니다. 초기, 예약 및 요청된 동기화만 나열됩니다.
      properties:
        id:
          type: string
          format: uuid
        connection_id:
          type: string
          format: uuid
        trigger:
          type: string
          enum:
            - initial
            - scheduled
            - requested
        status:
          type: string
          enum:
            - queued
            - running
            - succeeded
            - partial
            - failed
        started_at:
          type: string
          format: date-time
          nullable: true
        finished_at:
          type: string
          format: date-time
          nullable: true
        results:
          type: array
          items:
            $ref: '#/components/schemas/BankSyncRunResult'
          description: 계좌와 리소스별로 실행 결과가 무엇인지 나타냅니다.
        error:
          type: object
          nullable: true
          description: >-
            실행 전체가 실패한 이유입니다. 실패하지 않은 경우 `null`입니다. 개별 계정과 리소스의 오류는 `results`에
            있습니다.
          properties:
            code:
              type: string
            message:
              type: string
            at:
              type: string
              format: date-time
          required:
            - code
            - message
            - at
      required:
        - id
        - connection_id
        - trigger
        - status
        - started_at
        - finished_at
        - results
        - error
    BankSyncBudget:
      type: object
      description: 사용자가 없는 상태에서 은행이 허용하는 가져오기 한도의 한 구간입니다.
      properties:
        scope:
          type: string
          enum:
            - connection
            - account
          description: 은행이 예산을 계산할 때 기준으로 삼는 항목입니다.
        resource:
          type: string
          enum:
            - all
            - accounts
            - balances
            - transactions
        account_id:
          type: string
          description: '`scope`가 `account`인 경우의 계좌입니다.'
          format: uuid
          nullable: true
        limit:
          type: integer
          description: >-
            은행이 정의한 대로, 사용자가 없는 상태에서 Didit이 은행에서 데이터를 가져올 수 있는 하루 횟수입니다. 이는 은행이
            설정한 상한이며, 보장되는 값이 아닙니다.
        remaining:
          type: integer
          description: >-
            현재 기간에 새로고침에 사용할 수 있는 잔여 조회 횟수입니다. 자동 동기화에 예약된 조회는 이미 차감되었습니다. 자동
            동기화는 하루의 마지막 두 조회를 사용하지 않으므로, 수동 새로고침 두 번은 항상 남아 있습니다.
        resets_at:
          type: string
          description: 기간이 초기화되는 시점입니다.
          format: date-time
      required:
        - scope
        - resource
        - limit
        - remaining
        - resets_at
    BankSyncRunResult:
      type: object
      properties:
        account_id:
          type: string
          description: 연결 전체의 결과인 경우 `null`입니다.
          format: uuid
          nullable: true
        resource:
          type: string
          enum:
            - accounts
            - balances
            - transactions
        outcome:
          type: string
          enum:
            - succeeded
            - failed
            - skipped
        added:
          type: integer
        modified:
          type: integer
        removed:
          type: integer
        error:
          allOf:
            - $ref: '#/components/schemas/BankSyncError'
          nullable: true
          description: '`outcome`이 `failed`인 경우 필수입니다.'
      required:
        - account_id
        - resource
        - outcome
        - added
        - modified
        - removed
        - error
    BankSyncError:
      type: object
      description: 동기화가 실패한 이유입니다.
      properties:
        code:
          type: string
          description: Didit 오류 코드입니다.
        message:
          type: string
          description: 쉬운 설명입니다.
        at:
          type: string
          description: 발생한 시점입니다. 계좌별 결과에서는 `null`입니다.
          format: date-time
          nullable: true
      required:
        - code
        - message
        - at
  responses:
    Unauthorized:
      description: 인증되지 않음
      content:
        application/json:
          examples:
            Invalid API Key:
              summary: 잘못된 API 키
              value:
                detail: Invalid API Key.
    BankDataAccessDenied:
      description: >-
        API 키에 은행 데이터 권한(`bank-data`)이 없거나, 프로덕션 애플리케이션에서 원시 은행 데이터를 조회하는 경우
        애플리케이션 설정 "Bank data in the API"가 꺼져 있습니다. 은행 데이터는 전체 액세스 권한에 포함되지 않습니다.
        전체 액세스 키, 다른 리소스로 제한된 키, 그리고 API 키 없이 인증된 요청(클라이언트 자격 증명, 원시 데이터 대상)은 모두
        이 응답으로 거부됩니다. 따라서 키를 새로 만들고 명시적으로 권한을 부여하십시오. 이 거부는 어떤 조회보다 먼저 이루어지므로,
        객체의 존재 여부와는 관계가 없습니다.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BankDataError'
          examples:
            Bank data not allowed:
              summary: 은행 데이터 접근이 허용되지 않음
              value:
                code: bank_data_access_denied
                message: >-
                  Bank data calls need an API key that carries the Bank data
                  permission.
                request_id: 3f6a1c8e-92b5-4d07-a1e3-8c4b7f0d2e59
                field: null
                next_action: enable_bank_data_access
                retry_after: null
    BankDataInternalError:
      description: >-
        Didit 측에서 문제가 발생했습니다. `/v3/bank/` 아래의 예기치 않은 오류는 HTML 페이지가 아닌 Bank 오류
        형식으로 응답합니다. 지원팀에 `request_id`를 알려 주십시오.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BankDataError'
          examples:
            Internal error:
              summary: 예상치 못한 오류
              value:
                code: internal_error
                message: >-
                  Something went wrong on our side. Quote the request_id to
                  support.
                request_id: 3f6a1c8e92b54d07a1e38c4b7f0d2e59
                field: null
                next_action: contact_support
                retry_after: null
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        귀사 애플리케이션의 API 키입니다. Business Console의 Developers -> API keys에서 확인할 수
        있습니다. 기본 키는 모든 권한을 가집니다. 명명된 키는 범위를 지정할 수 있습니다. 리소스별로 권한 없음, 읽기 또는 쓰기를
        설정할 수 있고, 일부 워크플로나 승인된 세션으로 제한할 수 있으며, 허용된 IP 목록으로 제한할 수 있고, 만료일을 설정할 수
        있습니다. 401은 키가 잘못되었거나, 취소되었거나, 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스
        또는 작업에 대한 권한이 없거나, 요청이 IP 목록 밖의 주소에서 왔음을 의미합니다. 세션 경로에서 발생한 404는 세션이 키의
        워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 동영상 및 PDF URL을 null로
        받으며, 세션 쓰기 권한이 없는 키는 세션 링크와 토큰을 null로 받습니다. 자세한 내용은
        https://docs.didit.me/console/api-keys 를 참조합니다.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.