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

# Kirim Transaksi via SDK: KYT Sisi Klien

> Kirim transaksi dari perangkat pengguna dengan token SDK terbatas di Didit: intelijen perangkat otomatis dan action_required untuk kepemilikan dompet.



Prompt API Kirim Transaksi (Token SDK)
        Salin prompt ke papan klip



      
      

\<pre>

\`Submit a monitored transaction from an end-user device using a scoped SDK token instead of an API key. This is the wire endpoint behind the Didit SDKs' submitTransaction methods - call it directly only when not using an SDK.

Endpoint:
POST https://verification.didit.me/v1/transactions/

Authentication:
X-Transaction-Token header carrying an sdk_token minted by your backend via POST /v3/transactions/sdk-token/. No API key on the device, ever.

Payload (camelCase wire shape - each field maps onto its POST /v3/transactions/ equivalent):
\{
"txnId": "wd-2026-07-07-0042",              // -> transaction_id (required)
"type": "travelRule",                        // -> transaction_category (required)
"info": {                                    // -> transaction_details (required)
"direction": "out", "amount": "0.25", "currency": "ETH",
"currencyType": "crypto", "cryptoParams": {"crypto_chain": "ETH"}   // -> currency_kind, crypto_params
},
"subject": { "fullName": "Jane Doe" },       // externalUserId is IGNORED - identity comes from the token
"counterparty": {
"fullName": "Ana Diaz",
"paymentMethod": {"type": "unhosted_wallet", "accountId": "0x8ba1f109551bD432803012645Ac136ddd64DBA72"}  // type -> method_type; declares a self-hosted wallet
},
"travelRule": {                              // -> travel_rule_details
"status": "AWAITING_COUNTERPARTY",         // required (400 if missing); ignored when Travel Rule is enabled
"beneficiaryData": {"wallet_address": "0x8ba1f109551bD432803012645Ac136ddd64DBA72", "name": "Ana Diaz"}
},
"props": { "channel": "mobile_app" },        // -> custom_properties
"includeCryptoScreening": true
}

Three things are always decided by the token, never the payload:
\- the application the transaction is created under
\- the subject identity (token's vendor_data)
\- server-derived device context (IP, user agent) - it wins on conflict.

What to read from the response (same snake_case detail as /v3/, plus):
\- status - APPROVED | IN_REVIEW | DECLINED | AWAITING_USER.
\- travel_rule.status - the Travel Rule exchange state, when applicable.
\- action_required - when the end user must act: type "wallet_ownership" (open the url in a real browser, never a webview) or "verification_session" (launch with your Didit verification integration). null when nothing is pending.

Failure modes:
\- 401 - token missing, unknown, revoked, over max_uses, or expired ("expired" appears in the detail for expired tokens).
\- 400 - validation errors, with per-field details keyed by the canonical field names (a missing info.currency is reported as {"transaction_details": {"currency": [...]}}), including a txnId that already exists.
\- 409 - a concurrent request with the same txnId was created first.

Afterwards:
\- Re-read with GET /v1/transactions/{transaction_id}/ (same token) after the user completes an action.
\- Your backend also receives transaction.created / transaction.status.updated webhooks with the same action_required block.

Full guide: /transaction-monitoring/sdk-transaction-submission.`

\</pre>



      
      

Tempel ke



## OpenAPI

````yaml id/openapi-25.json POST /v1/transactions/
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: []
paths:
  /v1/transactions/:
    post:
      tags:
        - Transactions
      summary: Kirim transaksi dari SDK
      description: >-
        Endpoint yang menghadap perangkat yang dipanggil oleh SDK Didit untuk
        mengirimkan transaksi langsung dari perangkat pengguna akhir.
        Autentikasi berupa token dengan cakupan terbatas dari `POST
        /v3/transactions/sdk-token/` yang dikirim dalam header
        `X-Transaction-Token` alih-alih kunci API, dan endpoint ini mengaktifkan
        CORS sehingga browser dapat memanggilnya secara lintas asal
        (cross-origin). Payload menggunakan alias transmisi camelCase yang
        ditampilkan di bawah ini (metode `submitTransaction` SDK menyusunnya
        untuk Anda). Tiga jaminan sisi server: aplikasi selalu diambil dari
        token; identitas subjek (`externalUserId`) selalu diberlakukan dari
        `vendor_data` token, sehingga nilai payload palsu diabaikan; dan
        intelijen perangkat (sidik jari perangkat SDK ditambah IP serta user
        agent yang diturunkan dari server) dilampirkan ke subjek secara
        otomatis.
      operationId: submitTransactionFromSdk
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                txnId:
                  type: string
                  description: >-
                    Pengidentifikasi unik Anda untuk transaksi ini (dipetakan ke
                    `transaction_id`, maks 128 karakter).
                  example: wd-2026-07-07-0042
                txnDate:
                  type: string
                  format: date-time
                  description: >-
                    Kapan transaksi terjadi (memetakan ke `transaction_at`).
                    Defaultnya adalah sekarang jika dihilangkan.
                zoneId:
                  type: string
                  description: >-
                    Pengenal zona waktu IANA (memetakan ke `time_zone`),
                    misalnya `Europe/Madrid`.
                type:
                  type: string
                  description: >-
                    Kategori transaksi (dipetakan ke `transaction_category`),
                    misalnya `finance`, `kyc`, `travelRule`,
                    `userPlatformEvent`, `gamblingBet`.
                  example: travelRule
                info:
                  type: object
                  description: >-
                    Detail keuangan inti dari transaksi (memetakan ke
                    `transaction_details`).
                  required:
                    - direction
                    - amount
                    - currency
                  properties:
                    direction:
                      type: string
                      description: >-
                        Arah relatif terhadap subjek. Tidak peka huruf
                        besar/kecil; `in`/`out` diterima sebagai alias.
                        Dikembalikan dalam huruf besar (`INBOUND`/`OUTBOUND`).
                      example: out
                    amount:
                      type: number
                      description: >-
                        Jumlah transaksi (hingga 18 tempat desimal). String
                        desimal juga diterima dan merupakan satu-satunya cara
                        untuk mempertahankan lebih dari sekitar 15 digit
                        signifikan: angka JSON diurai sebagai float biner
                        terlebih dahulu, sehingga `0.123456789012345678`
                        disimpan sebagai `0.12345678901234568`.
                      example: 0.25
                    currency:
                      type: string
                      description: >-
                        Kode mata uang. Kode alfabet ISO 4217 apa pun diterima
                        (misalnya `EUR`, `USD`, `NGN`), begitu pula simbol aset
                        kripto (misalnya `BTC`). Sebaiknya gunakan kode yang
                        saat ini beredar. Tidak semua kode yang diterima
                        memiliki nilai tukar: jika tidak ada nilai tukar yang
                        tersedia untuk kode tersebut (misalnya unit akuntansi
                        ISO `XSU`, atau simbol kripto yang harganya tidak
                        ditetapkan oleh Didit), konversi otomatis gagal dan
                        `preferred_currency_amount` dikembalikan sebagai null
                        kecuali permintaan menyertakan `amountInDefaultCurrency`
                        yang telah dikonversi sebelumnya.
                      example: ETH
                    currencyType:
                      type: string
                      description: >-
                        Apakah mata uang berupa `fiat` atau `crypto` (memetakan
                        ke `currency_kind`).
                    amountInDefaultCurrency:
                      type: number
                      nullable: true
                      description: >-
                        Jumlah yang dikonversi sebelumnya dalam mata uang
                        default (dipetakan ke `amount_in_default_currency`).
                        Jika dihilangkan, konversi valas otomatis akan dicoba.
                    defaultCurrencyCode:
                      type: string
                      description: >-
                        Kode mata uang default untuk jumlah yang dikonversi
                        (memetakan ke `default_currency`). Kode ISO 4217 apa pun
                        yang saat ini beredar.
                    paymentDetails:
                      type: string
                      nullable: true
                      description: >-
                        Referensi atau memo pembayaran teks bebas (dipetakan ke
                        `payment_details`).
                    paymentTxnId:
                      type: string
                      nullable: true
                      description: >-
                        Referensi pembayaran eksternal (dipetakan ke
                        `payment_reference_id`); hash transaksi on-chain untuk
                        transaksi kripto.
                    type:
                      type: string
                      nullable: true
                      description: >-
                        Subtipe transaksi (dipetakan ke `action_type`), misalnya
                        `deposit`, `withdrawal`, `transfer`.
                    cryptoParams:
                      type: object
                      description: >-
                        Parameter khusus kripto, misalnya `{"crypto_chain":
                        "ETH"}`.
                subject:
                  type: object
                  description: >-
                    Subjek (pemohon) transaksi. `externalUserId` diabaikan di
                    sini: identitas subjek selalu ditetapkan berdasarkan
                    `vendor_data` token.
                  required:
                    - fullName
                  properties:
                    type:
                      type: string
                      description: >-
                        Tipe entitas (dipetakan ke `entity_type`): `individual`
                        (default) atau `company`.
                    externalUserId:
                      type: string
                      description: >-
                        Diabaikan pada subjek - diberlakukan di sisi server
                        berdasarkan `vendor_data` pada token.
                    fullName:
                      type: string
                      example: Jane Doe
                    firstName:
                      type: string
                    lastName:
                      type: string
                    dob:
                      type: string
                      format: date
                      description: >-
                        Tanggal lahir (YYYY-MM-DD; dipetakan ke
                        `date_of_birth`).
                    address:
                      type: object
                      description: >-
                        Objek alamat dengan `country` (ISO 3166-1 alpha-3),
                        `town`, `state`, `street`, `post_code`.
                    institutionInfo:
                      type: object
                      description: >-
                        Detail institusi untuk peserta institusional (memetakan
                        ke `institution_details`).
                    device:
                      type: object
                      description: >-
                        Konteks perangkat eksplisit opsional. Digabungkan dengan
                        data intelijen perangkat yang diambil secara otomatis;
                        kolom yang diturunkan dari server akan diprioritaskan
                        jika terjadi konflik.
                    paymentMethod:
                      type: object
                      description: >-
                        Metode pembayaran yang digunakan oleh subjek (dipetakan
                        ke `payment_method`).
                      properties:
                        type:
                          type: string
                          description: >-
                            Jenis metode pembayaran (dipetakan ke
                            `method_type`), misalnya `bank_card`,
                            `bank_account`, `crypto_wallet`, `ewallet`,
                            `unhosted_wallet`, `other`.
                        accountId:
                          type: string
                          description: >-
                            Pengidentifikasi akun (memetakan ke `account_id`):
                            IBAN, sidik jari kartu, atau alamat dompet.
                        issuingCountry:
                          type: string
                          description: >-
                            Kode negara ISO 3166-1 alpha-3 dari penerbit
                            (dipetakan ke `issuing_country`).
                counterparty:
                  type: object
                  description: >-
                    Pihak lawan dari transaksi (opsional). Bentuknya sama dengan
                    `subject`; `externalUserId` bermakna di sini.
                  properties:
                    type:
                      type: string
                      description: >-
                        Tipe entitas (dipetakan ke `entity_type`): `individual`
                        atau `company`.
                    externalUserId:
                      type: string
                      description: >-
                        Pengenal internal Anda untuk pihak lawan (dipetakan ke
                        `vendor_data`).
                    fullName:
                      type: string
                    firstName:
                      type: string
                    lastName:
                      type: string
                    dob:
                      type: string
                      format: date
                    address:
                      type: object
                    institutionInfo:
                      type: object
                    device:
                      type: object
                    paymentMethod:
                      type: object
                      description: >-
                        Metode pembayaran yang digunakan oleh pihak lawan
                        (dipetakan ke `payment_method`). Pada transaksi
                        travelRule, `type: "unhosted_wallet"` mendeklarasikan
                        dompet pihak lawan sebagai dompet swakelola: transfer
                        melewati perutean VASP pihak lawan, dibuat langsung
                        dalam `UNCONFIRMED_OWNERSHIP`, dan (ketika
                        `auto_wallet_verification` diaktifkan) sesi widget
                        kepemilikan dompet dibuat secara otomatis dan
                        dikembalikan di `action_required` sehingga SDK dapat
                        meluncurkannya.
                      properties:
                        type:
                          type: string
                          description: >-
                            Jenis metode pembayaran (dipetakan ke
                            `method_type`), misalnya `bank_card`,
                            `bank_account`, `crypto_wallet`, `ewallet`,
                            `unhosted_wallet`, `other`. Gunakan
                            `unhosted_wallet` untuk mendeklarasikan dompet
                            swakelola untuk Travel Rule.
                        accountId:
                          type: string
                          description: >-
                            Pengidentifikasi akun (memetakan ke `account_id`):
                            IBAN, sidik jari kartu, atau alamat dompet.
                        issuingCountry:
                          type: string
                props:
                  type: object
                  additionalProperties: true
                  description: >-
                    Pasangan kunci-nilai kustom (memetakan ke
                    `custom_properties`). Setiap kunci dapat direferensikan
                    dalam kondisi aturan sebagai `custom_values.<key>`.
                travelRule:
                  type: object
                  description: >-
                    Detail Travel Rule (dipetakan ke `travel_rule_details`).
                    Saat Travel Rule diaktifkan untuk aplikasi, Didit
                    mengabaikan `status` apa pun yang Anda kirim dan menjalankan
                    pertukaran itu sendiri.
                  required:
                    - status
                  properties:
                    status:
                      type: string
                    protocol:
                      type: string
                    required:
                      type: boolean
                    obligationsCount:
                      type: integer
                    originatorData:
                      type: object
                    beneficiaryData:
                      type: object
                    metadata:
                      type: object
                includeCryptoScreening:
                  type: boolean
                  nullable: true
                  description: >-
                    Override per transaksi untuk skrining analitik blockchain
                    kripto (memetakan ke `include_crypto_screening`).
                fingerprint_v2:
                  type: object
                  description: >-
                    Payload sidik jari perangkat `didit-fp-v2`. Disuntikkan
                    secara otomatis oleh SDK; hanya relevan saat memanggil wire
                    API secara langsung.
              required:
                - txnId
                - type
                - info
                - subject
            example:
              txnId: wd-2026-07-07-0042
              type: travelRule
              info:
                direction: out
                amount: '0.25'
                currency: ETH
                currencyType: crypto
                cryptoParams:
                  crypto_chain: ETH
              subject:
                fullName: Jane Doe
              counterparty:
                fullName: Ana Diaz
                paymentMethod:
                  type: unhosted_wallet
                  accountId: 0xBeneficiaryWallet01
              travelRule:
                status: AWAITING_COUNTERPARTY
                beneficiaryData:
                  wallet_address: 0xBeneficiaryWallet01
                  name: Ana Diaz
              includeCryptoScreening: true
      responses:
        '201':
          description: >-
            Transaksi dikirimkan dan dipantau. Bentuk detail sama dengan `GET
            /v3/transactions/{transaction_id}/`, termasuk blok `action_required`
            saat pengguna akhir harus menyelesaikan tindakan lanjutan (SDK
            meluncurkannya secara otomatis secara default).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetail'
              examples:
                Wallet ownership required:
                  value:
                    uuid: 22222222-3333-4444-5555-666666666666
                    txn_id: wd-2026-07-07-0042
                    transaction_type: travelRule
                    direction: OUTBOUND
                    status: APPROVED
                    amount: '0.25'
                    currency: ETH
                    travel_rule:
                      uuid: 33333333-4444-5555-6666-777777777777
                      status: UNCONFIRMED_OWNERSHIP
                      required: true
                    action_required:
                      type: wallet_ownership
                      url: https://verify.didit.me/wallet-ownership/3s9x...urlsafe
                      widget_session_id: 77777777-8888-9999-aaaa-bbbbbbbbbbbb
                      expires_at: '2026-07-07T13:00:00Z'
        '400':
          description: >-
            Validasi gagal (kolom wajib tidak ada, duplikasi `txnId`, kategori
            tidak dikenal).
          content:
            application/json:
              examples:
                Missing fields:
                  value:
                    transaction_details:
                      currency:
                        - This field is required.
                Duplicate txnId:
                  value:
                    transaction_id:
                      - A transaction with this transaction_id already exists.
        '401':
          description: >-
            Token transaksi ditolak: hilang, tidak dikenal, dicabut, melebihi
            `max_uses`, atau kedaluwarsa. Respons token kedaluwarsa selalu
            memuat kata `expired` dalam detailnya, yang digunakan SDK untuk
            membedakan kesalahan `expired_token` dari `invalid_token`.
          content:
            application/json:
              examples:
                Invalid token:
                  value:
                    detail: Invalid transaction token.
                Expired token:
                  value:
                    detail: Transaction token expired.
        '409':
          description: >-
            Permintaan lain dengan `txnId` yang sama membuat transaksi saat
            permintaan ini sedang diproses, sehingga hanya satu dari dua
            pengiriman simultan yang berhasil. Baca transaksi yang ada alih-alih
            mengirim ulang.
          content:
            application/json:
              examples:
                Concurrent duplicate:
                  value:
                    detail: A transaction with this transaction_id already exists.
      security:
        - TransactionTokenAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: |-
            curl -X POST https://verification.didit.me/v1/transactions/ \
              -H 'X-Transaction-Token: SDK_TOKEN' -H 'Content-Type: application/json' \
              -d '{"txnId": "wd-2026-07-07-0042", "type": "travelRule", "info": {"direction": "out", "amount": "0.25", "currency": "ETH", "currencyType": "crypto"}, "subject": {"fullName": "Jane Doe"}, "counterparty": {"fullName": "Ana Diaz", "paymentMethod": {"type": "unhosted_wallet", "accountId": "0xBeneficiaryWallet01"}}, "travelRule": {"status": "AWAITING_COUNTERPARTY", "beneficiaryData": {"wallet_address": "0xBeneficiaryWallet01", "name": "Ana Diaz"}}, "includeCryptoScreening": true}'
        - lang: javascript
          label: Web SDK
          source: |-
            import { DiditSdk } from '@didit-protocol/sdk-web';

            const result = await DiditSdk.shared.submitTransaction({
              transactionToken: sdkToken,
              transaction: {
                txnId: 'wd-2026-07-07-0042',
                category: 'travelRule',
                details: { direction: 'out', amount: '0.25', currency: 'ETH', currencyType: 'crypto' },
                subject: { fullName: 'Jane Doe' },
                counterparty: { fullName: 'Ana Diaz', paymentMethod: { type: 'unhosted_wallet', accountId: '0xBeneficiaryWallet01' } },
                travelRule: { status: 'AWAITING_COUNTERPARTY', beneficiaryData: { wallet_address: '0xBeneficiaryWallet01', name: 'Ana Diaz' } },
                includeCryptoScreening: true
              },
              onActionCompleted: (refreshed) => console.log(refreshed.status)
            });
components:
  schemas:
    TransactionDetail:
      type: object
      description: >-
        Catatan pemantauan lengkap untuk satu transaksi, sebagaimana
        dikembalikan oleh `GET /v3/transactions/{transaction_id}/` dan `POST
        /v3/transactions/`.
      properties:
        uuid:
          type: string
          format: uuid
          description: >-
            Pengenal transaksi yang stabil dari Didit. Gunakan sebagai
            `{transaction_id}` untuk panggilan tindak lanjut.
        environment:
          type: string
          enum:
            - live
            - sandbox
          description: >-
            Lingkungan aplikasi yang memiliki transaksi tersebut. Transaksi
            `sandbox` disimpan tetapi tidak pernah dievaluasi, diskrining,
            diberitahukan, atau ditagih, sehingga `rule_runs` yang kosong
            berarti "tidak dievaluasi".
        transaction_number:
          type: integer
          description: >-
            Nomor transaksi berurutan dalam cakupan aplikasi yang ditampilkan di
            Konsol (misalnya `4123`).
        txn_id:
          type: string
          description: >-
            `transaction_id` yang Anda berikan saat dibuat (maks 128 karakter).
            Unik per aplikasi.
        txn_date:
          type: string
          format: date-time
          description: >-
            Kapan transaksi terjadi (dari `transaction_at`; defaultnya adalah
            waktu pengiriman).
        zone_id:
          type: string
          nullable: true
          description: Pengenal zona waktu IANA yang diberikan saat dibuat.
        transaction_type:
          type: string
          description: >-
            Kategori tingkat atas sebagaimana disimpan: `finance`, `kyc`,
            `travelRule`, `userPlatformEvent`, `gamblingBet`,
            `gamblingLimitChange`, `gamblingBonusChange`, `auditTrailEvent`.
            Perhatikan bahwa nilai multi-kata dikembalikan dalam camelCase
            bahkan ketika dikirimkan dalam snake_case.
        action_type:
          type: string
          description: >-
            Subtipe dalam kategori tersebut (misalnya `deposit`, `withdrawal`,
            `transfer`). Default ke kategori jika tidak disediakan.
        direction:
          type: string
          enum:
            - INBOUND
            - OUTBOUND
          description: >-
            Arah relatif terhadap subjek. Disimpan dalam huruf besar terlepas
            dari format huruf yang dikirim (`in`/`out`/`inbound`/`outbound`
            diterima sebagai input).
        status:
          type: string
          enum:
            - APPROVED
            - IN_REVIEW
            - DECLINED
            - AWAITING_USER
          description: >-
            Keputusan pemantauan saat ini. Transaksi dibuat dengan status
            `APPROVED`; aturan dapat mengubahnya menjadi `IN_REVIEW`/`DECLINED`
            secara sinkron.
        source:
          type: string
          enum:
            - LIVE
            - IMPORTED
          description: >-
            Bagaimana catatan berasal: `LIVE` untuk transaksi yang dikirimkan
            melalui API atau SDK, `IMPORTED` untuk transaksi yang dimuat melalui
            impor konsol.
        amount:
          type: string
          description: >-
            Jumlah transaksi sebagai string desimal dengan nol di akhir yang
            dihilangkan (misalnya `"1500"`, `"0.5"`, `"0.123456789012345678"`).
            Hingga 18 tempat desimal.
        currency:
          type: string
          description: >-
            Kode mata uang untuk `amount`. Kode alfabet ISO 4217 apa pun
            diterima (misalnya `EUR`, `USD`, `NGN`), begitu pula simbol aset
            kripto (misalnya `BTC`). Sebaiknya gunakan kode yang saat ini
            beredar. Tidak semua kode yang diterima memiliki nilai tukar: jika
            tidak ada nilai tukar yang tersedia untuk kode tersebut (misalnya
            unit akuntansi ISO `XSU`, atau simbol kripto yang harganya tidak
            ditetapkan oleh Didit), konversi otomatis gagal dan
            `preferred_currency_amount` dikembalikan sebagai null kecuali
            permintaan menyertakan `amount_in_default_currency` yang telah
            dikonversi sebelumnya.
        currency_type:
          type: string
          nullable: true
          description: '`fiat` atau `crypto`, sebagaimana dikirimkan dalam `currency_kind`.'
        amount_in_default_currency:
          type: string
          nullable: true
          description: >-
            Jumlah yang Anda berikan setelah dikonversi sebelumnya, sebagai
            string desimal dengan angka nol di belakangnya dihapus.
        default_currency_code:
          type: string
          nullable: true
        preferred_currency_amount:
          type: string
          nullable: true
          description: '`amount` dikonversi ke mata uang pilihan aplikasi, jika tersedia.'
        preferred_currency_code:
          type: string
          nullable: true
        payment_details:
          type: string
          nullable: true
          description: Referensi atau memo pembayaran teks bebas dari pengiriman.
        payment_txn_id:
          type: string
          nullable: true
          description: >-
            Referensi sistem pembayaran eksternal (misalnya hash transaksi
            blockchain) dari `payment_reference_id`.
        score:
          type: integer
          description: >-
            Skor risiko yang diakumulasikan oleh aturan (biasanya 0–100). Lebih
            tinggi = lebih berisiko.
        severity:
          type: string
          nullable: true
          enum:
            - UNKNOWN
            - LOW
            - MEDIUM
            - HIGH
            - CRITICAL
          description: >-
            Tingkat keparahan risiko kategoris yang ditetapkan oleh
            aturan/penyedia (`UNKNOWN`, `LOW`, `MEDIUM`, `HIGH`, `CRITICAL`).
            Bernilai `null` hingga ada yang menetapkannya.
        decision_reason_code:
          type: string
          nullable: true
          description: Alasan yang dapat dibaca mesin untuk `status` saat ini.
        decision_reason_label:
          type: string
          nullable: true
          description: Label yang mudah dibaca manusia untuk `decision_reason_code`.
        vendor_data:
          type: string
          nullable: true
          description: Salinan praktis dari `vendor_data` pemohon.
        metadata:
          type: object
          description: >-
            Cuplikan dari payload `subject` dan `counterparty` seperti yang
            dikirimkan pada waktu pembuatan.
        props:
          type: object
          description: >-
            `custom_properties` yang Anda berikan saat pembuatan. Setiap kunci
            dapat direferensikan dalam kondisi aturan sebagai
            `custom_values.<key>`.
        tags:
          type: array
          items:
            type: object
            properties:
              uuid:
                type: string
                format: uuid
              name:
                type: string
              color:
                type: string
              description:
                type: string
                nullable: true
              source:
                type: string
                enum:
                  - didit
                  - custom
                description: Apakah tag tersebut merupakan preset Didit atau tag kustom.
          description: >-
            Tag yang dilampirkan ke transaksi (secara manual atau berdasarkan
            aturan).
        parties:
          type: array
          items:
            type: object
            properties:
              uuid:
                type: string
                format: uuid
              role:
                type: string
                enum:
                  - APPLICANT
                  - REMITTER
                  - BENEFICIARY
                  - COUNTERPARTY
                description: >-
                  Peran pihak. Endpoint pembuatan menetapkan `APPLICANT`
                  (subjek) dan `COUNTERPARTY`.
              entity_type:
                type: string
                enum:
                  - individual
                  - company
                  - external
                  - unhostedWallet
              kind:
                type: string
                enum:
                  - USER
                  - BUSINESS
                  - EXTERNAL
                description: >-
                  Pihak `USER`/`BUSINESS` menautkan kembali ke entitas milik
                  Didit melalui `vendor_data`. Pihak `EXTERNAL` tidak memiliki
                  entitas Didit di belakangnya.
              vendor_data:
                type: string
                nullable: true
                description: Pengenal pengguna/bisnis internal Anda.
              full_name:
                type: string
                nullable: true
              first_name:
                type: string
                nullable: true
              last_name:
                type: string
                nullable: true
              country_code:
                type: string
                nullable: true
                description: >-
                  Kode negara dari `address.country` yang dikirimkan (biasanya
                  ISO 3166-1 alpha-3).
              dob:
                type: string
                format: date
                nullable: true
                description: Tanggal lahir dari `date_of_birth` yang dikirimkan.
              address:
                type: object
                description: >-
                  Objek alamat seperti yang dikirimkan. `{}` jika tidak
                  disertakan.
              institution_info:
                type: object
                description: >-
                  Detail institusi sebagaimana dikirimkan. `{}` jika
                  dihilangkan.
              device:
                type: object
                description: >-
                  Konteks perangkat yang dinormalisasi, termasuk pengayaan IP
                  sisi server di bawah network_context (geolokasi, tanda
                  VPN/pusat data) saat IP diberikan.
                properties:
                  fingerprint:
                    type: string
                    description: Sidik jari perangkat yang unik.
                  persistent_device_id:
                    type: string
                    description: >-
                      Pengidentifikasi perangkat lintas-sesi yang stabil (skema
                      fingerprint v2).
                  user_agent:
                    type: string
                    description: String user agent browser atau aplikasi.
                  browser_family:
                    type: string
                    description: Famili browser (misalnya Chrome, Firefox, Safari).
                  browser_version:
                    type: string
                    description: String versi browser.
                  platform:
                    type: string
                    description: >-
                      Pengenal platform (web, ios, android, macos, windows,
                      linux).
                  os_family:
                    type: string
                    description: Keluarga sistem operasi (misalnya iOS, Android, Windows).
                  os_version:
                    type: string
                    description: String versi sistem operasi.
                  accept_language:
                    type: string
                    description: Nilai header Accept-Language.
                  session_id:
                    type: string
                    description: Pengenal sesi (disimpan dalam metadata).
                  session_age_ms:
                    type: number
                    description: Usia sesi dalam milidetik.
                  network_context:
                    type: object
                    description: Konteks jaringan dengan alamat IP dan geolokasi.
                    properties:
                      ip_address:
                        type: string
                        description: Alamat IP klien.
                      ip_country_code:
                        type: string
                        description: >-
                          Negara dari IP yang ditentukan secara geografis (ISO
                          3166-1 alpha-3).
                      latitude:
                        type: number
                        description: Garis lintang geografis IP.
                      longitude:
                        type: number
                        description: Garis bujur geografis IP.
              external_party_snapshot:
                type: object
                nullable: true
                description: >-
                  Salinan beku dari data pihak untuk pihak `EXTERNAL`. Bernilai
                  `null` selama pihak tersebut ditautkan ke pengguna atau bisnis
                  Didit.
          description: Pihak transaksi (pemohon, pihak lawan).
        payment_methods:
          type: array
          items:
            type: object
            properties:
              uuid:
                type: string
                format: uuid
              payment_method_type:
                type: string
                enum:
                  - bank_card
                  - bank_account
                  - e_wallet
                  - crypto_wallet
                  - unhosted_wallet
                  - other
              label:
                type: string
                nullable: true
              fingerprint:
                type: string
                nullable: true
                description: >-
                  SHA-256 atas `type:account_id:issuing_country` —
                  pengidentifikasi stabil untuk menghubungkan penggunaan kembali
                  instrumen yang sama.
              account_id:
                type: string
                nullable: true
                description: Pengidentifikasi akun (IBAN, alamat dompet, token kartu, …).
              issuing_country:
                type: string
                nullable: true
              owner_kind:
                type: string
                enum:
                  - USER
                  - BUSINESS
                  - EXTERNAL
              vendor_data:
                type: string
                nullable: true
                description: Pengidentifikasi Anda untuk pengguna/bisnis pemilik.
              owner_name:
                type: string
                nullable: true
              institution_info:
                type: object
              details:
                type: object
                description: Objek `payment_method` mentah sebagaimana dikirimkan.
              external_owner_snapshot:
                type: object
                nullable: true
              role:
                type: string
                enum:
                  - SOURCE
                  - DESTINATION
                  - FUNDING
                  - BENEFICIARY
                description: >-
                  Bagaimana metode ini digunakan dalam transaksi. Endpoint
                  pembuatan menetapkan `SOURCE`/`DESTINATION` dari arah (keluar:
                  subjek = SOURCE; masuk: subjek = DESTINATION).
          description: Metode pembayaran yang ditautkan ke transaksi.
        documents:
          type: array
          description: File yang dilampirkan ke transaksi dari konsol. `[]` jika tidak ada.
          items:
            type: object
            properties:
              uuid:
                type: string
                format: uuid
              label:
                type: string
                nullable: true
              note:
                type: string
                nullable: true
              uploaded_by:
                type: string
                nullable: true
              created_at:
                type: string
                format: date-time
              files:
                type: array
                items:
                  type: object
                  properties:
                    uuid:
                      type: string
                      format: uuid
                    file_url:
                      type: string
                      format: uri
                      nullable: true
                      description: >-
                        URL unduhan bertanda tangan berdurasi singkat; ambil
                        saat dibutuhkan alih-alih menyimpannya.
                    original_filename:
                      type: string
                      nullable: true
                    file_size:
                      type: integer
                      nullable: true
        activities:
          type: array
          items:
            type: object
            properties:
              uuid:
                type: string
                format: uuid
              activity_type:
                type: string
                description: >-
                  Contoh: `TRANSACTION_CREATED`, `TRANSACTION_NOTE_ADDED`,
                  `TRANSACTION_STATUS_CHANGED`.
              source:
                type: string
              status:
                type: string
                nullable: true
              title:
                type: string
                nullable: true
              description:
                type: string
                nullable: true
              metadata:
                type: object
              occurred_at:
                type: string
                format: date-time
          description: >-
            Entri log aktivitas (pembuatan, catatan, peninjauan manual,
            perubahan status).
        alerts:
          type: array
          items:
            type: object
            properties:
              uuid:
                type: string
                format: uuid
              title:
                type: string
              description:
                type: string
                nullable: true
              severity:
                type: string
                enum:
                  - UNKNOWN
                  - LOW
                  - MEDIUM
                  - HIGH
                  - CRITICAL
              status:
                type: string
                enum:
                  - OPEN
                  - INVESTIGATING
                  - AWAITING_USER
                  - PENDING_SAR
                  - SAR_FILED
                  - RESOLVED
                  - DISMISSED
              source:
                type: string
                enum:
                  - RULE
                  - PROVIDER
                  - MANUAL
              metadata:
                type: object
              created_at:
                type: string
                format: date-time
              due_at:
                type: string
                format: date-time
                nullable: true
          description: >-
            Selalu kosong saat ini. Alert terbuka adalah transaksi dengan status
            `IN_REVIEW` atau `AWAITING_USER`.
        rule_runs:
          type: array
          items:
            type: object
            properties:
              uuid:
                type: string
                format: uuid
              rule:
                type: string
                format: uuid
                description: UUID aturan yang dijalankan.
              rule_title:
                type: string
              rule_description:
                type: string
                nullable: true
              rule_category:
                type: string
              matched:
                type: boolean
                description: >-
                  Apakah kondisi aturan cocok dengan transaksi ini. Eksekusi
                  hanya dicatat untuk aturan yang cocok, sehingga evaluasi live
                  selalu bernilai `true`.
              is_test:
                type: boolean
                description: >-
                  True saat aturan berjalan dalam mode TEST (tidak berpengaruh
                  pada status/skor).
              mode:
                type: string
                enum:
                  - ACTIVE
                  - DISABLED
                  - TEST
              severity:
                type: string
                nullable: true
              score_delta:
                type: integer
                description: Skor yang ditambahkan oleh tindakan `add_score` aturan ini.
              status_target:
                type: string
                nullable: true
                description: >-
                  Status yang ditetapkan oleh tindakan `change_status`, jika
                  ada.
              action_summary:
                type: string
                nullable: true
                description: >-
                  Ringkasan tindakan yang dijalankan aturan, digabungkan dengan
                  `; ` (misalnya `score +30; change_status:IN_REVIEW;
                  add_tag:high_risk_country`). Bagian-bagian: `score +N`,
                  `change_status:<STATUS>`, `add_tag:<name>`, `add_note`,
                  `add_to_list`, `open_case`. `null` jika aturan tidak
                  menjalankan tindakan apa pun.
              metadata:
                type: object
                description: >-
                  Detail evaluasi: `scope_match`, `conditions[]`, dan
                  `aggregations[]`. Setiap entri kondisi memuat `field`,
                  `operator`, `expected_value`, `current_value` yang dibaca dari
                  transaksi, `matched`, `group_index`, dan `group_logic`. Setiap
                  entri agregasi (velocity / count / sum) memuat `metric`,
                  `field`, `operator`, `expected_value`, `computed_value` dari
                  hasil evaluasi agregat, `window`, `filters`, `matched`, dan
                  `sample_references`; agregasi asinkron yang ditangguhkan
                  memiliki `computed_value: null` dan `deferred: true`. Grup
                  kondisi bertingkat adalah satu entri `conditions[]` dengan
                  `operator` `any_of` atau `all_of`, `field` bernilai null, dan
                  hasil anggotanya berada di bawah `conditions` miliknya
                  sendiri.
              created_at:
                type: string
                format: date-time
          description: >-
            Hasil eksekusi per aturan — aturan mana yang terpicu, beserta
            dampaknya terhadap skor.
        provider_results:
          type: array
          items:
            type: object
            properties:
              uuid:
                type: string
                format: uuid
              provider:
                type: string
              result_type:
                type: string
                enum:
                  - FIAT_MONITORING
                  - WALLET_SCREENING
                  - TRANSACTION_SCREENING
                  - TRAVEL_RULE
                  - NETWORK_GRAPH
                  - CUSTOM
              status:
                type: string
              severity:
                type: string
                nullable: true
              score:
                type: integer
              summary:
                type: string
                nullable: true
              payload:
                type: object
                description: Payload respons penyedia mentah.
              created_at:
                type: string
                format: date-time
          description: Payload penyedia mentah (skrining AML, analitik blockchain, dll.).
        travel_rule:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/TransactionTravelRule'
          description: >-
            Transfer atau pemeriksaan Travel Rule. Diisi saat
            `travel_rule_details` dikirimkan, dan juga saat Travel Rule
            diaktifkan dan transaksi dibuat dengan `transaction_category:
            travelRule` (Didit menginisiasi pertukaran itu sendiri, bahkan tanpa
            `travel_rule_details`). `null` saat tidak ada transfer atau
            pemeriksaan. Pada transfer masuk, `originator_data` dan
            `beneficiary_data` pihak lawan tetap disamarkan (`data_masked:
            true`) hingga kepemilikan dompet dikonfirmasi.
        network_snapshot:
          type: object
          nullable: true
          description: >-
            Snapshot graf dari transaksi/pihak terkait yang digunakan oleh mesin
            aturan. Berupa `network_snapshot` yang dikirimkan bersama transaksi
            atau graf yang dibangun Didit dari skrining dompet AML yang berhasil
            (yang menggantikan graf yang dikirimkan). `null` jika keduanya tidak
            ada.
          properties:
            uuid:
              type: string
              format: uuid
            nodes:
              type: array
              items:
                type: object
            edges:
              type: array
              items:
                type: object
            metrics:
              type: object
        remediation:
          type: object
          nullable: true
          description: >-
            Sesi remediasi yang ditawarkan kepada pengguna ketika verifikasi
            ulang diperlukan. Digantikan oleh `action_required`, yang merupakan
            blok kanonikal; dipertahankan untuk kompatibilitas mundur.
          properties:
            session_id:
              type: string
            session_token:
              type: string
            url:
              type: string
              format: uri
            status:
              type: string
        action_required:
          type: object
          nullable: true
          description: >-
            Tindakan pengguna akhir yang tertunda yang diperlukan untuk
            menyelesaikan transaksi ini, atau null jika tidak ada. SDK Didit
            meluncurkan tindakan secara otomatis secara default dan menyegarkan
            transaksi saat selesai. Dua varian, dibedakan berdasarkan `type`:
            `verification_session` (sesi verifikasi yang di-hosting yang dibuat
            oleh tindakan aturan) dan `wallet_ownership` (sesi widget
            kepemilikan dompet yang dibuat secara otomatis untuk transfer Travel
            Rule yang memerlukan bukti kendali dompet, diatur oleh pengaturan
            Travel Rule `auto_wallet_verification`). Ketika keduanya berlaku,
            `wallet_ownership` diprioritaskan karena memblokir pertukaran Travel
            Rule.
          oneOf:
            - $ref: '#/components/schemas/TransactionVerificationSessionAction'
            - $ref: '#/components/schemas/TransactionWalletOwnershipAction'
          discriminator:
            propertyName: type
            mapping:
              verification_session: '#/components/schemas/TransactionVerificationSessionAction'
              wallet_ownership: '#/components/schemas/TransactionWalletOwnershipAction'
        cost_breakdown:
          type: object
          nullable: true
          description: >-
            Biaya transaksi ini: `total_price` dan `items`, satu untuk setiap
            biaya, masing-masing dengan `usage_type`, `price`, `details`, dan
            `created_at`. Skrining ulang transaksi yang sama merupakan item
            baru.
    TransactionTravelRule:
      type: object
      description: >-
        Transfer Travel Rule dari transaksi, sebagaimana dikembalikan oleh `GET
        /v3/transactions/{transaction_id}/`, `201` dari `POST
        /v3/transactions/`, dan setiap baris dari `GET /v3/transactions/`.
        `direction`, `rail`, `counterparty_vasp`, `delivery`, `discovery`,
        `reason`, dan `next_actions` memiliki struktur yang sama seperti pada
        `PATCH /v3/transactions/{transaction_id}/travel-rule/`, sehingga satu
        kali pembacaan transaksi dapat menjelaskan alasan transfer tertahan dan
        tindakan apa yang dapat melanjutkannya.
      properties:
        uuid:
          type: string
          format: uuid
        status:
          type: string
        protocol:
          type: string
          nullable: true
        required:
          type: boolean
        obligations_count:
          type: integer
        originator_data:
          type: object
          description: >-
            Pihak pengirim. Untuk transfer masuk, nilai pihak lawan disamarkan
            sampai kepemilikan dikonfirmasi.
        beneficiary_data:
          type: object
          description: >-
            Pihak penerima. Untuk transfer masuk, nilai pihak lawan disamarkan
            hingga kepemilikan dikonfirmasi.
        name_match:
          type: object
          nullable: true
          description: >-
            Perbandingan nama yang menentukan transfer (skor dan tingkat
            ketatnya). Null hingga perbandingan dijalankan. Nama-nama yang
            dibandingkan disamarkan bersama dengan para pihak.
        data_match:
          $ref: '#/components/schemas/TravelRuleDataMatch'
        mismatched_fields:
          type: array
          items:
            type: string
          description: >-
            Pintasan untuk `data_match.mismatched_fields`. Kosong jika tidak ada
            perbedaan.
        data_unmasked:
          $ref: '#/components/schemas/TravelRuleDataUnmasked'
        data_masked:
          type: boolean
          description: True selama data pribadi pihak lawan disamarkan dalam respons ini.
        metadata:
          type: object
        direction:
          type: string
          enum:
            - INBOUND
            - OUTBOUND
          description: Sisi pertukaran mana transfer ini berada.
        rail:
          type: string
          nullable: true
          description: >-
            Jalur yang dilalui transfer: `INTERNAL`, `TRP`, `GTR`, `TRUST`,
            `VERIFYVASP`, `SYGNA`, atau `EMAIL` (`TEST_VASP` pada aplikasi
            sandbox, saat Test VASP Didit merespons), atau `null` hingga sebuah
            jalur dipilih.
        counterparty_vasp:
          type: object
          nullable: true
          properties:
            name:
              type: string
            lei:
              type: string
            dd_score:
              type: integer
              description: >-
                Skor uji tuntas dari 0 hingga 100, dengan nilai lebih tinggi
                lebih baik. Skala yang sama seperti dalam direktori VASP.
            dd_score_breakdown:
              type: object
              description: >-
                Kontribusi per komponen ke dd_score, satu objek per komponen
                seperti di direktori VASP (jurisdiction, verification, protocol,
                lei, history, essentials, responsiveness), masing-masing
                {points, max, reason, detail}. {} sampai pihak lawan telah
                dinilai.
              additionalProperties:
                type: object
                properties:
                  points:
                    type: number
                    description: Poin yang diberikan untuk komponen ini.
                  max:
                    type: integer
                    description: Poin maksimum yang dapat diberikan komponen ini.
                  reason:
                    type: string
                    description: Kode yang dapat dibaca mesin untuk keputusan komponen.
                  detail:
                    type: string
                    description: Alasan yang dapat dibaca manusia atas poin yang diberikan.
            dd_assessed_at:
              type: string
              format: date-time
              nullable: true
              description: >-
                Waktu ketika penilaian uji tuntas terakhir kali dijalankan. Null
                hingga pihak lawan telah dinilai.
          description: >-
            Entri direktori pihak lawan, atau `null` jika transfer tidak
            menautkan apa pun.
        delivery:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/TravelRuleDelivery'
          description: >-
            Pesan terbaru yang menjadi kewajiban transfer kepada pihak lain.
            `null` jika tidak ada kewajiban, misalnya di bawah
            `threshold_amount` atau untuk dompet swakelola yang dideklarasikan.
        discovery:
          type: array
          description: >-
            Cara Didit mencari pihak lawan, satu entri per langkah yang
            dijalankan. Kosong jika tidak ada penemuan yang dijalankan, misalnya
            pada transfer masuk.
          items:
            $ref: '#/components/schemas/TravelRuleDiscoveryStep'
        reason:
          type: string
          description: >-
            Alasan transfer `COUNTERPARTY_VASP_NOT_FOUND` atau
            `COUNTERPARTY_VASP_NOT_REACHABLE` tertahan; `""` untuk status
            lainnya. Pengiriman yang gagal menentukannya terlebih dahulu, hanya
            pada `COUNTERPARTY_VASP_NOT_REACHABLE`: `email_undeliverable`
            (penyedia email menolak email kepatuhan dan tidak ada alamat tersisa
            untuk dicoba: saat dikirim, pada pengingat, atau sebagai pantulan
            permanen yang dilaporkan kemudian) atau `delivery_failed` (jalur
            pengiriman gagal total: jalur jaringan menolak pesan atau kehabisan
            percobaan coba lagi, host identitas `TRP` tidak menjawab, atau host
            `TRP` pihak lawan tidak menerima permintaan informasi). Jika tidak,
            jejak `discovery` yang menentukannya: `awaiting_end_user` (tidak ada
            langkah yang menyebutkan pihak lawan yang dapat dijangkau Didit),
            `directory_match_no_route` (suatu langkah menyebutkan VASP direktori
            yang tidak memiliki rute), `picked_member_without_proven_wallet`
            (pengguna akhir memilih pelanggan Didit yang belum membuktikan
            kendali atas dompet), atau `no_directory_match` saat jejak tidak
            memberikan alasan lain. Pengiriman ulang akan memajukan transfer,
            sehingga alasannya dihapus. Lihat [Mengapa transfer
            tertahan](/id/transaction-monitoring/travel-rule#mengapa-transfer-macet).
        next_actions:
          type: array
          description: >-
            Apa yang melanjutkan transfer; `[]` untuk status apa pun selain
            `COUNTERPARTY_VASP_NOT_FOUND` atau
            `COUNTERPARTY_VASP_NOT_REACHABLE`. `email_undeliverable` menawarkan
            `update_compliance_email`, lalu `resend`. `delivery_failed`
            menawarkan `resend`. Alasan penemuan menawarkan
            `select_counterparty_vasp`, `declare_self_hosted`, `add_vasp_hint`,
            dan `resend`.
          items:
            $ref: '#/components/schemas/TravelRuleNextAction'
        chain_details:
          $ref: '#/components/schemas/TravelRuleChainDetails'
    TransactionVerificationSessionAction:
      title: Verification session
      type: object
      properties:
        type:
          type: string
          enum:
            - verification_session
        url:
          type: string
          format: uri
          description: URL verifikasi yang di-hosting untuk dibuka bagi pengguna akhir.
        session_id:
          type: string
          format: uuid
          description: ID sesi verifikasi.
        session_token:
          type: string
          description: >-
            Token sesi, digunakan oleh SDK seluler untuk meluncurkan alur secara
            native.
        status:
          type: string
          description: Status sesi verifikasi.
      required:
        - type
        - url
    TransactionWalletOwnershipAction:
      title: Wallet ownership
      type: object
      properties:
        type:
          type: string
          enum:
            - wallet_ownership
        url:
          type: string
          format: uri
          description: >-
            URL widget kepemilikan dompet yang di-hosting. Buka di lingkungan
            browser nyata - di ponsel gunakan SFSafariViewController atau Chrome
            Custom Tab, jangan pernah gunakan webview tersemat.
        widget_session_id:
          type: string
          format: uuid
          description: ID sesi widget kepemilikan dompet.
        expires_at:
          type: string
          format: date-time
          description: Kapan sesi widget kedaluwarsa.
      required:
        - type
        - url
    TravelRuleDataMatch:
      type: object
      nullable: true
      description: >-
        Perbandingan kolom demi kolom antara data pihak transfer dan apa yang
        diketahui pihak lain tentang pemegang dompet. Ini menyebutkan kolom dan
        hasil, tidak pernah nilai, sehingga tetap dapat dibaca sementara data
        pihak lawan disamarkan. Bernilai null sampai perbandingan dijalankan.
      properties:
        matched:
          type: boolean
          description: True saat tidak ada kolom yang dibandingkan yang berbeda.
        mismatched_fields:
          type: array
          items:
            type: string
            enum:
              - name
              - date_of_birth
              - address
              - account
          description: Kolom yang berbeda.
        fields:
          type: object
          description: >-
            Satu entri per kolom yang dibandingkan untuk tipe entitas pihak
            tersebut (`name`, `date_of_birth`, `address`, `account`; perusahaan
            tidak memiliki `date_of_birth`).
          additionalProperties:
            type: object
            properties:
              result:
                type: string
                enum:
                  - matched
                  - mismatched
                  - not_compared
                description: >-
                  `not_compared` saat aturan bernilai `NONE` atau salah satu
                  pihak tidak memiliki nilai untuk kolom tersebut.
              strictness:
                type: string
                enum:
                  - NONE
                  - STRICT
                  - CONTAINS
                  - DEFAULT
                  - FUZZY
    TravelRuleDataUnmasked:
      type: object
      nullable: true
      description: >-
        Catatan audit saat data pihak lawan dibuka penyamarannya. Bernilai null
        selama data masih disamarkan, dan untuk transfer keluar.
      properties:
        at:
          type: string
          format: date-time
        reason:
          type: string
          enum:
            - ownership_confirmed
            - wallet_proof
            - address_book_match
            - own_verified_wallet
            - inquiry_approved
            - known_payment_method
            - travel_address
          description: >-
            Hal yang mengonfirmasi kepemilikan: ownership_confirmed (konfirmasi
            Anda melalui konsol atau API), wallet_proof (bukti dompet di widget,
            atau transfer masuk INTERNAL, ditetapkan saat dibuat),
            address_book_match (dompet di buku alamat yang terverifikasi),
            own_verified_wallet (dompet terverifikasi milik pengguna Anda
            sendiri), inquiry_approved (persetujuan Anda atas permintaan masuk
            TRP atau pesan GTR atau Sygna), known_payment_method (dompet yang
            sudah digunakan pengguna Anda untuk membayar) atau travel_address
            (Travel Address per dompet mencantumkan dompet tersebut).
        actor:
          type: string
          description: >-
            Pihak yang mengonfirmasinya: email pengguna konsol atau label kunci
            API. Kosong untuk keputusan otomatis.
    TravelRuleDelivery:
      type: object
      description: >-
        Status pesan terbaru yang harus dikirimkan transfer ke pihak lain. Didit
        menghubungi pihak lawan setelah permintaan yang membuat atau mengubah
        transfer dikembalikan, sehingga objek ini menunjukkan apakah pesan
        tersebut berhasil terkirim: queued, being sent, waiting to be retried
        after an error, delivered, atau failed. Kegagalan yang masih dapat
        dipulihkan oleh jaringan (tidak ada jawaban tepat waktu, koneksi gagal,
        HTTP `408`, `429`, atau `5xx`) akan dicoba lagi setelah 30 detik, 2
        menit, 10 menit, 30 menit, dan 1 jam. Saat pesan pertama (`kind: SEND`)
        gagal permanen, baik karena jaringan menolaknya atau percobaan keenam
        juga gagal, transfer berpindah ke `COUNTERPARTY_VASP_NOT_REACHABLE`
        dengan `last_error` di `timeline`-nya; pesan lain yang gagal permanen
        akan dicatat di `timeline`. `status` transfer tetap menjadi sumber
        kebenaran tunggal untuk pertukaran itu sendiri.
      required:
        - kind
        - status
        - rail
        - attempts
        - last_error
        - next_attempt_at
        - delivered_at
      properties:
        kind:
          type: string
          enum:
            - SEND
            - ANSWER
            - TXID
            - CANCEL
            - POLL
          description: >-
            Apa yang dibawa pesan. `SEND`: pesan pertama transfer ke pihak lawan
            (keluar; jalur pembayaran dipilih saat dikirim). `ANSWER`:
            persetujuan atau penolakan Anda, yang harus diberikan ke jaringan
            yang meminta (masuk). `TXID`: hash transaksi on-chain, setelah Anda
            menyelesaikan transfer. `CANCEL`: pembatalan, setelah Anda
            membatalkannya. `POLL`: kueri status ke jaringan yang menawarkannya,
            diulang setiap 5 menit saat transfer menunggu pihak lawan.
        status:
          type: string
          enum:
            - QUEUED
            - SENDING
            - RETRYING
            - DELIVERED
            - FAILED
          description: >-
            `QUEUED`: menunggu untuk dikirim. `SENDING`: percobaan sedang
            berjalan. `RETRYING`: percobaan gagal dan percobaan berikutnya
            berjalan pada `next_attempt_at`. `DELIVERED`: pihak lain menerima
            pesan. `FAILED`: pihak lain menolaknya, atau percobaan terakhir
            gagal.
        rail:
          type: string
          enum:
            - INTERNAL
            - TRP
            - GTR
            - TRUST
            - VERIFYVASP
            - SYGNA
            - EMAIL
            - ''
          description: >-
            Jalur yang membawa pesan. Kosong hingga Didit memilih salah satu
            untuk pesan pertama.
        attempts:
          type: integer
          minimum: 0
          description: >-
            Percobaan yang dilakukan sejauh ini untuk pesan ini. Pesan yang
            bukan polling status dicoba paling banyak 6 kali.
        last_error:
          type: string
          description: >-
            Jenis kegagalan yang dialami pada upaya terakhir, `""` jika tidak
            ada: misalnya `email undeliverable`, `trp identity endpoint
            unreachable`, atau `trp transfer inquiry delivery failed`. Kolom ini
            tidak pernah membawa jawaban pihak lawan itu sendiri, yang tetap
            berada di `timeline` transfer.

            Ketika GTR merespons dengan kesalahan, kode status dan pesannya
            sendiri disertakan. Isi respons tidak pernah disertakan.
          example: email undeliverable
        next_attempt_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Waktu upaya berikutnya dijalankan saat pesan berstatus `QUEUED` atau
            `RETRYING`.
        delivered_at:
          type: string
          format: date-time
          nullable: true
          description: Waktu pihak lain menerima pesan.
    TravelRuleDiscoveryStep:
      type: object
      description: >-
        Satu langkah penemuan pihak lawan yang dijalankan Didit untuk transfer
        keluar, sesuai urutan eksekusinya. Langkah pertama yang menyebutkan VASP
        dengan rute akan mengakhiri rantai tersebut.
      properties:
        step:
          type: string
          enum:
            - internal_address_book
            - wallet_attribution
            - network_lookup
            - customer_hint
            - end_user
          description: >-
            `internal_address_book`: pelanggan Didit lain yang membuktikan
            kontrol atas dompet tujuan. `wallet_attribution`: atribusi analitik
            blockchain dompet tersebut. `network_lookup`: jaringan yang dapat
            menyatakan VASP mana yang memegang alamat tersebut. `customer_hint`:
            nama VASP, LEI, atau yurisdiksi yang Anda kirimkan di
            `beneficiary_data`. `end_user`: pihak lawan yang dipilih oleh
            pengguna akhir (atau Anda), atau permintaan untuk memilih salah
            satunya.
        outcome:
          type: string
          enum:
            - match
            - miss
            - skipped
          description: >-
            `match`: langkah tersebut menyebutkan pihak lawan. `miss`: langkah
            berjalan dan tidak menemukan apa pun. `skipped`: langkah tidak dapat
            berjalan, dan `reason` menjelaskan alasannya.
        reason:
          type: string
          description: >-
            Alasan yang dapat dibaca mesin, `""` pada kecocokan:
            `no_proven_internal_wallet`, `attribution_disabled`,
            `already_attributed`, `no_attributed_entity`,
            `directory_match_no_route`, `gtr_address_lookup_runs_on_dispatch`,
            `no_membership`, `network_switched_off`,
            `no_network_address_lookup`, `no_directory_match`,
            `awaiting_end_user` atau `picked_member_without_proven_wallet`.
        vasp:
          type: string
          format: uuid
          nullable: true
          description: VASP direktori yang disebutkan oleh langkah tersebut, jika ada.
        rail:
          type: string
          nullable: true
          description: >-
            Jalur yang menjangkau pihak lawan tersebut, ketika langkah
            menemukannya.
        at:
          type: string
          format: date-time
    TravelRuleNextAction:
      type: object
      description: >-
        Satu hal yang melanjutkan transfer `COUNTERPARTY_VASP_NOT_FOUND` atau
        `COUNTERPARTY_VASP_NOT_REACHABLE`. Lihat [Mengapa transfer
        terhenti](/id/transaction-monitoring/travel-rule#mengapa-transfer-macet).
      properties:
        action:
          type: string
          enum:
            - select_counterparty_vasp
            - declare_self_hosted
            - add_vasp_hint
            - update_compliance_email
            - resend
          description: >-
            `select_counterparty_vasp`: pengguna akhir memilih VASP tujuan di
            widget kepemilikan dompet, atau Anda melakukan PATCH
            `action=beneficiary_vasp`. `declare_self_hosted`: pengguna akhir
            menyatakan dompet tersebut swakelola di dalam widget.
            `add_vasp_hint`: beri tahu Didit siapa pihak lawannya, dengan nama
            VASP, LEI, atau Travel Address (misalnya `travel_address` pada entri
            buku alamat dompet tujuan), lalu kirim ulang.
            `update_compliance_email` dan `resend` adalah nilai `action` dari
            `PATCH /v3/transactions/{transaction_id}/travel-rule/`: berikan
            kembali email kepatuhan pihak lawan, dan jalankan perutean ulang.
        url:
          type: string
          format: uri
          description: >-
            Tautan widget kepemilikan dompet, pada `select_counterparty_vasp`
            dan `declare_self_hosted` saat transfer memiliki sesi widget yang
            terbuka.
      required:
        - action
    TravelRuleChainDetails:
      type: object
      description: >-
        Bagaimana rantai transfer menamai kedua dompetnya, ketika melibatkan
        lebih dari satu alamat yang membayar satu sama lain. Kosong (`{}`) untuk
        transfer rantai akun (EVM, Solana, Tron), di mana kedua alamat tersebut
        adalah dompetnya. Pencocokan, perutean, dan buku alamat membaca dompet
        dari sini terlebih dahulu.
      properties:
        chain:
          type: string
          description: >-
            Blockchain kanonis, misalnya `BTC`, `XRP`, atau `LIGHTNING` untuk
            transfer Lightning.
        shape:
          type: string
          enum:
            - utxo
            - memo
            - lightning
        originator:
          $ref: '#/components/schemas/TravelRuleChainSide'
        beneficiary:
          $ref: '#/components/schemas/TravelRuleChainSide'
        utxo:
          type: object
          description: >-
            Pada transfer UTXO: input dan output sebagaimana disimpan (jumlah
            dalam bentuk string desimal) dan output mana yang dibaca Didit
            sebagai apa.
          properties:
            inputs:
              type: array
              items:
                $ref: '#/components/schemas/TravelRuleUtxoEntry'
            outputs:
              type: array
              items:
                $ref: '#/components/schemas/TravelRuleUtxoEntry'
            change_output_indexes:
              type: array
              items:
                type: integer
              description: Output yang membayar kembali alamat input.
            beneficiary_output_index:
              type: integer
              nullable: true
              description: >-
                Output yang membayar penerima; null jika tidak ada yang dapat
                dibedakan.
        lightning:
          type: object
          description: >-
            Pada transfer Lightning: apa yang tertera pada permintaan
            pembayaran. Selalu berupa `kind` (`bolt11`, `bolt12_offer`,
            `bolt12_invoice`, `bolt12_invoice_request`, `lnurl`,
            `lightning_address`, `node_id`, atau `unknown`); faktur BOLT11
            menambahkan `network`, `payee_node_id`, `payment_hash`,
            `amount_msat`, `created_at`, dan `expires_at`; string BOLT12
            menambahkan `blinded_paths` dan `payee_node_id`; LNURL atau
            Lightning Address menambahkan `domain`-nya. Tidak ada yang
            di-resolve melalui jaringan: permintaan hanya didekode.
          additionalProperties: true
        warnings:
          type: array
          items:
            type: string
            enum:
              - declared_originator_not_an_input
              - declared_beneficiary_not_an_output
              - beneficiary_output_ambiguous
              - beneficiary_output_amount_differs
          description: >-
            Inkonsistensi UTXO yang perlu diperiksa: pengirim yang
            dideklarasikan bukan merupakan input, penerima yang dideklarasikan
            bukan merupakan output, tidak ada satu pun output penerima yang
            dapat dibedakan, atau output penerima membayar jumlah yang berbeda
            dari yang tertera pada transaksi.
        not_applicable_reason:
          type: string
          enum:
            - LIGHTNING_NO_PAYEE_IDENTIFIER
            - LIGHTNING_BOLT12_BLINDED_PAYEE
            - LIGHTNING_LNURL_NAMES_NO_PAYEE
          description: >-
            Pada transfer Lightning keluar yang permintaan pembayarannya tidak
            menyebutkan penerima: alasan transfer berstatus `NOT_APPLICABLE`.
            `LIGHTNING_NO_PAYEE_IDENTIFIER` (permintaan tidak menyebutkan node
            penerima, atau tidak dapat didekode),
            `LIGHTNING_BOLT12_BLINDED_PAYEE` (penawaran menyembunyikan
            penerimanya di balik blinded path), `LIGHTNING_LNURL_NAMES_NO_PAYEE`
            (LNURL menyebutkan nama layanan, bukan penerima). Kode yang sama
            membuka entri `timeline` terakhir dari transfer.
    TravelRuleChainSide:
      type: object
      description: >-
        Dompet salah satu pihak sebagaimana Didit menyelesaikannya dari data
        chain.
      properties:
        address:
          type: string
          description: >-
            Dompet. Pada jaringan memo berupa alamat klasik (alamat X XRP
            dipisahkan menjadi alamat klasik dan tag-nya); pada Lightning berupa
            ID node penerima pembayaran atau Lightning Address.
        memo:
          type: string
          description: >-
            Destination tag atau memo yang merupakan bagian dari dompet; `""`
            jika tidak ada.
        source:
          type: string
          enum:
            - declared
            - x_address
            - largest_input
            - only_non_change_output
            - amount_match
            - invoice_payee
            - updated
          description: >-
            Asal dompet: `declared` (permintaan Anda), `x_address` (dipisahkan
            dari X-address XRP), `largest_input` (alamat input UTXO yang
            berkontribusi paling banyak), `only_non_change_output` (satu-satunya
            output UTXO yang bukan kembalian), `amount_match` (satu output UTXO
            yang membayar jumlah transfer), `invoice_payee` (penerima pembayaran
            yang disebutkan dalam permintaan pembayaran Lightning), `updated`
            (ditetapkan kemudian dengan `action: update_originator_wallet`).
    TravelRuleUtxoEntry:
      type: object
      description: >-
        Satu input atau output dari transaksi UTXO, sebagaimana dicatat oleh
        rantai blockchain.
      required:
        - address
      properties:
        address:
          type: string
          maxLength: 128
        amount:
          type: string
          nullable: true
          description: >-
            String desimal dalam unit koin itu sendiri (BTC, bukan satoshi).
            Opsional.
          example: '0.0125'
        txid:
          type: string
          maxLength: 128
          description: Opsional. Transaksi yang digunakan oleh input.
        vout:
          type: integer
          nullable: true
          minimum: 0
          description: Opsional. Indeks output yang digunakan oleh input.
  securitySchemes:
    TransactionTokenAuth:
      type: apiKey
      in: header
      name: X-Transaction-Token
      description: >-
        Token berdurasi singkat dengan cakupan terbatas yang dicetak oleh
        backend Anda melalui POST /v3/transactions/sdk-token/. Digunakan oleh
        SDK Didit pada endpoint /v1/transactions/ yang digunakan perangkat.

````

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