> ## 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. # Llistar transaccions API: monitoratge KYT > Consulta transaccions monitoritzades de Didit amb puntuació de risc i contraparts. KYT amb pagament per crida, sense contractes. Prompt de l'API per llistar transaccions Copia el prompt al porta-retalls \

\`List monitored transactions for my Didit application through the Management API.

Endpoint:
GET https://verification.didit.me/v3/transactions/

Authentication:
Use the x-api-key header with my Didit API key.

Goal:
\- Retrieve a paginated list of high-level transaction summaries (score, severity, status, parties, tags, decision metadata) — suitable for back-office review screens, fraud dashboards, and audit exports.

Query parameters:
\- limit - page size (default 50, min 1).
\- offset — zero-based offset (default 0). Prefer following the next URL from the previous page.

Ordering & pagination:
\- Ordered by txn_date descending (most recent first), with created_at as a tie-breaker.
\- count is a bounded counter (exact up to 100, capped above). Use total_transactions when present for the true count.
\- Transactions deleted via the Console are not returned.

Filtering:
\- Besides limit / offset, this endpoint accepts travel_rule_status, an exact Travel Rule status (for example ON_HOLD), and then returns only transactions whose Travel Rule transfer is in that status.
count follows this filter, but total_transactions always counts every transaction in the application.
\- It also accepts assignee, a comma-separated list where any value matches: me (the calling reviewer, with a user token), unassigned, rules (decided by the rules alone, no reviewer involved), or a member email.
\- For other filtering (party, status, severity, date range), use the Console UI.

Example call:
curl -X GET "https://verification.didit.me/v3/transactions/?limit=50" \
-H "x-api-key: YOUR_API_KEY"

What to read from each row:
\- uuid — stable Didit transaction id; use as {transaction_id} in GET /v3/transactions/{transaction_id}/.
\- transaction_number — application-scoped sequential number shown in Console.
\- txn_id — the identifier you supplied at create time (max 128 chars, unique per application).
\- status, score, severity, decision_reason_code, decision_reason_label — live monitoring verdict.
\- direction, amount, currency — raw submission. amount is a decimal string.
\- subject_name / subject_vendor_data / subject_country — denormalized APPLICANT party fields.
\- counterparty_name / counterparty_vendor_data / counterparty_country — denormalized COUNTERPARTY fields (may be null).
\- tags — Console tags (uuid, name, color).
\- assigned_to_name — Console reviewer who owns the transaction.
\- travel_rule_status - the status of the transaction's Travel Rule transfer (for example COMPLETED), or null when it has none.
\- travel_rule - the same Travel Rule block as GET /v3/transactions/{transaction_id}/ (status, direction, rail, counterparty_vasp, delivery, discovery, reason, next_actions and the rest), or null when the transaction has none.
Read reason and next_actions to see why each COUNTERPARTY_VASP_NOT_FOUND or COUNTERPARTY_VASP_NOT_REACHABLE transfer is stuck without one read per transaction.

Failure modes:
\- 403 - missing x-api-key (a wrong, revoked or expired key gets 401), or a key without permission for this action; the body is a { "detail": "..." } envelope.
\- 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/ 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/: get: tags: - Transactions summary: Llista les transaccions description: >- Llista paginada de transaccions monitorades, les més recents primer (`txn_date` desc). `count` està limitat a 100; fes servir `total_transactions` per obtenir el recompte real de files. Aquest endpoint no admet paràmetres de filtre ni de cerca. operationId: listTransactions parameters: - name: limit in: query schema: type: integer default: 50 minimum: 1 maximum: 1000000 description: >- Mida de la pàgina. Per defecte és 50 si s'omet. No hi ha cap màxim imposat, però mantén les pàgines petites per reduir la latència. - name: offset in: query schema: type: integer maximum: 1000000 minimum: 0 default: 0 description: >- Desplaçament basat en zero del primer registre a retornar. És preferible seguir l'URL `next` de la pàgina anterior. - name: travel_rule_status in: query required: false schema: type: string description: >- Retorna només les transaccions la transferència de Travel Rule de les quals estigui en aquest estat exacte (per exemple `ON_HOLD` o `AWAITING_COUNTERPARTY`). `count` segueix aquest filtre; `total_transactions` continua comptant totes les transaccions de l'aplicació. - name: assignee in: query required: false schema: type: string description: >- Separats per comes; una transacció coincideix quan compleix qualsevol dels valors. `unassigned` és el que encara no té ningú assignat, `rules` és el que les regles han decidit pel seu compte sense un revisor, i el correu d'un membre coincideix amb el revisor que té assignat. `me` és el revisor que ha iniciat sessió a la Console, de manera que una clau d'API que enviï `me` rep un `400`. responses: '200': description: Llista paginada de resums de transaccions, les més recents primer. content: application/json: schema: type: object properties: count: type: integer description: >- Recompte limitat de transaccions coincidents (exacte fins a 100, limitat a partir d'aquí). Fes servir `total_transactions` per obtenir el recompte real en paginar. next: type: string nullable: true description: >- URL absoluta de la pàgina següent, o `null` a l'última pàgina. previous: type: string nullable: true description: >- URL absoluta de la pàgina anterior, o `null` a la primera pàgina. total_transactions: type: integer description: >- Nombre total exacte de transaccions (no suprimides) per a l'aplicació. Present en respostes paginades. results: type: array items: type: object properties: uuid: type: string format: uuid description: >- Identificador de transacció de Didit estable. Utilitza'l com a `{transaction_id}` en crides de detall, notes o relacionades. 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: >- Identificador proporcionat pel client a la crida de creació (màx. 128 caràcters). Únic per aplicació. 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`). status: type: string enum: - APPROVED - IN_REVIEW - DECLINED - AWAITING_USER description: Veredicte de monitoratge actual. 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. 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. 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 description: >- Codi de moneda preferida utilitzat per a `preferred_currency_amount`: la moneda base de l'aplicació, qualsevol codi ISO 4217 en circulació actualment. Un codi sense tipus de canvi disponible deixa `preferred_currency_amount` com a null tret que la sol·licitud hagi proporcionat un `amount_in_default_currency` preconvertit. payment_details: type: string nullable: true description: >- Referència de pagament o concepte de text lliure de l'enviament. score: type: integer description: >- Puntuació de risc (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. subject_name: type: string nullable: true description: Nom complet de la part `APPLICANT`. subject_vendor_data: type: string nullable: true description: >- El teu identificador intern d'usuari/empresa per al sol·licitant. subject_country: type: string nullable: true description: >- Codi de país del sol·licitant, a partir de l'`address.country` enviat (normalment ISO 3166-1 alpha-3). counterparty_name: type: string nullable: true description: Nom complet de la part `COUNTERPARTY`, si n'hi ha. counterparty_vendor_data: type: string nullable: true description: El teu identificador intern per a la contrapart. counterparty_country: type: string nullable: true description: >- Codi de país de la contrapart, a partir de l'`address.country` enviat. 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). txn_date: type: string format: date-time description: >- Quan va tenir lloc la transacció (a partir de `transaction_at` en el moment de la creació). created_at: type: string format: date-time description: Quan Didit ha registrat l'enviament. decision_reason_code: type: string nullable: true description: >- Motiu llegible per màquina per a l'`status` actual (p. ex., `WALLET_HIGH_RISK`). decision_reason_label: type: string nullable: true description: >- Etiqueta fàcil de llegir per a `decision_reason_code`. assigned_to_name: type: string nullable: true description: >- Nom visible del revisor de la consola assignat a aquesta transacció. travel_rule_status: type: string nullable: true description: >- Estat de la transferència de Travel Rule de la transacció (per exemple `COMPLETED`), o `null` quan no en té cap. travel_rule: nullable: true allOf: - $ref: '#/components/schemas/TransactionTravelRule' description: >- La transferència de Travel Rule de la transacció, el mateix bloc que `travel_rule` a `GET /v3/transactions/{transaction_id}/`, o `null` quan la transacció no en té cap. examples: Single transaction: value: count: 1 next: null previous: null total_transactions: 1 results: - uuid: abcdef12-3456-4890-abcd-ef1234567890 transaction_number: 4123 txn_id: your-txn-2026-05-17-001 transaction_type: finance action_type: withdrawal status: IN_REVIEW direction: OUTBOUND amount: '1500' currency: EUR preferred_currency_amount: '1620.45' preferred_currency_code: USD payment_details: Withdrawal to crypto wallet txn_date: '2026-05-17T08:42:00Z' created_at: '2026-05-17T08:42:11Z' score: 78 severity: HIGH decision_reason_code: WALLET_HIGH_RISK decision_reason_label: Destination wallet flagged as high risk tags: - uuid: 9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d name: Manual review color: '#F59E0B' description: null source: custom subject_name: Maria Garcia subject_vendor_data: user-12345 counterparty_name: null counterparty_vendor_data: null counterparty_country: null subject_country: null assigned_to_name: Alex Reviewer travel_rule_status: null travel_rule: null '403': description: >- Clau d'API absent, no vàlida o revocada, o bé la clau no pot llistar transaccions per a 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. '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/?limit=50' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() for item in client.transactions.list(): print(item) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); for await (const item of didit.transactions.list()) { console.log(item); } - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.Transactions.ListAutoPaging(ctx, didit.TransactionsListParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: |- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); for (var item : client.transactions().list()) { System.out.println(item); } - lang: php label: PHP source: |- transactions->list() as $item) { print_r($item->toArray()); } - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.transactions.list.auto_paging_each do |item| puts item.to_h end - lang: csharp label: .NET source: |- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); await foreach (var item in await client.Transactions.ListAsync()) { Console.WriteLine(JsonSerializer.Serialize(item)); } components: schemas: 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' 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.