Saltar al contingut principal
PUT
curl

Autoritzacions

x-api-key
string
header
requerit

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.

Cos

application/json

Tots els camps són opcionals; PUT aplica una actualització parcial.

is_enabled
boolean
Maximum string length: 255
lei
string
Maximum string length: 20
jurisdiction
string
Maximum string length: 8
name_matching_strictness
enum<string>

CONTAINS accepta un nom les paraules del qual apareixen totes en l'altre.

Opcions disponibles:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer
Rang requerit: x >= 1
timeout_outcome
enum<string>
Opcions disponibles:
HOLD,
REJECT,
PROCEED
compliance_email
string<email>

Correu electrònic de contacte de compliment per al teu perfil de VASP. La xarxa de Didit només llista el teu perfil un cop confirmada aquesta adreça mitjançant un enllaç enviat per correu electrònic (POST /v3/travel-rule/settings/compliance-email/confirmation/); modificar-la requereix una nova confirmació.

is_discoverable
boolean

Indica si el teu perfil de VASP es pot llistar a la xarxa de Didit: que altres clients de Didit poden trobar mitjançant GET /v3/travel-rule/vasps/ i accessible pel canal INTERNAL. Per a poder-lo llistar també cal una aplicació en producció, Travel Rule activat, una raó social i un correu electrònic de compliment confirmat; didit_network indica quins falten. Per defecte és true.

threshold_amount
string

Cadena decimal, zero o superior, en la moneda predeterminada de la teva aplicació. Import mínim de la transferència que activa un intercanvi gestionat.

ownership_validation_mode
enum<string>

Consulta el camp de la resposta amb el mateix nom.

Opcions disponibles:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

Cadena decimal, 0 o més.

data_sharing_fields
object

Es fusiona per tipus d'entitat: un tipus d'entitat que ometis manté la seva opció actual. Una opció que no pugui complir les obligacions de l'ordenant del teu règim de jurisdiction (EU TFR o FATF Recommendation 16), una llista buida inclosa, es rebutja amb 400.

matching_rules
object

Es fusiona per tipus d'entitat i per camp dins d'aquest. Un camp que aquest tipus d'entitat no compara (per exemple, date_of_birth per a company) es rebutja amb 400.

inbound_auto_accept
boolean
allow_self_declaration
boolean
allow_screenshot_proof
boolean

Quan és cert, el widget de titularitat de la cartera ofereix la càrrega de captures de pantalla com a mètode de prova de titularitat. Per defecte cert.

auto_wallet_verification
boolean
vasp_attribution_enabled
boolean
counterparty_screening_enabled
boolean

Cribratge opcional de sancions i mitjans adversos de VASP de les contraparts, facturat per cribratge al preu de Cribratge AML d'empreses. Quan està activat, Didit fa el cribratge de la contrapart a la qual arriba un intercanvi de sortida (reutilitzant un cribratge de menys de 30 dies) i pots fer-ne el cribratge d'una amb POST /v3/travel-rule/vasps/{vasp_id}/screening/. Per defecte false: no es fa cap cribratge ni es factura res.

sunrise_policy
enum<string>

HOLD, REJECT, PROCEED, o buit per seguir timeout_outcome. Consulta el camp de resposta amb el mateix nom.

Opcions disponibles:
,
HOLD,
REJECT,
PROCEED
non_responsive_policy
enum<string>

HOLD, REJECT, PROCEED, o buit per seguir timeout_outcome. Consulta el camp de resposta amb el mateix nom.

Opcions disponibles:
,
HOLD,
REJECT,
PROCEED
disabled_networks
enum<string>[]

Xarxes que han desactivat la pertinença a la plataforma. No inhabilita les teves pertinences pròpies connectades ni aprovisiona xarxes no disponibles.

Opcions disponibles:
GTR,
TRUST,
VERIFYVASP,
SYGNA

Resposta

Configuració i perfil actualitzats, amb la mateixa estructura que GET.

is_enabled
boolean

Indica si el flux gestionat de negociació de Travel Rule està actiu per a transaccions travelRule sortints en aquesta aplicació.

jurisdiction
string

El codi de jurisdicció operativa del teu VASP. Per defecte "EU". Didit l'assigna al règim que estampa a les teves transaccions de Travel Rule com a travel_rule_regime (per exemple, EU o el codi d'un estat membre de la UE es converteix en eu), sobre el qual es poden basar les regles de transacció. Altres clients de Didit el veuen com la teva jurisdicció al directori de VASP un cop la xarxa de Didit llista el teu perfil.

Maximum string length: 8
name_matching_strictness
enum<string>

Amb quin grau d'estrictesa han de coincidir els noms dels beneficiaris abans que una transferència pugui arribar a l'estat COMPLETED. CONTAINS accepta un nom les paraules del qual apareguin totes en l'altre.

Opcions disponibles:
NONE,
STRICT,
CONTAINS,
DEFAULT,
FUZZY
confirmation_timeout_hours
integer

Hores que una transferència AWAITING_COUNTERPARTY pot romandre sense confirmar abans que el procés de neteja periòdic la faci caducar. Per defecte, 48.

Rang requerit: x >= 1
timeout_outcome
enum<string>

Què passa amb la transacció subjacent quan caduca una transferència. Per defecte HOLD. sunrise_policy i non_responsive_policy tenen prioritat quan s'apliquen i estan configurades.

Opcions disponibles:
HOLD,
REJECT,
PROCEED
threshold_amount
string

Cadena decimal, en la moneda predeterminada de la teva aplicació. Import mínim de transferència que activa un intercanvi gestionat; les transferències per sota d'aquest es resolen directament com a NOT_APPLICABLE. Didit compara l'import de la transacció convertit a la teva moneda predeterminada, o el camp amount_in_default_currency que enviïs; quan no hi ha cap import convertit disponible, el llindar no s'aplica. El valor per defecte és "0.00" (el TFR de la UE no aplica cap import mínim).

ownership_validation_mode
enum<string>

Quanta prova requereix la titularitat d'una cartera. FULL requereix sempre una prova (missatge signat, dipòsit de prova o captura de pantalla revisada), mai la paraula de l'usuari final. SIMPLIFIED accepta una autodeclaració per sota de simplified_validation_threshold i una prova per sobre d'aquest llindar. AUTOMATED permet que la llibreta d'adreces i les proves anteriors responguin per si soles, incloses les autodeclaracions mentre allow_self_declaration sigui cert. Per defecte AUTOMATED.

Opcions disponibles:
FULL,
SIMPLIFIED,
AUTOMATED
simplified_validation_threshold
string

Cadena decimal, per defecte "0.00". En mode SIMPLIFIED, una transferència per sota d'aquest import (en la moneda del llindar) accepta una autodeclaració. Una transferència sense cap import en aquesta moneda es compta com a superior.

data_sharing_fields
object

Els camps que Didit envia al VASP de la contrapart sobre els teus propis usuaris, per tipus d'entitat. El name i la wallet_address s'envien sempre, digui el que digui la llista. Un tipus d'entitat que mai no hagis triat comparteix tots els camps. Una llista buida també és una opció: només comparteix el nom i la cartera.

matching_rules
object

Amb quin grau d'estrictesa es compara cada camp de les dades de la contrapart amb el que tens registrat, per tipus d'entitat. Un camp que ometis manté el seu valor per defecte. NONE omet la comparació, STRICT requereix exactament les mateixes paraules, CONTAINS accepta un valor les paraules del qual apareguin totes en l'altre, DEFAULT és la coincidència estàndard de subconjunt, i FUZZY accepta grafies properes (i, per a dates de naixement, dia i mes invertits).

La raó social del teu VASP. Obligatòria (no pot estar en blanc) per establir is_enabled a true.

lei
string

El teu identificador d'entitat jurídica, mostrat al directori de VASP.

compliance_email
string<email>

Correu electrònic de contacte de compliment per al teu perfil de VASP. La xarxa de Didit només llista el teu perfil un cop confirmada aquesta adreça mitjançant un enllaç enviat per correu electrònic (POST /v3/travel-rule/settings/compliance-email/confirmation/); modificar-la requereix una nova confirmació.

is_discoverable
boolean

Indica si el teu perfil de VASP es pot llistar a la xarxa de Didit: que altres clients de Didit poden trobar mitjançant GET /v3/travel-rule/vasps/ i accessible pel canal INTERNAL. Per a poder-lo llistar també cal una aplicació en producció, Travel Rule activat, una raó social i un correu electrònic de compliment confirmat; didit_network indica quins falten. Per defecte és true.

inbound_auto_accept
boolean

Quan és cert, una consulta TRP d'entrada la cartera beneficiària de la qual és una entrada verificada de la llibreta d'adreces amb un nom coincident s'aprova automàticament. Quan és fals, aquesta consulta s'espera en ON_HOLD que l'aprovis o la deneguis amb l'endpoint de titularitat. Les transferències de rail INTERNAL i posteriors al dipòsit no es veuen afectades. Per defecte cert.

allow_self_declaration
boolean

Quan és cert, el widget de titularitat de la cartera ofereix l'autodeclaració com a mètode de prova alternatiu. Per defecte cert.

allow_screenshot_proof
boolean

Quan és cert, el widget de titularitat de la cartera ofereix la càrrega de captures de pantalla com a mètode de prova de titularitat. Per defecte cert.

auto_wallet_verification
boolean

Quan és cert, enviar una transferència de sortida de la Travel Rule que requereix una prova de control de la cartera per part de l'usuari final crea automàticament una sessió del widget de titularitat de la cartera vinculada a la transacció i l'exposa al bloc action_required de la transacció. Per defecte cert.

vasp_attribution_enabled
boolean

Quan és cert, una transferència de sortida de la Travel Rule que cap rail pot encaminar s'atribueix mitjançant analítica de blockchain: la cartera de destinació es resol al seu VASP propietari, l'entitat es registra a la transferència i al directori de VASP, i els rails es tornen a executar una vegada amb el nom atribuït. Per defecte cert.

counterparty_screening_enabled
boolean

Cribratge opcional de sancions i mitjans adversos de VASP de les contraparts, facturat per cribratge al preu de Cribratge AML d'empreses. Quan està activat, Didit fa el cribratge de la contrapart a la qual arriba un intercanvi de sortida (reutilitzant un cribratge de menys de 30 dies) i pots fer-ne el cribratge d'una amb POST /v3/travel-rule/vasps/{vasp_id}/screening/. Per defecte false: no es fa cap cribratge ni es factura res.

sunrise_policy
enum<string>

Què fa una transferència caducada sobre la seva transacció quan la contrapart és una entrada del directori en una jurisdicció de sunrise_jurisdictions, que encara no aplica la Travel Rule: HOLD la passa a revisió, REJECT la rebutja, PROCEED deixa el seu estat intacte. En blanc (per defecte) segueix timeout_outcome. S'aplica abans de non_responsive_policy.

Opcions disponibles:
,
HOLD,
REJECT,
PROCEED
sunrise_jurisdictions
string[]
read-only

Només de lectura. Els països (ISO 3166 alpha-2) que Didit considera en període d'entrada en vigor de la Travel Rule, on s'aplica sunrise_policy. Actualment CO, KH i VN. Qualsevol altra jurisdicció, així com una de buida o desconeguda, segueix timeout_outcome.

non_responsive_policy
enum<string>

Què fa una transferència caducada sobre la seva transacció quan la contrapart és una entrada del directori la capacitat de resposta de la qual és UNRESPONSIVE: HOLD, REJECT o PROCEED, igual que per a timeout_outcome. En blanc (per defecte) segueix timeout_outcome. sunrise_policy s'aplica primer quan es compleixen totes dues condicions.

Opcions disponibles:
,
HOLD,
REJECT,
PROCEED
travel_address
string

Només de lectura. La Travel Address pròpia del teu VASP: l'endpoint de consultes TRP entrants codificat que altres VASP utilitzen per contactar amb tu. Buit mentre is_enabled sigui false.

disabled_networks
enum<string>[]

Xarxes que han desactivat la pertinença a la plataforma. No inhabilita les teves pertinences pròpies connectades ni aprovisiona xarxes no disponibles.

Opcions disponibles:
GTR,
TRUST,
VERIFYVASP,
SYGNA
networks
object
read-only

Per xarxa, com enviaria aquesta aplicació i per què no pot fer-ho. Cap xarxa, inclosa GTR, s'inclou per defecte: es pot accedir a una xarxa mitjançant la teva pròpia pertinença connectada, o mitjançant la pertinença de Didit un cop la pertinença de Didit a aquesta xarxa estigui activa i el teu propi participant hi estigui actiu. No és una comprovació d'estat o de lliurament en directe.

didit_network
object
read-only

Indica si la xarxa de Didit llista el teu perfil de VASP, de manera que altres clients de Didit el trobin al directori i hi puguin contactar a través de la via INTERNAL, així com cadascuna de les condicions que encara no compleix.

Darrera modificació el 7 de novembre del 2026