> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.
# API per obtenir transaccions: detall KYT
> Obtén una transacció KYT de Didit: parts, mètodes de pagament, alertes, regles, Travel Rule, enllaços de remediació i instantànies de xarxa.
Prompt de l'API per obtenir una transacció
Copia el prompt al porta-retalls
\
\`Fetch the full detail of a Didit monitored transaction through the Management API.
Endpoint:
GET https://verification.didit.me/v3/transactions/{transaction_id}/
Authentication:
Use the x-api-key header with my Didit API key.
Goal:
\- Retrieve every detail of a transaction — linked parties, payment methods, alerts, rule matches, travel-rule checks, remediation links, network snapshots, cost breakdown — so I can render a detail screen or feed a downstream decision.
Path parameter:
\- transaction_id - Didit's transaction uuid (the uuid returned by POST /v3/transactions/).
Your own txn_id is not accepted here and returns 404.
Example call:
curl -X GET "https://verification.didit.me/v3/transactions/{transaction_id}/" \
-H "x-api-key: YOUR_API_KEY"
What to read from the response:
\- uuid, transaction_number, txn_id — identifiers.
\- status, score, severity, decision_reason_code, decision_reason_label — current verdict.
\- direction, amount, currency, currency_type, action_type, payment_details, payment_txn_id - the submitted details as top-level fields (there is no transaction_details object, and currency_type carries the currency_kind you sent).
\- parties - party records with role APPLICANT (the subject) or COUNTERPARTY (the other side) and kind USER, BUSINESS or EXTERNAL, each with entity_type, vendor_data, full_name, address and device.
\- payment_methods - the linked payment methods, each with payment_method_type, account_id and role (for example SOURCE or DESTINATION).
\- cost_breakdown — provider-by-provider cost detail for this transaction.
\- rule_runs / alerts — which rules fired and their outcomes.
\- provider_results - crypto screening (blockchain analytics) results, when a screening ran.
\- travel_rule - the Travel Rule transfer (uuid, status, protocol, required, obligations_count, originator_data, beneficiary_data, metadata, direction, rail, counterparty_vasp, delivery, discovery, reason, next_actions), or null when the transaction has none.
For a COUNTERPARTY_VASP_NOT_FOUND or COUNTERPARTY_VASP_NOT_REACHABLE transfer, reason says why it is stuck and next_actions what moves it on: email_undeliverable offers update_compliance_email then resend, delivery_failed offers resend, and a discovery reason (awaiting_end_user, directory_match_no_route, picked_member_without_proven_wallet, no_directory_match) offers select_counterparty_vasp, declare_self_hosted, add_vasp_hint and resend.
delivery is the newest message the transfer owes the other side (kind, status, rail, attempts, last_error, next_attempt_at, delivered_at), or null; discovery is the trace of where Didit looked for the counterparty.
On an inbound transfer, the counterparty's originator_data and beneficiary_data stay masked (data_masked: true) until wallet ownership is confirmed.
\- tags — Console tags (uuid, name, color).
\- assigned_to_name (the Console reviewer) is not part of this response; the list endpoint GET /v3/transactions/ returns it.
Use cases:
\- Render the Console-equivalent "Transaction detail" screen in your back-office.
\- Reconcile rule outcomes against your own ledger.
\- Poll after a transaction.status.updated webhook to fetch the fresh verdict.
Failure modes:
\- 403 - missing x-api-key (a wrong, revoked or expired key gets 401), or a key without permission for this action ({ "detail": "..." } envelope).
\- 404 - transaction not found in this application, including a transaction that belongs to another application (or deleted via the Console).
\- 429 — rate limited; back off and retry.
Side effects: none. This is a pure read.
For the full integration shape, see /integration/integration-prompt.`
\
Enganxa a
## OpenAPI
````yaml ca/openapi-25.json GET /v3/transactions/{transaction_id}/
openapi: 3.0.0
info:
version: 3.0.0
title: Didit Verification API
description: API de verificació d'identitat. Autentica't amb la capçalera x-api-key.
servers:
- url: https://verification.didit.me
security: []
tags: []
paths:
/v3/transactions/{transaction_id}/:
get:
tags:
- Transactions
summary: Obtenir la transacció
description: >-
Recupera el registre complet de monitoratge per a una transacció: parts,
puntuació/gravetat, execucions de regles, alertes, resultat de Travel
Rule i sessió de correcció.
operationId: getTransaction
parameters:
- name: transaction_id
in: path
required: true
description: >-
UUID de transacció estable de Didit (el `uuid` retornat de create /
list, **no** el teu `txn_id`).
schema:
type: string
format: uuid
example: abcdef12-3456-7890-abcd-ef1234567890
responses:
'200':
description: Detall complet de la transacció.
content:
application/json:
schema:
$ref: '#/components/schemas/TransactionDetail'
examples:
In review with an alert:
value:
uuid: abcdef12-3456-4890-abcd-ef1234567890
environment: live
transaction_number: 4123
txn_id: your-txn-2026-05-17-001
txn_date: '2026-05-17T08:42:00Z'
zone_id: Europe/Madrid
transaction_type: finance
action_type: withdrawal
direction: OUTBOUND
status: IN_REVIEW
source: LIVE
amount: '1500'
currency: EUR
currency_type: fiat
amount_in_default_currency: '1620.45'
default_currency_code: USD
preferred_currency_amount: '1620.45'
preferred_currency_code: USD
payment_details: Withdrawal to crypto wallet
payment_txn_id: null
score: 78
severity: HIGH
decision_reason_code: WALLET_HIGH_RISK
decision_reason_label: Destination wallet flagged as high risk
vendor_data: user-12345
metadata:
subject:
entity_type: individual
vendor_data: user-12345
full_name: Maria Garcia
address: {}
institution_details: {}
device_context: {}
counterparty: {}
props:
order_id: ord-9988
tags: []
parties:
- uuid: b1111111-2222-4333-8444-555555555555
role: APPLICANT
entity_type: individual
kind: USER
vendor_data: user-12345
full_name: Maria Garcia
first_name: null
last_name: null
country_code: null
dob: null
address: {}
institution_info: {}
device: {}
external_party_snapshot: null
payment_methods: []
documents: []
activities: []
alerts:
- uuid: a7b8c9d0-1234-4abc-9def-567890abcdef
title: Destination wallet flagged as high risk
description: Provider risk score exceeded the configured threshold.
severity: HIGH
status: OPEN
source: RULE
metadata: {}
created_at: '2026-05-17T08:42:12Z'
due_at: null
rule_runs: []
provider_results: []
travel_rule: null
network_snapshot: null
remediation: null
action_required: null
cost_breakdown: null
'403':
description: >-
Clau d'API absent, no vàlida o revocada, o bé la clau no pot llegir
les transaccions d'aquesta aplicació. Una clau absent retorna `403`;
una clau incorrecta, revocada o caducada retorna `401`.
content:
application/json:
examples:
Forbidden:
value:
detail: You do not have permission to perform this action.
'404':
description: >-
No existeix cap transacció amb aquest UUID per a l'aplicació (s'ha
suprimit, no s'ha creat mai, pertany a una altra aplicació o el
segment de la ruta no és un UUID vàlid).
content:
application/json:
examples:
Not found:
value:
detail: Not found.
'429':
description: >-
S'ha superat el límit de freqüència; redueix el ritme de les
sol·licituds i reintenta-ho després de l'interval indicat a
`Retry-After`.
content:
application/json:
examples:
Throttled:
value:
detail: Request was throttled. Expected available in 30 seconds.
security:
- ApiKeyAuth: []
x-codeSamples:
- lang: curl
label: curl
source: >-
curl -X GET
'https://verification.didit.me/v3/transactions/abcdef12-3456-7890-abcd-ef1234567890/'
\
-H 'x-api-key: YOUR_API_KEY'
- lang: python
label: Python
source: |-
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.transactions.retrieve(
"abcdef12-3456-7890-abcd-ef1234567890",
)
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.transactions.retrieve("abcdef12-3456-7890-abcd-ef1234567890");
console.log(result);
- lang: go
label: Go
source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Transactions.Retrieve(ctx, \"abcdef12-3456-7890-abcd-ef1234567890\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
- lang: java
label: Java
source: >-
import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result =
client.transactions().retrieve("abcdef12-3456-7890-abcd-ef1234567890");
System.out.println(result);
- lang: php
label: PHP
source: >-
transactions->retrieve('abcdef12-3456-7890-abcd-ef1234567890');
print_r($result->toArray());
- lang: ruby
label: Ruby
source: >-
require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result =
didit.transactions.retrieve("abcdef12-3456-7890-abcd-ef1234567890")
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.Transactions.RetrieveAsync("abcdef12-3456-7890-abcd-ef1234567890");
Console.WriteLine(JsonSerializer.Serialize(result));
components:
schemas:
TransactionDetail:
type: object
description: >-
Registre complet de monitoratge per a una transacció, tal com el
retornen `GET /v3/transactions/{transaction_id}/` i `POST
/v3/transactions/`.
properties:
uuid:
type: string
format: uuid
description: >-
Identificador de transacció estable de Didit. Fes-lo servir com a
`{transaction_id}` per a les crides de seguiment.
environment:
type: string
enum:
- live
- sandbox
description: >-
Entorn de l'aplicació propietària de la transacció. Una transacció
`sandbox` s'emmagatzema però mai s'avalua, se sotmet a cribratge, es
notifica ni es factura, de manera que el seu `rule_runs` buit
significa "no avaluada".
transaction_number:
type: integer
description: >-
Número seqüencial de transacció en l'àmbit de l'aplicació que es
mostra a la consola (p. ex. `4123`).
txn_id:
type: string
description: >-
El `transaction_id` que has proporcionat en el moment de la creació
(màx. 128 caràcters). Únic per aplicació.
txn_date:
type: string
format: date-time
description: >-
Quan va tenir lloc la transacció (a partir de `transaction_at`; per
defecte pren l'hora d'enviament).
zone_id:
type: string
nullable: true
description: >-
Identificador de zona horària IANA proporcionat en el moment de la
creació.
transaction_type:
type: string
description: >-
Categoria de primer nivell tal com s'emmagatzema: `finance`, `kyc`,
`travelRule`, `userPlatformEvent`, `gamblingBet`,
`gamblingLimitChange`, `gamblingBonusChange`, `auditTrailEvent`.
Tingues en compte que els valors de diverses paraules es retornen en
camelCase fins i tot quan s'envien en snake_case.
action_type:
type: string
description: >-
Subtipus dins de la categoria (p. ex. `deposit`, `withdrawal`,
`transfer`). Per defecte pren la categoria quan no s'especifica.
direction:
type: string
enum:
- INBOUND
- OUTBOUND
description: >-
Direcció relativa al subjecte. S'emmagatzema en majúscules
independentment de les majúscules o minúscules enviades (s'accepten
`in`/`out`/`inbound`/`outbound` a l'entrada).
status:
type: string
enum:
- APPROVED
- IN_REVIEW
- DECLINED
- AWAITING_USER
description: >-
Veredicte de monitoratge actual. Les transaccions es creen com a
`APPROVED`; les regles poden canviar-les a `IN_REVIEW`/`DECLINED` de
manera sincrònica.
source:
type: string
enum:
- LIVE
- IMPORTED
description: >-
Com s'ha originat el registre: `LIVE` per a transaccions enviades a
través de l'API o l'SDK, `IMPORTED` per a transaccions carregades
mitjançant la importació des de la consola.
amount:
type: string
description: >-
Import de la transacció com a cadena decimal sense els zeros finals
(p. ex., `"1500"`, `"0.5"`, `"0.123456789012345678"`). Fins a 18
decimals.
currency:
type: string
description: >-
Codi de moneda de `amount`. S'accepta qualsevol codi alfabètic ISO
4217 (p. ex. `EUR`, `USD`, `NGN`), així com un símbol d'actiu cripto
(p. ex. `BTC`). És preferible utilitzar un codi actualment en
circulació. No tots els codis acceptats tenen tipus de canvi: quan
no n'hi ha cap de disponible per al codi (per exemple, la unitat de
compte ISO `XSU`, o un símbol cripto que Didit no cotitza), la
conversió automàtica falla i `preferred_currency_amount` es retorna
null tret que la sol·licitud hagi proporcionat un
`amount_in_default_currency` preconvertit.
currency_type:
type: string
nullable: true
description: '`fiat` o `crypto`, tal com s''ha indicat a `currency_kind`.'
amount_in_default_currency:
type: string
nullable: true
description: >-
Import preconvertit que has proporcionat, com a cadena decimal sense
zeros finals.
default_currency_code:
type: string
nullable: true
preferred_currency_amount:
type: string
nullable: true
description: >-
`amount` convertit a la moneda preferida de l'aplicació, quan
estigui disponible.
preferred_currency_code:
type: string
nullable: true
payment_details:
type: string
nullable: true
description: Referència de pagament o concepte de text lliure de l'enviament.
payment_txn_id:
type: string
nullable: true
description: >-
Referència del sistema de pagament extern (p. ex. hash de la
transacció a la blockchain) de `payment_reference_id`.
score:
type: integer
description: >-
Puntuació de risc acumulada per les regles (normalment 0–100). Com
més alta, més risc.
severity:
type: string
nullable: true
enum:
- UNKNOWN
- LOW
- MEDIUM
- HIGH
- CRITICAL
description: >-
Gravetat de risc categòrica establerta per regles/proveïdors
(`UNKNOWN`, `LOW`, `MEDIUM`, `HIGH`, `CRITICAL`). `null` fins que
algun element l'estableixi.
decision_reason_code:
type: string
nullable: true
description: Motiu llegible per màquina per a l'`status` actual.
decision_reason_label:
type: string
nullable: true
description: Etiqueta fàcil de llegir per a `decision_reason_code`.
vendor_data:
type: string
nullable: true
description: Còpia de conveniència del `vendor_data` del sol·licitant.
metadata:
type: object
description: >-
Instantània dels payloads de `subject` i `counterparty` tal com es
van enviar en el moment de la creació.
props:
type: object
description: >-
Les `custom_properties` que has proporcionat en crear. Cada clau es
pot referenciar en les condicions de les regles com a
`custom_values.`.
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: >-
Si l'etiqueta és un valor predefinit de Didit o una etiqueta
personalitzada.
description: Etiquetes adjuntades a la transacció (manualment o per regles).
parties:
type: array
items:
type: object
properties:
uuid:
type: string
format: uuid
role:
type: string
enum:
- APPLICANT
- REMITTER
- BENEFICIARY
- COUNTERPARTY
description: >-
Rol de la part. L'endpoint de creació assigna `APPLICANT` (el
subjecte) i `COUNTERPARTY`.
entity_type:
type: string
enum:
- individual
- company
- external
- unhostedWallet
kind:
type: string
enum:
- USER
- BUSINESS
- EXTERNAL
description: >-
Les parts `USER`/`BUSINESS` s'enllacen amb una entitat
propietat de Didit mitjançant `vendor_data`. Les parts
`EXTERNAL` no tenen cap entitat de Didit al darrere.
vendor_data:
type: string
nullable: true
description: El teu identificador intern d'usuari/empresa.
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: >-
Codi de país de l'`address.country` enviat (normalment ISO
3166-1 alpha-3).
dob:
type: string
format: date
nullable: true
description: Data de naixement a partir de la `date_of_birth` enviada.
address:
type: object
description: Objecte d'adreça tal com s'ha enviat. `{}` quan s'omet.
institution_info:
type: object
description: >-
Detalls de la institució tal com s'han enviat. `{}` si
s'ometen.
device:
type: object
description: >-
Context del dispositiu normalitzat, inclòs l'enriquiment d'IP
del costat del servidor sota network_context (geolocalització,
indicadors de VPN/centre de dades) quan s'ha proporcionat una
IP.
properties:
fingerprint:
type: string
description: Petjada digital única del dispositiu.
persistent_device_id:
type: string
description: >-
Identificador de dispositiu estable entre sessions
(esquema d'empremta digital v2).
user_agent:
type: string
description: Cadena de l'agent d'usuari del navegador o de l'aplicació.
browser_family:
type: string
description: Família del navegador (p. ex., Chrome, Firefox, Safari).
browser_version:
type: string
description: Cadena de la versió del navegador.
platform:
type: string
description: >-
Identificador de plataforma (web, ios, android, macos,
windows, linux).
os_family:
type: string
description: >-
Família del sistema operatiu (p. ex., iOS, Android,
Windows).
os_version:
type: string
description: Cadena de la versió del sistema operatiu.
accept_language:
type: string
description: Valor de la capçalera Accept-Language.
session_id:
type: string
description: Identificador de sessió (emmagatzemat a les metadades).
session_age_ms:
type: number
description: Antiguitat de la sessió en mil·lisegons.
network_context:
type: object
description: Context de xarxa amb adreça IP i geolocalització.
properties:
ip_address:
type: string
description: Adreça IP del client.
ip_country_code:
type: string
description: País geolocalitzat de la IP (ISO 3166-1 alfa-3).
latitude:
type: number
description: Latitud geogràfica de la IP.
longitude:
type: number
description: Longitud geogràfica de la IP.
external_party_snapshot:
type: object
nullable: true
description: >-
Còpia congelada de les dades de les parts de tipus `EXTERNAL`.
`null` mentre la part estigui vinculada a un usuari o una
empresa de Didit.
description: Parts de la transacció (sol·licitant, contrapart).
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 sobre `type:account_id:issuing_country`: identificador
estable per correlacionar la reutilització del mateix
instrument.
account_id:
type: string
nullable: true
description: >-
Identificador de compte (IBAN, adreça de cartera, token de
targeta, …).
issuing_country:
type: string
nullable: true
owner_kind:
type: string
enum:
- USER
- BUSINESS
- EXTERNAL
vendor_data:
type: string
nullable: true
description: El teu identificador per a l'usuari o l'empresa propietaris.
owner_name:
type: string
nullable: true
institution_info:
type: object
details:
type: object
description: Objecte `payment_method` en brut tal com s'ha enviat.
external_owner_snapshot:
type: object
nullable: true
role:
type: string
enum:
- SOURCE
- DESTINATION
- FUNDING
- BENEFICIARY
description: >-
Com es va utilitzar aquest mètode a la transacció. L'endpoint
de creació assigna `SOURCE`/`DESTINATION` a partir de la
direcció (sortint: subject = SOURCE; entrant: subject =
DESTINATION).
description: Mètodes de pagament vinculats a la transacció.
documents:
type: array
description: >-
Fitxers adjunts a la transacció des de la consola. `[]` quan no n'hi
ha cap.
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 de descàrrega signada de curta durada; obtén-la quan
sigui necessari en lloc d'emmagatzemar-la.
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: >-
P. ex. `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: >-
Entrades del registre d'activitat (creació, notes, revisions
manuals, canvis d'estat).
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: >-
Sempre buit actualment. Una alerta oberta és una transacció amb
estat `IN_REVIEW` o `AWAITING_USER`.
rule_runs:
type: array
items:
type: object
properties:
uuid:
type: string
format: uuid
rule:
type: string
format: uuid
description: UUID de la regla que s'ha executat.
rule_title:
type: string
rule_description:
type: string
nullable: true
rule_category:
type: string
matched:
type: boolean
description: >-
Si les condicions de la regla han coincidit amb aquesta
transacció. Només s'enregistra una execució per a les regles
coincidents, de manera que les avaluacions en producció sempre
porten `true`.
is_test:
type: boolean
description: >-
Cert quan la regla s'ha executat en mode TEST (sense cap
efecte en l'estat o la puntuació).
mode:
type: string
enum:
- ACTIVE
- DISABLED
- TEST
severity:
type: string
nullable: true
score_delta:
type: integer
description: Puntuació afegida per les accions `add_score` d'aquesta regla.
status_target:
type: string
nullable: true
description: Estat establert per una acció `change_status`, si n'hi ha.
action_summary:
type: string
nullable: true
description: >-
Resum de les accions que ha executat la regla, unides amb `; `
(p. ex., `score +30; change_status:IN_REVIEW;
add_tag:high_risk_country`). Parts: `score +N`,
`change_status:`, `add_tag:`, `add_note`,
`add_to_list`, `open_case`. `null` quan la regla no ha
executat cap acció.
metadata:
type: object
description: >-
Detall de l'avaluació: `scope_match`, `conditions[]` i
`aggregations[]`. Cada entrada de condició conté `field`,
`operator`, `expected_value`, el `current_value` llegit de la
transacció, `matched`, `group_index` i `group_logic`. Cada
entrada d'agregació (velocitat / recompte / suma) conté
`metric`, `field`, `operator`, `expected_value`, el
`computed_value` resultant de l'avaluació de l'agregat,
`window`, `filters`, `matched` i `sample_references`; les
agregacions asíncrones ajornades tenen `computed_value: null`
i `deferred: true`. Un grup de condicions niat és una entrada
de `conditions[]` amb l'`operator` `any_of` o `all_of`,
`field` null, i els resultats dels seus membres sota el seu
propi `conditions`.
created_at:
type: string
format: date-time
description: >-
Resultats d'execució per regla: quina regla s'ha activat, amb quin
impacte en la puntuació.
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 de resposta del proveïdor en brut.
created_at:
type: string
format: date-time
description: >-
Payloads en brut dels proveïdors (Cribratge AML, anàlisi de
blockchain, etc.).
travel_rule:
nullable: true
allOf:
- $ref: '#/components/schemas/TransactionTravelRule'
description: >-
Transferència o comprovació de Travel Rule. S'emplena quan s'ha
enviat `travel_rule_details`, i també quan Travel Rule està activat
i la transacció s'ha creat amb `transaction_category: travelRule`
(Didit inicia l'intercanvi directament, fins i tot sense
`travel_rule_details`). `null` quan no existeix cap transferència o
comprovació. En una transferència entrant, els camps
`originator_data` i `beneficiary_data` de la contrapart romanen
emmascarats (`data_masked: true`) fins que es confirma la
titularitat de la cartera.
network_snapshot:
type: object
nullable: true
description: >-
Instantània del graf de transaccions/parts relacionades utilitzada
pel motor de regles. O bé el `network_snapshot` enviat amb la
transacció o bé el graf que Didit construeix a partir d'un cribratge
AML de carteres satisfactori (que substitueix el que s'hagi enviat).
`null` quan cap dels dos existeix.
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: >-
Sessió de correcció oferta a l'usuari quan es requereix una
reverificació. Substituïda per `action_required`, que és el bloc
canònic; es manté per compatibilitat amb versions anteriors.
properties:
session_id:
type: string
session_token:
type: string
url:
type: string
format: uri
status:
type: string
action_required:
type: object
nullable: true
description: >-
Acció pendent de l'usuari final necessària per completar aquesta
transacció, o null si no n'hi ha cap. Els SDK de Didit inicien
automàticament l'acció per defecte i actualitzen la transacció quan
finalitza. Dues variants, discriminades per `type`:
`verification_session` (una sessió de verificació allotjada creada
per una acció de regla) i `wallet_ownership` (una sessió de widget
de titularitat de la cartera generada automàticament per a una
transferència de Travel Rule que necessita un comprovant de control
de la cartera, regulada per la configuració de Travel Rule
`auto_wallet_verification`). Quan totes dues es podrien aplicar,
`wallet_ownership` té prioritat perquè bloqueja l'intercanvi de
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: >-
Cost d'aquesta transacció: `total_price` i `items`, un per càrrec,
cadascun amb `usage_type`, `price`, `details` i `created_at`. Un nou
cribratge de la mateixa transacció és un element nou.
TransactionTravelRule:
type: object
description: >-
Una transferència Travel Rule d'una transacció, tal com la retornen `GET
/v3/transactions/{transaction_id}/`, el `201` de `POST
/v3/transactions/` i cada fila de `GET /v3/transactions/`. `direction`,
`rail`, `counterparty_vasp`, `delivery`, `discovery`, `reason` i
`next_actions` tenen la mateixa estructura que a `PATCH
/v3/transactions/{transaction_id}/travel-rule/`, de manera que una
lectura d'una transacció indica per què la seva transferència està
bloquejada i què cal per fer-la avançar.
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: >-
Part ordenant. Per a una transferència entrant, els valors de la
contrapart s'emmascaren fins que se'n confirmi la titularitat.
beneficiary_data:
type: object
description: >-
Part beneficiària. Per a una transferència entrant, els valors de la
contrapart s'emmascaren fins que es confirmi la titularitat.
name_match:
type: object
nullable: true
description: >-
La comparació de noms que ha decidit la transferència (puntuació i
estrictesa). Null fins que se n'hagi executat una. Els noms
comparats s'emmascaren juntament amb les parts.
data_match:
$ref: '#/components/schemas/TravelRuleDataMatch'
mismatched_fields:
type: array
items:
type: string
description: >-
Drecera per a `data_match.mismatched_fields`. Buit quan no hi ha cap
diferència.
data_unmasked:
$ref: '#/components/schemas/TravelRuleDataUnmasked'
data_masked:
type: boolean
description: >-
Cert mentre les dades personals de la contrapart estiguin
emmascarades en aquesta resposta.
metadata:
type: object
direction:
type: string
enum:
- INBOUND
- OUTBOUND
description: A quin costat de l'intercanvi pertany aquesta transferència.
rail:
type: string
nullable: true
description: >-
El rail pel qual s'ha enviat la transferència: `INTERNAL`, `TRP`,
`GTR`, `TRUST`, `VERIFYVASP`, `SYGNA` o `EMAIL` (`TEST_VASP` en una
aplicació de sandbox, quan el Didit Test VASP ha respost), o `null`
fins que es triï un rail.
counterparty_vasp:
type: object
nullable: true
properties:
name:
type: string
lei:
type: string
dd_score:
type: integer
description: >-
Puntuació de diligència deguda de 0 a 100, on un valor més alt
és millor. La mateixa escala que al directori de VASP.
dd_score_breakdown:
type: object
description: >-
Contribucions per component a dd_score, un objecte per component
tal com apareix al directori de VASP (jurisdiction,
verification, protocol, lei, history, essentials,
responsiveness), cadascun amb {points, max, reason, detail}. {}
fins que s'hagi avaluat la contrapart.
additionalProperties:
type: object
properties:
points:
type: number
description: Punts atorgats per a aquest component.
max:
type: integer
description: Nombre màxim de punts que pot atorgar aquest component.
reason:
type: string
description: Codi llegible per màquina del veredicte del component.
detail:
type: string
description: Motiu dels punts atorgats, llegible per a humans.
dd_assessed_at:
type: string
format: date-time
nullable: true
description: >-
Quan es va executar per darrera vegada l'avaluació de diligència
deguda. Null fins que s'hagi avaluat la contrapart.
description: >-
L'entrada del directori de la contrapart, o `null` si la
transferència no n'enllaça cap.
delivery:
nullable: true
allOf:
- $ref: '#/components/schemas/TravelRuleDelivery'
description: >-
El missatge més recent que la transferència deu a una altra part.
`null` quan no n'ha degut cap, per exemple per sota de
`threshold_amount` o per a una cartera autoallotjada declarada.
discovery:
type: array
description: >-
Com Didit ha cercat la contrapart, una entrada per cada pas que s'ha
executat. Buit quan no s'ha executat cap descobriment, per exemple
en una transferència entrant.
items:
$ref: '#/components/schemas/TravelRuleDiscoveryStep'
reason:
type: string
description: >-
Per què una transferència `COUNTERPARTY_VASP_NOT_FOUND` o
`COUNTERPARTY_VASP_NOT_REACHABLE` està encallada; `""` per a
qualsevol altre estat. Un lliurament fallit ho determina primer,
només a `COUNTERPARTY_VASP_NOT_REACHABLE`: `email_undeliverable` (el
proveïdor de correu ha refusat el correu electrònic de compliment i
no queda cap adreça per provar: quan s'ha enviat, en un recordatori
o com un rebot permanent notificat més tard) o `delivery_failed` (el
canal que l'estava lliurant ha fallat definitivament: un canal de
xarxa ha refusat el missatge o s'ha quedat sense reintents, un host
d'identitat `TRP` no ha respost o l'host `TRP` de la contrapart no
ha acceptat la consulta). En cas contrari, el rastreig de
`discovery` ho determina: `awaiting_end_user` (cap pas ha indicat
una contrapart a la qual Didit pugui arribar),
`directory_match_no_route` (un pas ha indicat un VASP del directori
que no té ruta), `picked_member_without_proven_wallet` (l'usuari
final ha triat un client de Didit que no ha demostrat el control de
la cartera) o `no_directory_match` quan el rastreig no dóna cap
altre motiu. Un reenviament fa avançar la transferència, de manera
que el motiu s'esborra. Consulta [Per què una transferència està
encallada](/ca/transaction-monitoring/travel-rule#per-què-una-transferència-està-bloquejada).
next_actions:
type: array
description: >-
Què fa avançar la transferència; `[]` per a qualsevol estat excepte
`COUNTERPARTY_VASP_NOT_FOUND` o `COUNTERPARTY_VASP_NOT_REACHABLE`.
`email_undeliverable` ofereix `update_compliance_email` i després
`resend`. `delivery_failed` ofereix `resend`. Un motiu de
descobriment ofereix `select_counterparty_vasp`,
`declare_self_hosted`, `add_vasp_hint` i `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 de verificació allotjada per obrir per a l'usuari final.
session_id:
type: string
format: uuid
description: ID de la sessió de verificació.
session_token:
type: string
description: >-
Token de sessió, utilitzat pels SDK mòbils per iniciar el flux de
manera nativa.
status:
type: string
description: Estat de la sessió de verificació.
required:
- type
- url
TransactionWalletOwnershipAction:
title: Wallet ownership
type: object
properties:
type:
type: string
enum:
- wallet_ownership
url:
type: string
format: uri
description: >-
URL del giny allotjat de titularitat de la cartera. Obre'l en un
navegador real; al mòbil fes servir SFSafariViewController o una
pestanya personalitzada de Chrome, mai una webview incrustada.
widget_session_id:
type: string
format: uuid
description: ID de sessió del widget de titularitat de la cartera.
expires_at:
type: string
format: date-time
description: Quan caduca la sessió del widget.
required:
- type
- url
TravelRuleDataMatch:
type: object
nullable: true
description: >-
Comparació camp per camp de les dades de les parts de la transferència
amb el que l'altra part sap sobre el titular de la cartera. Nomena camps
i resultats, mai valors, de manera que continua sent llegible mentre les
dades de la contrapart estan emmascarades. Null fins que s'executi una
comparació.
properties:
matched:
type: boolean
description: Cert quan cap camp comparat difereix.
mismatched_fields:
type: array
items:
type: string
enum:
- name
- date_of_birth
- address
- account
description: Els camps que difereixen.
fields:
type: object
description: >-
Una entrada per camp comparat per al tipus d'entitat de la part
(`name`, `date_of_birth`, `address`, `account`; una empresa no té
`date_of_birth`).
additionalProperties:
type: object
properties:
result:
type: string
enum:
- matched
- mismatched
- not_compared
description: >-
`not_compared` quan la regla és `NONE` o una de les dues parts
no té cap valor per al camp.
strictness:
type: string
enum:
- NONE
- STRICT
- CONTAINS
- DEFAULT
- FUZZY
TravelRuleDataUnmasked:
type: object
nullable: true
description: >-
Registre d'auditoria del moment en què es van desenmascarar les dades de
la contrapart. És null mentre les dades continuïn emmascarades, així com
per a transferències sortints.
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: >-
Què va confirmar la titularitat: ownership_confirmed (la teva
confirmació mitjançant la consola o l'API), wallet_proof (una prova
de cartera al widget, o una transferència entrant INTERNAL,
establerta quan es crea), address_book_match (una cartera de la
llibreta d'adreces verificada), own_verified_wallet (la pròpia
cartera verificada del teu usuari), inquiry_approved (la teva
aprovació d'una consulta TRP entrant o un missatge GTR o Sygna),
known_payment_method (una cartera amb la qual el teu usuari ja ha
pagat) o travel_address (la Travel Address per cartera que va donar
nom a la cartera).
actor:
type: string
description: >-
Qui ho ha confirmat: el correu electrònic de l'usuari de la consola
o l'etiqueta de la clau d'API. En blanc per a una decisió
automàtica.
TravelRuleDelivery:
type: object
description: >-
Estat en què es troba l'últim missatge que la transferència deu a
l'altra part. Didit contacta amb la contrapart un cop retornada la
sol·licitud que ha creat o modificat la transferència, de manera que
aquest objecte indica si el missatge s'ha lliurat: en cua, enviant-se,
esperant per reintentar després d'un error, lliurat o fallit. Una
fallada de la qual la xarxa encara es pot recuperar (sense resposta a
temps, connexió fallida, HTTP `408`, `429` o `5xx`) es reintenta al cap
de 30 segons, 2 minuts, 10 minuts, 30 minuts i 1 hora. Quan un primer
missatge (`kind: SEND`) falla definitivament, perquè la xarxa l'ha
rebutjat o perquè el sisè intent també ha fallat, la transferència passa
a `COUNTERPARTY_VASP_NOT_REACHABLE` amb `last_error` a la seva
`timeline`; qualsevol altre missatge que falli definitivament s'anota a
la `timeline`. L'`status` de la transferència continua sent la font de
referència de l'intercanvi en si.
required:
- kind
- status
- rail
- attempts
- last_error
- next_attempt_at
- delivered_at
properties:
kind:
type: string
enum:
- SEND
- ANSWER
- TXID
- CANCEL
- POLL
description: >-
Què transmet el missatge. `SEND`: el primer missatge de la
transferència a la contrapart (sortint; el canal es tria quan
s'envia). `ANSWER`: la teva acceptació o rebuig, que es deu a la
xarxa que ho ha sol·licitat (entrant). `TXID`: el hash de la
transacció on-chain, un cop finalitzis la transferència. `CANCEL`:
la cancel·lació, un cop la cancel·lis. `POLL`: una consulta d'estat
a una xarxa que n'ofereixi una, repetida cada 5 minuts mentre la
transferència espera la contrapart.
status:
type: string
enum:
- QUEUED
- SENDING
- RETRYING
- DELIVERED
- FAILED
description: >-
`QUEUED`: esperant per enviar-se. `SENDING`: hi ha un intent en
curs. `RETRYING`: un intent ha fallat i el següent s'executarà a
`next_attempt_at`. `DELIVERED`: l'altra part ha rebut el missatge.
`FAILED`: l'altra part l'ha rebutjat o el darrer intent ha fallat.
rail:
type: string
enum:
- INTERNAL
- TRP
- GTR
- TRUST
- VERIFYVASP
- SYGNA
- EMAIL
- ''
description: >-
El rail que transporta el missatge. Buit fins que Didit n'hagi triat
un per a un primer missatge.
attempts:
type: integer
minimum: 0
description: >-
Intents realitzats fins ara per a aquest missatge. Un missatge que
no sigui un sondeig d'estat s'intenta com a màxim 6 vegades.
last_error:
type: string
description: >-
El tipus d'error que ha afectat l'últim intent, `""` quan no n'hi ha
hagut cap: per exemple `email undeliverable`, `trp identity endpoint
unreachable` o `trp transfer inquiry delivery failed`. Mai no conté
la resposta de la contrapart mateixa, que roman al `timeline` de la
transferència.
Quan GTR respon amb un error, s'hi inclouen el seu propi codi
d'estat i missatge. Els cossos de resposta no s'inclouen mai.
example: email undeliverable
next_attempt_at:
type: string
format: date-time
nullable: true
description: >-
Quan s'executa el següent intent mentre el missatge està en estat
`QUEUED` o `RETRYING`.
delivered_at:
type: string
format: date-time
nullable: true
description: Quan l'altra part va rebre el missatge.
TravelRuleDiscoveryStep:
type: object
description: >-
Un pas de la detecció de la contrapart que Didit ha executat per a una
transferència sortint, en l'ordre en què els ha executat. El primer pas
que anomena un VASP amb una ruta finalitza la cadena.
properties:
step:
type: string
enum:
- internal_address_book
- wallet_attribution
- network_lookup
- customer_hint
- end_user
description: >-
`internal_address_book`: un altre client de Didit que ha demostrat
el control de la cartera de destinació. `wallet_attribution`:
l'atribució d'analítica blockchain de la cartera. `network_lookup`:
una xarxa que pot indicar quin VASP té l'adreça. `customer_hint`: el
nom del VASP, LEI o jurisdicció que has enviat a `beneficiary_data`.
`end_user`: la contrapart que l'usuari final (o tu) ha triat, o la
sol·licitud per triar-ne una.
outcome:
type: string
enum:
- match
- miss
- skipped
description: >-
`match`: el pas ha indicat una contrapart. `miss`: s'ha executat i
no n'ha trobat cap. `skipped`: no s'ha pogut executar, i `reason`
n'explica el motiu.
reason:
type: string
description: >-
Motiu llegible per màquina, `""` en cas de coincidència:
`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` o `picked_member_without_proven_wallet`.
vasp:
type: string
format: uuid
nullable: true
description: El VASP del directori que ha indicat el pas, si n'ha indicat algun.
rail:
type: string
nullable: true
description: El rail que arriba a aquesta contrapart, quan el pas n'ha trobat un.
at:
type: string
format: date-time
TravelRuleNextAction:
type: object
description: >-
Un element que fa avançar una transferència
`COUNTERPARTY_VASP_NOT_FOUND` o `COUNTERPARTY_VASP_NOT_REACHABLE`.
Consulta [Per què una transferència està
bloquejada](/ca/transaction-monitoring/travel-rule#per-què-una-transferència-està-bloquejada).
properties:
action:
type: string
enum:
- select_counterparty_vasp
- declare_self_hosted
- add_vasp_hint
- update_compliance_email
- resend
description: >-
`select_counterparty_vasp`: l'usuari final tria el VASP de
destinació al widget de titularitat de la cartera, o fas un PATCH
amb `action=beneficiary_vasp`. `declare_self_hosted`: l'usuari final
declara que la cartera és autoallotjada al widget. `add_vasp_hint`:
indica a Didit qui és la contrapart, amb un nom de VASP, LEI o
Travel Address (per exemple, un `travel_address` a l'entrada de la
llibreta d'adreces de la cartera de destinació), i després torna a
enviar. `update_compliance_email` i `resend` són valors d'`action`
de `PATCH /v3/transactions/{transaction_id}/travel-rule/`: torna a
proporcionar el correu electrònic de compliment de la contrapart i
torna a executar l'encaminament.
url:
type: string
format: uri
description: >-
L'enllaç del widget de titularitat de la cartera, a
`select_counterparty_vasp` i `declare_self_hosted` mentre la
transferència té una sessió de widget oberta.
required:
- action
TravelRuleChainDetails:
type: object
description: >-
Com anomena la cadena de la transferència les seves dues carteres, quan
es tracta de més d'una adreça pagant-ne una altra. Buit (`{}`) per a una
transferència de cadena basada en comptes (EVM, Solana, Tron), on les
dues adreces són les carteres. La coincidència, l'encaminament i la
llibreta d'adreces llegeixen primer les carteres d'aquí.
properties:
chain:
type: string
description: >-
Cadena canònica, p. ex. `BTC`, `XRP` o `LIGHTNING` per a una
transferència Lightning.
shape:
type: string
enum:
- utxo
- memo
- lightning
originator:
$ref: '#/components/schemas/TravelRuleChainSide'
beneficiary:
$ref: '#/components/schemas/TravelRuleChainSide'
utxo:
type: object
description: >-
En una transferència UTXO: les entrades i sortides tal com s'han
emmagatzemat (imports com a cadenes decimals) i què ha llegit Didit
en cada sortida.
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: Sortides que retornen el pagament a una adreça d'entrada.
beneficiary_output_index:
type: integer
nullable: true
description: >-
La sortida que paga al beneficiari; null quan no se'n pot
distingir cap.
lightning:
type: object
description: >-
En una transferència de Lightning: el que diu la sol·licitud de
pagament. Sempre `kind` (`bolt11`, `bolt12_offer`, `bolt12_invoice`,
`bolt12_invoice_request`, `lnurl`, `lightning_address`, `node_id` o
`unknown`); una factura BOLT11 afegeix `network`, `payee_node_id`,
`payment_hash`, `amount_msat`, `created_at` i `expires_at`; una
cadena BOLT12 afegeix `blinded_paths` i `payee_node_id`; un LNURL o
una Lightning Address inclou el seu `domain`. No es resol res a
través de la xarxa: la sol·licitud només es descodifica.
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: >-
Inconsistències d'UTXO que val la pena revisar: l'ordenant declarat
no és una entrada, el beneficiari declarat no és una sortida, no
s'ha pogut distingir cap sortida de beneficiari única o la sortida
del beneficiari paga un import diferent del que indica la
transacció.
not_applicable_reason:
type: string
enum:
- LIGHTNING_NO_PAYEE_IDENTIFIER
- LIGHTNING_BOLT12_BLINDED_PAYEE
- LIGHTNING_LNURL_NAMES_NO_PAYEE
description: >-
En una transferència sortint de Lightning la sol·licitud de pagament
de la qual no especifica cap beneficiari: per què la transferència
és `NOT_APPLICABLE`. `LIGHTNING_NO_PAYEE_IDENTIFIER` (la sol·licitud
no especifica cap node beneficiari, o no s'ha pogut descodificar),
`LIGHTNING_BOLT12_BLINDED_PAYEE` (l'oferta amaga el seu beneficiari
darrere de rutes cegues), `LIGHTNING_LNURL_NAMES_NO_PAYEE` (un LNURL
especifica un servei, no un beneficiari). El mateix codi obre
l'última entrada de la `timeline` de la transferència.
TravelRuleChainSide:
type: object
description: >-
La cartera d'una de les parts tal com Didit l'ha resolt a partir de les
dades de la cadena.
properties:
address:
type: string
description: >-
La cartera. En una xarxa amb memo, l'adreça clàssica (una adreça X
d'XRP es divideix en la seva adreça clàssica i la seva etiqueta); a
Lightning, l'ID del node del beneficiari o l'adreça Lightning.
memo:
type: string
description: >-
L'etiqueta de destinació o nota que forma part de la cartera; `""`
quan no n'hi ha cap.
source:
type: string
enum:
- declared
- x_address
- largest_input
- only_non_change_output
- amount_match
- invoice_payee
- updated
description: >-
D'on prové la cartera: `declared` (la teva sol·licitud), `x_address`
(desglossada d'una adreça X d'XRP), `largest_input` (l'adreça
d'entrada UTXO que ha aportat més), `only_non_change_output`
(l'única sortida UTXO que no és canvi), `amount_match` (l'única
sortida UTXO que paga l'import de la transferència), `invoice_payee`
(el beneficiari que indica una sol·licitud de pagament de
Lightning), `updated` (establert més tard amb `action:
update_originator_wallet`).
TravelRuleUtxoEntry:
type: object
description: >-
Una entrada o sortida d'una transacció UTXO, tal com la va registrar la
cadena.
required:
- address
properties:
address:
type: string
maxLength: 128
amount:
type: string
nullable: true
description: >-
Cadena decimal en la unitat pròpia de la moneda (BTC, no satoshis).
Opcional.
example: '0.0125'
txid:
type: string
maxLength: 128
description: Opcional. La transacció que gasta un input.
vout:
type: integer
nullable: true
minimum: 0
description: Opcional. L'índex de la sortida que consumeix una entrada.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
La clau d'API de la teva aplicació, des de Developers -> API keys a la
Business Console. La clau primària té accés complet. Una clau amb nom
pot tenir l'abast limitat: cap, lectura o escriptura per recurs,
limitada a determinats fluxos de treball o a sessions aprovades, a una
llista d'adreces IP i a una data de caducitat. 401 significa que la clau
és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap
clau, que la clau no té accés a aquest recurs o acció, o que la
sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una
ruta de sessió significa que la sessió està fora dels fluxos de treball
o estats de la clau. Una clau sense accés a fitxers multimèdia rep els
URL d'imatge, vídeo i PDF com a null, i una clau sense permís
d'escriptura de sessions rep els enllaços de sessió i els tokens com a
null. Consulta https://docs.didit.me/console/api-keys.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.