> ## 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 de liste des transactions : surveillance KYT > Listez les transactions surveillées avec Didit : scores de risque, gravité, contreparties et statut de filtrage. KYT à l'appel, sans contrat. Prompt de l'API de liste des transactions Copier le prompt dans le presse-papiers \

\`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.`

\
Coller dans ## OpenAPI ````yaml fr/openapi-25.json GET /v3/transactions/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/transactions/: get: tags: - Transactions summary: Lister les transactions description: >- Liste paginée des transactions surveillées, de la plus récente à la plus ancienne (`txn_date` décroissant). `count` est plafonné à 100 ; utilisez `total_transactions` pour obtenir le nombre réel de lignes. Cet endpoint ne prend pas en charge les paramètres de filtrage ou de recherche. operationId: listTransactions parameters: - name: limit in: query schema: type: integer default: 50 minimum: 1 maximum: 1000000 description: >- Taille de page. Vaut 50 par défaut si omis. Aucun maximum n'est imposé, mais conservez des pages de petite taille pour limiter la latence. - name: offset in: query schema: type: integer maximum: 1000000 minimum: 0 default: 0 description: >- Décalage de départ (base zéro) du premier enregistrement à retourner. Privilégiez l'utilisation de l'URL `next` de la page précédente. - name: travel_rule_status in: query required: false schema: type: string description: "Renvoie uniquement les transactions dont le transfert Travel Rule est exactement dans ce statut (par exemple `ON_HOLD` ou `AWAITING_COUNTERPARTY`). `count` applique ce filtre\_; `total_transactions` compte toujours chaque transaction dans l'application." - name: assignee in: query required: false schema: type: string description: >- Séparés par des virgules ; une transaction correspond lorsqu'elle remplit l'une des valeurs. `unassigned` correspond à ce qui n'est encore attribué à personne, `rules` correspond à ce que les règles ont décidé d'elles-mêmes sans réviseur, et l'e-mail d'un membre correspond au réviseur qui lui est assigné. `me` représente le réviseur connecté à la console, ainsi une clé API envoyant `me` reçoit un `400`. responses: '200': description: >- Liste paginée des résumés de transactions, de la plus récente à la plus ancienne. content: application/json: schema: type: object properties: count: type: integer description: >- Nombre plafonné de transactions correspondantes (exact jusqu'à 100, plafonné au-delà). Utilisez `total_transactions` pour obtenir le décompte réel lors de la pagination. next: type: string nullable: true description: >- URL absolue de la page suivante, ou `null` sur la dernière page. previous: type: string nullable: true description: >- URL absolue de la page précédente, ou `null` sur la première page. total_transactions: type: integer description: >- Nombre total exact de transactions (non supprimées) pour l'application. Présent dans les réponses paginées. results: type: array items: type: object properties: uuid: type: string format: uuid description: >- Identifiant de transaction Didit stable. À utiliser comme `{transaction_id}` dans les appels de détails, de notes et connexes. transaction_number: type: integer description: >- Numéro de transaction séquentiel propre à l'application affiché dans la console (ex. `4123`). txn_id: type: string description: >- Identifiant fourni par le client issu de l'appel de création (128 caractères max). Unique par application. transaction_type: type: string description: >- Catégorie de premier niveau telle que stockée : `finance`, `kyc`, `travelRule`, `userPlatformEvent`, `gamblingBet`, `gamblingLimitChange`, `gamblingBonusChange`, `auditTrailEvent`. Notez que les valeurs composées de plusieurs mots sont renvoyées en camelCase même lorsqu'elles ont été transmises en snake_case. action_type: type: string description: >- Sous-type au sein de la catégorie (par exemple `deposit`, `withdrawal`, `transfer`). status: type: string enum: - APPROVED - IN_REVIEW - DECLINED - AWAITING_USER description: Verdict actuel de la surveillance. direction: type: string enum: - INBOUND - OUTBOUND description: >- Direction relative au sujet. Stockée en majuscules quelle que soit la casse fournie. amount: type: string description: >- Montant de la transaction sous forme de chaîne décimale sans les zéros de fin (par ex. `"1500"`, `"0.5"`, `"0.123456789012345678"`). Jusqu'à 18 décimales. currency: type: string description: >- Code devise de `amount`. Tout code alphabétique ISO 4217 est accepté (par ex. `EUR`, `USD`, `NGN`), ainsi qu'un symbole d'actif crypto (par ex. `BTC`). Privilégiez un code actuellement en circulation. Tous les codes acceptés ne disposent pas d'un taux de change : lorsqu'aucun taux n'est disponible pour le code (par exemple l'unité de compte ISO `XSU`, ou un symbole crypto dont Didit n'établit pas le prix), la conversion automatique échoue et `preferred_currency_amount` est retourné nul, sauf si la requête a fourni un montant pré-converti `amount_in_default_currency`. preferred_currency_amount: type: string nullable: true description: >- `amount` converti dans la devise préférée de l'application, lorsqu'il est disponible. preferred_currency_code: type: string nullable: true description: >- Code de devise préféré utilisé pour `preferred_currency_amount` - la devise de base de l'application, tout code ISO 4217 actuellement en circulation. Un code sans taux de change disponible laisse `preferred_currency_amount` à null, sauf si la requête a fourni un `amount_in_default_currency` pré-converti. payment_details: type: string nullable: true description: >- Référence ou mémo de paiement en texte libre issu de la soumission. score: type: integer description: >- Score de risque (généralement 0–100). Plus il est élevé, plus le risque est grand. severity: type: string nullable: true enum: - UNKNOWN - LOW - MEDIUM - HIGH - CRITICAL description: >- Gravité catégorielle du risque définie par les règles/fournisseurs (`UNKNOWN`, `LOW`, `MEDIUM`, `HIGH`, `CRITICAL`). `null` jusqu'à ce qu'un élément la définisse. subject_name: type: string nullable: true description: Nom complet de la partie `APPLICANT`. subject_vendor_data: type: string nullable: true description: >- Votre identifiant interne d'utilisateur/entreprise pour le candidat. subject_country: type: string nullable: true description: >- Code pays du demandeur, issu de l'élément soumis `address.country` (généralement ISO 3166-1 alpha-3). counterparty_name: type: string nullable: true description: >- Nom complet de la partie `COUNTERPARTY`, le cas échéant. counterparty_vendor_data: type: string nullable: true description: Votre identifiant interne pour la contrepartie. counterparty_country: type: string nullable: true description: >- Code pays de la contrepartie, issu de l'élément soumis `address.country`. 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: >- Indique si le tag est un préréglage Didit ou un tag personnalisé. description: >- Tags associés à la transaction (manuellement ou par des règles). txn_date: type: string format: date-time description: >- Date et heure auxquelles la transaction a eu lieu (à partir de `transaction_at` lors de la création). created_at: type: string format: date-time description: >- Date et heure auxquelles Didit a enregistré la soumission. decision_reason_code: type: string nullable: true description: >- Raison lisible par machine pour le `status` actuel (par ex. `WALLET_HIGH_RISK`). decision_reason_label: type: string nullable: true description: >- Libellé lisible par l'humain pour `decision_reason_code`. assigned_to_name: type: string nullable: true description: >- Nom d'affichage du réviseur de la Console assigné à cette transaction. travel_rule_status: type: string nullable: true description: >- Statut du transfert Travel Rule de la transaction (par exemple `COMPLETED`), ou `null` lorsqu'il n'en a aucun. travel_rule: nullable: true allOf: - $ref: '#/components/schemas/TransactionTravelRule' description: >- Le transfert Travel Rule de la transaction, le même bloc que `travel_rule` sur `GET /v3/transactions/{transaction_id}/`, ou `null` lorsque la transaction n'en a aucun. 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: >- Clé API manquante, invalide ou révoquée, ou la clé ne peut pas lister les transactions pour cette application. Une clé manquante renvoie `403` ; une clé incorrecte, révoquée ou expirée renvoie `401`. content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '429': description: >- Limite de débit dépassée ; réduisez la cadence et réessayez après l'intervalle indiqué dans `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: >- Le transfert Travel Rule d'une transaction, tel que renvoyé par `GET /v3/transactions/{transaction_id}/`, le `201` de `POST /v3/transactions/` et chaque ligne de `GET /v3/transactions/`. `direction`, `rail`, `counterparty_vasp`, `delivery`, `discovery`, `reason` et `next_actions` ont le même format que sur `PATCH /v3/transactions/{transaction_id}/travel-rule/`, de sorte qu'une seule lecture d'une transaction indique pourquoi son transfert est bloqué et ce qui permet de le faire avancer. 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: >- Partie du donneur d'ordre. Pour un transfert entrant, les valeurs de la contrepartie sont masquées jusqu'à ce que l'actionnariat soit confirmé. beneficiary_data: type: object description: >- Partie bénéficiaire. Pour un transfert entrant, les valeurs de la contrepartie sont masquées jusqu'à confirmation de la propriété. name_match: type: object nullable: true description: >- La comparaison de noms qui a déterminé le transfert (score et niveau d'exigence). Null tant qu'aucune comparaison n'a été exécutée. Les noms comparés sont masqués en même temps que les parties. data_match: $ref: '#/components/schemas/TravelRuleDataMatch' mismatched_fields: type: array items: type: string description: >- Raccourci pour `data_match.mismatched_fields`. Vide lorsque rien ne diffère. data_unmasked: $ref: '#/components/schemas/TravelRuleDataUnmasked' data_masked: type: boolean description: >- Vrai tant que les données personnelles de la contrepartie sont masquées dans cette réponse. metadata: type: object direction: type: string enum: - INBOUND - OUTBOUND description: De quel côté de l'échange se situe ce transfert. rail: type: string nullable: true description: "Le canal par lequel le transfert est passé\_: `INTERNAL`, `TRP`, `GTR`, `TRUST`, `VERIFYVASP`, `SYGNA` ou `EMAIL` (`TEST_VASP` sur une application sandbox, lorsque le VASP de test Didit a répondu), ou `null` jusqu'à ce qu'un canal soit choisi." counterparty_vasp: type: object nullable: true properties: name: type: string lei: type: string dd_score: type: integer description: >- Score de due diligence de 0 à 100, où une valeur plus élevée est meilleure. Même échelle que dans l'annuaire des VASP. dd_score_breakdown: type: object description: >- Contributions par composant au dd_score, un objet par composant comme dans le répertoire VASP (jurisdiction, verification, protocol, lei, history, essentials, responsiveness), chacun comprenant {points, max, reason, detail}. {} jusqu'à ce que la contrepartie ait été évaluée. additionalProperties: type: object properties: points: type: number description: Points attribués pour ce composant. max: type: integer description: Nombre maximal de points que ce composant peut attribuer. reason: type: string description: Code lisible par machine du verdict du composant. detail: type: string description: >- Raison lisible par l'utilisateur pour les points attribués. dd_assessed_at: type: string format: date-time nullable: true description: >- Date et heure de la dernière évaluation de diligence raisonnable. Null tant que la contrepartie n'a pas été évaluée. description: >- L'entrée d'annuaire de la contrepartie, ou `null` lorsque le transfert n'en associe aucune. delivery: nullable: true allOf: - $ref: '#/components/schemas/TravelRuleDelivery' description: >- Le message le plus récent que le transfert doit à une autre partie. `null` lorsqu'aucun message n'était dû, par exemple en dessous de `threshold_amount` ou pour un portefeuille auto-hébergé déclaré. discovery: type: array description: >- Manière dont Didit a recherché la contrepartie, une entrée par étape exécutée. Vide lorsqu'aucune recherche n'a été effectuée, par exemple lors d'un transfert entrant. items: $ref: '#/components/schemas/TravelRuleDiscoveryStep' reason: type: string description: "Raison pour laquelle un transfert `COUNTERPARTY_VASP_NOT_FOUND` ou `COUNTERPARTY_VASP_NOT_REACHABLE` est bloqué\_; `\"\"` pour tout autre statut. Un échec de livraison la détermine en premier, sur `COUNTERPARTY_VASP_NOT_REACHABLE` uniquement\_: `email_undeliverable` (le fournisseur de messagerie a refusé l'e-mail de conformité et il ne reste aucune adresse à essayer\_: lors de son envoi, lors d'un rappel ou sous la forme d'un rejet permanent signalé ultérieurement) ou `delivery_failed` (le canal assurant la livraison a définitivement échoué\_: un canal réseau a refusé le message ou a épuisé ses tentatives, un hôte d'identité `TRP` n'a pas répondu, ou l'hôte `TRP` de la contrepartie n'a pas accepté la demande). Sinon, la trace `discovery` la détermine\_: `awaiting_end_user` (aucune étape n'a désigné de contrepartie que Didit peut joindre), `directory_match_no_route` (une étape a désigné un VASP de l'annuaire qui ne dispose d'aucun routage), `picked_member_without_proven_wallet` (l'utilisateur final a choisi un client Didit qui n'a pas prouvé le contrôle du portefeuille) ou `no_directory_match` lorsque la trace ne donne aucune autre raison. Un nouvel envoi fait progresser le transfert, ce qui efface le motif. Voir [Pourquoi un transfert est bloqué](/fr/transaction-monitoring/travel-rule#pourquoi-un-transfert-est-bloqué)." next_actions: type: array description: >- Ce qui permet de faire avancer le transfert ; `[]` pour tout statut autre que `COUNTERPARTY_VASP_NOT_FOUND` ou `COUNTERPARTY_VASP_NOT_REACHABLE`. `email_undeliverable` propose `update_compliance_email`, puis `resend`. `delivery_failed` propose `resend`. Un motif lié à la découverte propose `select_counterparty_vasp`, `declare_self_hosted`, `add_vasp_hint` et `resend`. items: $ref: '#/components/schemas/TravelRuleNextAction' chain_details: $ref: '#/components/schemas/TravelRuleChainDetails' TravelRuleDataMatch: type: object nullable: true description: >- Comparaison champ par champ des données des parties au transfert avec ce que l'autre partie sait du détenteur du portefeuille. Elle nomme les champs et les résultats, jamais les valeurs, afin de rester lisible pendant que les données de la contrepartie sont masquées. Null jusqu'à ce qu'une comparaison ait été exécutée. properties: matched: type: boolean description: Vrai lorsqu'aucun champ comparé ne diffère. mismatched_fields: type: array items: type: string enum: - name - date_of_birth - address - account description: Les champs qui diffèrent. fields: type: object description: >- Une entrée par champ comparé pour le type d'entité de la partie (`name`, `date_of_birth`, `address`, `account` ; une entreprise n'a pas de `date_of_birth`). additionalProperties: type: object properties: result: type: string enum: - matched - mismatched - not_compared description: >- `not_compared` lorsque la règle est `NONE` ou que l'un des deux côtés ne comporte aucune valeur pour le champ. strictness: type: string enum: - NONE - STRICT - CONTAINS - DEFAULT - FUZZY TravelRuleDataUnmasked: type: object nullable: true description: >- Enregistrement d'audit du moment où les données de la contrepartie ont été démasquées. Null tant que les données sont encore masquées, ainsi que pour les transferts sortants. 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: >- Ce qui a confirmé la propriété : ownership_confirmed (votre confirmation via la console ou l'API), wallet_proof (une preuve de portefeuille dans le widget, ou un transfert entrant INTERNAL, défini lors de sa création), address_book_match (un portefeuille vérifié du carnet d'adresses), own_verified_wallet (le portefeuille vérifié propre à votre utilisateur), inquiry_approved (votre approbation d'une demande TRP entrante ou d'un message GTR ou Sygna), known_payment_method (un portefeuille avec lequel votre utilisateur a déjà payé) ou travel_address (la Travel Address par portefeuille qui a nommé le portefeuille). actor: type: string description: >- Qui l'a confirmé : l'e-mail de l'utilisateur de la console ou le libellé de la clé API. Laissé vide pour une décision automatique. TravelRuleDelivery: type: object description: >- État d'acheminement du dernier message que le transfert doit à l'autre partie. Didit contacte la contrepartie après le retour de la requête ayant créé ou modifié le transfert ; cet objet indique donc si ce message a abouti : en file d'attente, en cours d'envoi, en attente de nouvelle tentative après une erreur, livré ou échoué. Une défaillance dont le réseau peut encore se remettre (absence de réponse dans les délais, échec de connexion, HTTP `408`, `429` ou `5xx`) fait l'objet d'une nouvelle tentative après 30 secondes, 2 minutes, 10 minutes, 30 minutes et 1 heure. Lorsqu'un premier message (`kind: SEND`) échoue définitivement, parce que le réseau l'a refusé ou que la sixième tentative a également échoué, le transfert passe à `COUNTERPARTY_VASP_NOT_REACHABLE` avec `last_error` dans sa `timeline` ; tout autre message échouant définitivement est consigné dans la `timeline`. Le `status` du transfert demeure la source de vérité pour l'échange lui-même. required: - kind - status - rail - attempts - last_error - next_attempt_at - delivered_at properties: kind: type: string enum: - SEND - ANSWER - TXID - CANCEL - POLL description: >- Ce que transporte le message. `SEND` : le premier message du transfert destiné à la contrepartie (sortant ; le réseau est choisi lors de son envoi). `ANSWER` : votre acceptation ou votre refus, dû au réseau qui en a fait la demande (entrant). `TXID` : le hash de transaction on-chain, une fois que vous avez terminé le transfert. `CANCEL` : l'annulation, une fois que vous l'avez annulé. `POLL` : une requête de statut adressée à un réseau qui en propose une, répétée toutes les 5 minutes pendant que le transfert est en attente de la contrepartie. status: type: string enum: - QUEUED - SENDING - RETRYING - DELIVERED - FAILED description: >- `QUEUED` : en attente d'envoi. `SENDING` : une tentative est en cours. `RETRYING` : une tentative a échoué et la suivante s'exécutera à `next_attempt_at`. `DELIVERED` : l'autre partie a reçu le message. `FAILED` : l'autre partie l'a refusé, ou la dernière tentative a échoué. rail: type: string enum: - INTERNAL - TRP - GTR - TRUST - VERIFYVASP - SYGNA - EMAIL - '' description: >- Le canal qui achemine le message. Vide jusqu'à ce que Didit en ait choisi un pour un premier message. attempts: type: integer minimum: 0 description: >- Tentatives effectuées jusqu'à présent pour ce message. Un message qui n'est pas un sondage d'état fait l'objet de 6 tentatives au maximum. last_error: type: string description: >- Le type d'échec rencontré lors de la dernière tentative, `""` lorsqu'il n'y en a eu aucun : par exemple `email undeliverable`, `trp identity endpoint unreachable` ou `trp transfer inquiry delivery failed`. Il ne contient jamais la propre réponse de la contrepartie, qui reste sur la `timeline` du transfert. Lorsque GTR répond par une erreur, son propre code d'état et son message sont inclus. Les corps de réponse ne sont jamais inclus. example: email undeliverable next_attempt_at: type: string format: date-time nullable: true description: >- Moment où la prochaine tentative s'exécute lorsque le message est `QUEUED` ou `RETRYING`. delivered_at: type: string format: date-time nullable: true description: Moment où l'autre partie a pris en charge le message. TravelRuleDiscoveryStep: type: object description: >- Une étape de la découverte de contrepartie exécutée par Didit pour un transfert sortant, dans l'ordre où elles ont été exécutées. La première étape qui désigne un VASP disposant d'une route met fin à la chaîne. properties: step: type: string enum: - internal_address_book - wallet_attribution - network_lookup - customer_hint - end_user description: >- `internal_address_book` : un autre client Didit ayant prouvé le contrôle du portefeuille de destination. `wallet_attribution` : l'attribution d'analyse blockchain du portefeuille. `network_lookup` : un réseau capable d'indiquer quel VASP détient l'adresse. `customer_hint` : le nom du VASP, le LEI ou la juridiction que vous avez indiqués dans `beneficiary_data`. `end_user` : la contrepartie choisie par l'utilisateur final (ou par vous), ou la demande d'en sélectionner une. outcome: type: string enum: - match - miss - skipped description: >- `match` : l'étape a identifié une contrepartie. `miss` : elle s'est exécutée et n'en a trouvé aucune. `skipped` : elle n'a pas pu s'exécuter, et `reason` en indique la raison. reason: type: string description: >- Raison lisible par machine, `""` en cas de correspondance : `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` ou `picked_member_without_proven_wallet`. vasp: type: string format: uuid nullable: true description: >- Le VASP de l'annuaire désigné par l'étape, lorsqu'elle en a désigné un. rail: type: string nullable: true description: >- Le canal qui permet d'atteindre cette contrepartie, lorsque l'étape en a trouvé un. at: type: string format: date-time TravelRuleNextAction: type: object description: >- Un élément permettant de faire avancer un transfert au statut `COUNTERPARTY_VASP_NOT_FOUND` ou `COUNTERPARTY_VASP_NOT_REACHABLE`. Consultez [Pourquoi un transfert est bloqué](/fr/transaction-monitoring/travel-rule#pourquoi-un-transfert-est-bloqué). properties: action: type: string enum: - select_counterparty_vasp - declare_self_hosted - add_vasp_hint - update_compliance_email - resend description: >- `select_counterparty_vasp` : l'utilisateur final choisit le VASP de destination dans le widget de possession de portefeuille, ou vous effectuez un PATCH avec `action=beneficiary_vasp`. `declare_self_hosted` : l'utilisateur final déclare le portefeuille comme auto-hébergé dans le widget. `add_vasp_hint` : indiquez à Didit qui est la contrepartie, avec un nom de VASP, un LEI ou une Travel Address (par exemple une `travel_address` sur l'entrée du carnet d'adresses du portefeuille de destination), puis renvoyez. `update_compliance_email` et `resend` sont des valeurs de `action` pour `PATCH /v3/transactions/{transaction_id}/travel-rule/` : fournissez à nouveau l'e-mail de conformité de la contrepartie, et relancez le routage. url: type: string format: uri description: >- Le lien du widget de propriété du portefeuille, pour `select_counterparty_vasp` et `declare_self_hosted` tant que le transfert a une session de widget ouverte. required: - action TravelRuleChainDetails: type: object description: >- Manière dont la blockchain du transfert nomme ses deux portefeuilles, lorsque plus d'une adresse en paie une autre. Vide (`{}`) pour un transfert sur une blockchain basée sur des comptes (EVM, Solana, Tron), où les deux adresses sont les portefeuilles. La correspondance, le routage et le carnet d'adresses lisent d'abord les portefeuilles ici. properties: chain: type: string description: >- Blockchain canonique, par ex. `BTC`, `XRP`, ou `LIGHTNING` pour un transfert Lightning. shape: type: string enum: - utxo - memo - lightning originator: $ref: '#/components/schemas/TravelRuleChainSide' beneficiary: $ref: '#/components/schemas/TravelRuleChainSide' utxo: type: object description: >- Sur un transfert UTXO : les entrées et sorties telles qu'enregistrées (montants sous forme de chaînes décimales) et la manière dont Didit a interprété chaque sortie. 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: Sorties qui remboursent une adresse d'entrée. beneficiary_output_index: type: integer nullable: true description: "La sortie qui paie le bénéficiaire\_; null lorsqu'aucune n'a pu être distinguée." lightning: type: object description: >- Sur un transfert Lightning : ce qu'indique la demande de paiement. Toujours `kind` (`bolt11`, `bolt12_offer`, `bolt12_invoice`, `bolt12_invoice_request`, `lnurl`, `lightning_address`, `node_id` ou `unknown`) ; une facture BOLT11 ajoute `network`, `payee_node_id`, `payment_hash`, `amount_msat`, `created_at` et `expires_at` ; une chaîne BOLT12 ajoute `blinded_paths` et `payee_node_id` ; un LNURL ou une adresse Lightning ajoute son `domain`. Rien n'est résolu sur le réseau : la requête est uniquement décodée. 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: >- Incohérences UTXO nécessitant une vérification : le donneur d'ordre déclaré n'est pas une entrée, le bénéficiaire déclaré n'est pas une sortie, aucune sortie de bénéficiaire unique n'a pu être distinguée, ou la sortie du bénéficiaire paie un montant différent de celui indiqué par la transaction. not_applicable_reason: type: string enum: - LIGHTNING_NO_PAYEE_IDENTIFIER - LIGHTNING_BOLT12_BLINDED_PAYEE - LIGHTNING_LNURL_NAMES_NO_PAYEE description: >- Sur un transfert Lightning sortant dont la demande de paiement ne mentionne aucun bénéficiaire : pourquoi le transfert est `NOT_APPLICABLE`. `LIGHTNING_NO_PAYEE_IDENTIFIER` (la demande ne mentionne aucun nœud bénéficiaire ou n'a pas pu être décodée), `LIGHTNING_BOLT12_BLINDED_PAYEE` (l'offre dissimule son bénéficiaire derrière des chemins aveugles), `LIGHTNING_LNURL_NAMES_NO_PAYEE` (un LNURL désigne un service, pas un bénéficiaire). Le même code ouvre la dernière entrée de la `timeline` du transfert. TravelRuleChainSide: type: object description: >- Le portefeuille de l'une des parties, tel que Didit l'a résolu à partir des données de la blockchain. properties: address: type: string description: >- Le portefeuille. Sur un réseau à mémo, l'adresse classique (une X-address XRP est divisée en son adresse classique et son tag) ; sur Lightning, l'identifiant du nœud du bénéficiaire ou la Lightning Address. memo: type: string description: >- Le tag de destination ou mémo faisant partie du portefeuille ; `""` en l'absence de mémo. source: type: string enum: - declared - x_address - largest_input - only_non_change_output - amount_match - invoice_payee - updated description: >- Origine du portefeuille : `declared` (votre requête), `x_address` (dérivée d'une adresse X XRP), `largest_input` (l'adresse d'entrée UTXO ayant le plus contribué), `only_non_change_output` (la seule sortie UTXO qui n'est pas de la monnaie rendue), `amount_match` (l'unique sortie UTXO payant le montant du transfert), `invoice_payee` (le bénéficiaire désigné par une demande de paiement Lightning), `updated` (défini ultérieurement avec `action: update_originator_wallet`). TravelRuleUtxoEntry: type: object description: >- Une entrée ou une sortie d'une transaction UTXO, telle qu'enregistrée par la blockchain. required: - address properties: address: type: string maxLength: 128 amount: type: string nullable: true description: >- Chaîne décimale dans l'unité propre à la crypto-monnaie (BTC, et non en satoshis). Facultatif. example: '0.0125' txid: type: string maxLength: 128 description: Facultatif. La transaction dépensée par une entrée. vout: type: integer nullable: true minimum: 0 description: Facultatif. L'index de sortie dépensé par une entrée. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.