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

# Refresh Koneksi Bank API: Sinkronkan Sekarang

> Didit menyinkronkan koneksi bank sekarang: 202 dengan sync_id, atau 200 dengan hasil sinkronisasi jika Anda menunggu hingga 25 detik.

Endpoint Refresh a Bank Connection dari Didit meminta sinkronisasi sekarang dan merespons `202` dengan `sync_id`.
Kirim `"wait": true` untuk menunggu hingga 25 detik dan mendapatkan sinkronisasi yang sudah selesai dalam satu panggilan, tanpa biaya tambahan.
Bank membatasi akses tanpa pengawasan, sehingga panggilan dapat merespons `429 refresh_limit_reached` dengan `Retry-After`.
Lihat [Perbarui data bank sesuai permintaan](https://docs.didit.me/id/use-cases/refresh-bank-data-on-demand.md).


## OpenAPI

````yaml id/openapi-25.json POST /v3/bank/connections/{id}/refresh/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags:
  - name: Bank Data
    description: >-
      Bank Link, koneksi, akun, saldo, transaksi, institusi, dan cakupan. Data
      bank tersedia untuk aplikasi sandbox. Panggilan dari aplikasi produksi
      mengembalikan `404` hingga akses live diumumkan. Tidak ada biaya yang
      dikenakan di sandbox. Panggilan yang dibuat dengan kunci API memerlukan
      kunci yang memiliki izin Bank data (`bank-data`): baca untuk operasi baca,
      tulis untuk operasi yang mengubah sesuatu. Pemeriksaan akun adalah
      pengecualian: memerlukan akses tulis ke sesi, atau akses penuh, dan bukan
      izin Bank data. Bank data bukan bagian dari akses penuh: kunci akses penuh
      ditolak, dan panggilan menjawab `403 bank_data_access_denied` hingga Anda
      membuat kunci yang memiliki izin tersebut. Data bank mentah (akun, saldo,
      transaksi, dan umpan perubahan) juga menolak permintaan yang tidak
      menyertakan kunci API.


      Setiap penolakan di bawah `/v3/bank/` kecuali milik pemeriksaan akun
      memiliki badan JSON yang sama (`code`, `message`, `request_id`, `field`,
      `next_action`, `retry_after`). Jalur yang bukan operasi, ID yang bukan
      UUID, atau sub-resource yang tidak dikenal menjawab `404 not_found` untuk
      semua metode, dan kesalahan tak terduga apa pun menjawab `500
      internal_error` dengan `request_id`. Jika Bank data tidak tersedia, setiap
      operasi menjawab `404` standar platform, sama seperti rute yang tidak
      dikenal.
paths:
  /v3/bank/connections/{id}/refresh/:
    post:
      tags:
        - Bank Data
      summary: Segarkan koneksi bank
      description: >-
        Sinkronkan sekarang: membaca data baru dari bank kapan saja. Menjawab
        `202` dengan `sync_id`; jika sinkronisasi sudah berjalan, Anda
        mendapatkan `sync_id` yang sama, bukan tugas kedua. Dengan `"wait":
        true` di body, atau header `Prefer: wait=<seconds>` (hingga 25),
        panggilan menunggu hingga 25 detik dan menjawab `200` dengan
        sinkronisasi yang sudah selesai (`outcome`, jumlah per akun, dan
        `balances_changed`), sehingga satu permintaan mengembalikan data
        terbaru. Jika bank belum merespons dalam waktu tersebut, panggilan
        menjawab `202`: baca sinkronisasi dengan `get_sync_run` menggunakan
        `sync_id`, atau berlangganan `bank.sync.completed`. `bank.data.updated`
        menyusul hanya jika sinkronisasi menyimpan perubahan.


        Sinkronisasi live termasuk dalam harga bulanan koneksi, sama seperti
        sinkronisasi otomatis: tidak ada biaya tambahan. Satu-satunya batas
        berasal dari bank. Bank membatasi pembacaan tanpa kehadiran pengguna,
        misalnya empat kali sehari (Didit Test Bank di sandbox juga melakukan
        hal yang sama). Sinkronisasi otomatis harian (`sync.frequency_per_day`)
        dialokasikan lebih dulu dan sisanya menjadi milik Anda, sehingga
        `sync.budgets` menunjukkan sisanya dan `sync.live_syncs_left_today`
        menunjukkan berapa sinkronisasi live yang tersisa hari ini. Jadwal
        otomatis tidak pernah memakai dua pembacaan terakhir dalam sehari,
        sehingga selalu tersisa dua sinkronisasi live. Saat anggaran habis,
        panggilan menjawab `429 refresh_limit_reached` dengan `Retry-After`
        (jumlah detik hingga anggaran direset, 1 sampai 86400) dan objek `sync`
        dengan `live_syncs_left_today` dan `budgets`. Batas ini adalah plafon
        yang ditetapkan bank, bukan jaminan jumlah sinkronisasi.


        Saat sinkronisasi menyimpan perubahan, `bank.data.updated` memberi tahu
        Anda; kemudian baca feed perubahan.


        Memerlukan kunci API dengan izin Bank data (`bank-data`): tulis untuk
        operasi ini, yang mengubah sesuatu. Kunci dengan akses penuh tidak
        mencakupnya: berikan izin secara eksplisit saat Anda membuat kunci, atau
        panggilan akan menjawab `403 bank_data_access_denied`.


        Memperbarui koneksi yang sudah dihapus akan menjawab `409
        connection_not_active`.
      operationId: refreshBankConnection
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: ID koneksi.
        - $ref: '#/components/parameters/IdempotencyKey'
        - name: Prefer
          in: header
          required: false
          schema:
            type: string
            example: wait=25
          description: >-
            `wait=<seconds>` menahan panggilan hingga jumlah detik tersebut,
            maksimal 25, seperti `wait: true` pada isi permintaan.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BankRefreshRequest'
            examples:
              Wait for the result:
                summary: Tunggu hasilnya
                value:
                  wait: true
      responses:
        '200':
          description: Sinkronisasi selesai dalam 25 detik.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankSyncCompleted'
              examples:
                Finished:
                  summary: Sinkronisasi produksi yang telah selesai
                  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: >-
            Penyegaran diterima: dimasukkan ke antrean atau sudah berjalan.
            Dengan `wait`, bank tidak merespons dalam 25 detik: baca data
            sinkronisasi menggunakan `sync_id`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankRefreshAccepted'
              examples:
                Queued:
                  summary: Sinkronisasi masuk antrean
                  value:
                    sync_id: d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14
                    status: queued
                    next_refresh_at: null
        '400':
          description: >-
            Permintaan tidak valid, misalnya `wait` bukan boolean. `field`
            menyebutkannya.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Invalid request:
                  summary: Permintaan tidak valid
                  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: Sumber daya tidak ada dalam aplikasi dan lingkungan ini.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Not found:
                  summary: Tidak ditemukan
                  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: >-
            Koneksi tidak dapat disegarkan: `connection_not_active` (dicabut,
            dijeda, gagal, atau dihapus) atau `consent_expired` (perbarui dulu).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDataError'
              examples:
                Not active:
                  summary: Tidak aktif
                  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: Persetujuan kedaluwarsa
                  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: >-
            Anggaran bank untuk pengambilan data tanpa kehadiran orang tersebut
            sudah habis.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankRefreshLimitError'
              examples:
                Refresh limit reached:
                  summary: Batas penyegaran tercapai
                  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: Detik untuk menunggu sebelum meminta lagi.
              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: >-
        Kunci opsional untuk keamanan saat mencoba lagi yang Anda pilih untuk
        satu operasi, hingga 255 karakter (UUID juga dapat digunakan).
        Permintaan yang diulang dengan kunci, endpoint, query, dan body yang
        sama akan dijawab dengan respons pertama, dengan status dan body yang
        sama, dan tidak dijalankan dan tidak ditagih lagi. Kunci yang sama
        dengan endpoint, query, atau body lain akan mengembalikan `409`
        `idempotency_key_reused`, dan selama permintaan pertama masih berjalan,
        akan mengembalikan `409` `idempotency_key_in_progress` dengan
        `Retry-After`. Permintaan yang gagal (`4xx` atau `5xx` apa pun) tidak
        disimpan, sehingga Anda dapat mengirimkannya lagi dengan kunci yang
        sama. Kunci menjadi milik aplikasi Anda, baik Anda memanggil dengan
        kunci API maupun dengan token akses. Lihat [Coba lagi dan
        idempotensi](/id/integration/api-errors#coba-lagi-dan-idempotensi).
      schema:
        type: string
        minLength: 1
        maxLength: 255
  schemas:
    BankRefreshRequest:
      type: object
      description: Isi opsional dari penyegaran.
      properties:
        wait:
          type: boolean
          default: false
          description: >-
            `true` menahan panggilan hingga 25 detik dan merespons `200` dengan
            sinkronisasi yang sudah selesai, sehingga satu permintaan
            mengembalikan data terbaru. Jika bank belum merespons dalam waktu
            tersebut, panggilan merespons `202`: baca sinkronisasi dengan
            `get_sync_run` menggunakan `sync_id`, atau berlangganan
            `bank.sync.completed`. `bank.data.updated` hanya menyusul jika
            sinkronisasi menyimpan perubahan. Header `Prefer: wait=<seconds>`
            (hingga 25) memberikan hasil yang sama.
    BankSyncCompleted:
      allOf:
        - $ref: '#/components/schemas/BankSyncRun'
        - type: object
          properties:
            outcome:
              type: string
              enum:
                - succeeded
                - partial
                - failed
              description: Bagaimana sinkronisasi berakhir.
            balances_changed:
              type: boolean
              description: Apakah ada saldo yang berubah.
          required:
            - outcome
            - balances_changed
      description: >-
        Sinkronisasi yang telah selesai, dikembalikan oleh penyegaran dengan
        `wait`: eksekusi sinkronisasi beserta `outcome`-nya, jumlah per akun
        dalam `results`, dan `balances_changed`.
    BankRefreshAccepted:
      type: object
      description: >-
        Penyegaran diterima. Panggilan kedua saat sinkronisasi berjalan
        mengembalikan `sync_id` yang sama.
      properties:
        sync_id:
          type: string
          description: Sinkronisasi yang masuk antrean, atau yang sedang berjalan.
          format: uuid
        status:
          type: string
          enum:
            - queued
            - running
        next_refresh_at:
          type: string
          description: >-
            Waktu paling awal untuk meminta penyegaran baru. `null` kecuali
            anggaran telah habis.
          format: date-time
          nullable: true
      required:
        - sync_id
        - status
        - next_refresh_at
    BankDataError:
      type: object
      description: Isi kesalahan dari setiap operasi Bank data. Setiap kolom selalu ada.
      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: >-
            Kode error yang dapat dibaca mesin. Tentukan percabangan berdasarkan
            kode ini, jangan berdasarkan `message`.
        message:
          type: string
          description: >-
            Penjelasan dalam bahasa sederhana untuk pengembang. Redaksinya dapat
            berubah; jangan diurai.
        request_id:
          type: string
          description: ID permintaan ini. Sertakan ID ini saat menghubungi dukungan.
        field:
          type: string
          description: >-
            Kolom permintaan yang perlu diperbaiki, jika error berkaitan dengan
            satu kolom. Jika tidak, bernilai `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: >-
            Apa langkah berikutnya, agar klien dapat bertindak tanpa menebak.
            `null` jika tidak ada langkah berikutnya yang standar.
          nullable: true
        retry_after:
          type: integer
          description: >-
            Detik untuk menunggu sebelum mencoba lagi. Diisi pada error batas
            laju dan error sementara; jika tidak, `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: Batas sinkronisasi koneksi saat ini.
              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: >-
        Error batas penyegaran beserta batas `sync` koneksi. `Retry-After`
        berisi jumlah detik sampai kuota diatur ulang, antara 1 dan 86400.
    BankSyncRun:
      type: object
      description: >-
        Satu sinkronisasi dari sebuah koneksi. Hanya sinkronisasi awal,
        terjadwal, dan yang diminta yang ditampilkan.
      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: Apa yang dilakukan eksekusi, per rekening dan per sumber daya.
        error:
          type: object
          nullable: true
          description: >-
            Alasan seluruh proses gagal. `null` jika tidak. Kesalahan pada
            rekening dan sumber daya tunggal ada di `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: >-
        Satu bucket dari batas bank untuk pengambilan data tanpa kehadiran
        pengguna.
      properties:
        scope:
          type: string
          enum:
            - connection
            - account
          description: Apa yang dijadikan acuan bank untuk menghitung anggaran.
        resource:
          type: string
          enum:
            - all
            - accounts
            - balances
            - transactions
        account_id:
          type: string
          description: Rekening, jika `scope` bernilai `account`.
          format: uuid
          nullable: true
        limit:
          type: integer
          description: >-
            Berapa kali sehari Didit boleh mengambil data dari bank tanpa
            kehadiran orang tersebut, sesuai definisi bank. Ini adalah batas
            maksimum yang ditetapkan bank, bukan jaminan.
        remaining:
          type: integer
          description: >-
            Sisa pengambilan data untuk penyegaran Anda dalam jendela waktu saat
            ini. Pembacaan yang disisihkan untuk sinkronisasi otomatis sudah
            dikurangi, dan sinkronisasi otomatis tidak pernah mengambil dua
            pembacaan terakhir dalam sehari, sehingga dua penyegaran sesuai
            permintaan selalu tersedia.
        resets_at:
          type: string
          description: Kapan jendela waktu diatur ulang.
          format: date-time
      required:
        - scope
        - resource
        - limit
        - remaining
        - resets_at
    BankSyncRunResult:
      type: object
      properties:
        account_id:
          type: string
          description: '`null` untuk hasil yang berlaku untuk seluruh koneksi.'
          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: Wajib diisi saat `outcome` bernilai `failed`.
      required:
        - account_id
        - resource
        - outcome
        - added
        - modified
        - removed
        - error
    BankSyncError:
      type: object
      description: Alasan sinkronisasi gagal.
      properties:
        code:
          type: string
          description: Kode error Didit.
        message:
          type: string
          description: Penjelasan dalam bahasa sederhana.
        at:
          type: string
          description: Kapan kejadian itu terjadi. `null` pada hasil per rekening.
          format: date-time
          nullable: true
      required:
        - code
        - message
        - at
  responses:
    Unauthorized:
      description: Tidak diotorisasi
      content:
        application/json:
          examples:
            Invalid API Key:
              summary: Kunci API Tidak Valid
              value:
                detail: Invalid API Key.
    BankDataAccessDenied:
      description: >-
        Kunci API tidak memiliki izin Bank data (`bank-data`), atau, untuk data
        bank mentah di aplikasi live, pengaturan aplikasi "Bank data in the API"
        dinonaktifkan. Data bank bukan bagian dari akses penuh: kunci akses
        penuh, kunci yang dibatasi pada sumber daya lain, dan permintaan yang
        diautentikasi tanpa kunci API (client credentials, untuk data mentah)
        semuanya ditolak dengan isi respons ini, jadi buat kunci dan berikan
        izin secara eksplisit. Penolakan terjadi sebelum pencarian apa pun,
        sehingga tidak memberi tahu apakah objek itu ada.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BankDataError'
          examples:
            Bank data not allowed:
              summary: Data bank tidak diizinkan
              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: >-
        Terjadi kesalahan di sisi Didit. Setiap error tak terduga di bawah
        `/v3/bank/` dijawab dalam format error Bank, tidak pernah berupa halaman
        HTML: sebutkan `request_id` saat menghubungi dukungan.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BankDataError'
          examples:
            Internal error:
              summary: Kesalahan tak terduga
              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: >-
        Kunci API aplikasi Anda, dari Developers -> API keys di Business
        Console. Kunci utama memiliki akses penuh. Kunci bernama dapat dibatasi:
        tanpa akses, baca, atau tulis per sumber daya, dibatasi untuk beberapa
        alur kerja atau untuk sesi yang disetujui, ke daftar alamat IP tertentu,
        dan ke tanggal kedaluwarsa. 401 berarti kunci salah, dicabut, atau
        kedaluwarsa; 403 berarti tidak ada kunci yang dikirim, kunci tidak
        memiliki akses ke sumber daya atau tindakan ini, atau permintaan berasal
        dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi
        berada di luar alur kerja atau status yang diizinkan untuk kunci
        tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF
        sebagai null, dan kunci tanpa akses tulis sesi menerima tautan dan token
        sesi sebagai null. Lihat https://docs.didit.me/console/api-keys.

````

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