Saltar al contingut principal
GET
curl

Disponibilitat de xarxes

GTR, TRUST, VerifyVASP i Sygna requereixen una membresia activa. Avui Didit no té cap membresia de plataforma en cap d’aquestes xarxes; Didit s’està incorporant com a proveïdor. Fins llavors, un canal de xarxa només encamina a través de la teva pròpia membresia, connectada a Marketplace. Llegeix networks per a l’aplicació que configures:
  • own - La teva membresia connectada té prioritat, fins i tot si la xarxa és a disabled_networks. Els intercanvis utilitzen la teva identitat de xarxa.
  • didit - La membresia de Didit fa que la teva aplicació sigui el seu propi participant actiu en aquesta xarxa, amb el codi que la xarxa t’ha assignat. Per a aquesta xarxa no calen credencials de membresia de client. Per arribar-hi cal el qüestionari de xarxa de Didit i una sol·licitud a la xarxa: consulta Obtenir les xarxes de Travel Rule. Producció encara no informa d’aquest mode, perquè la membresia pròpia de Didit no està activa.
  • off - Has desactivat l’encaminament de la plataforma i no tens cap membresia pròpia connectada. Elimina la xarxa de disabled_networks per permetre l’encaminament de la plataforma quan estigui disponible, o connecta la teva pròpia membresia.
  • unavailable - Ara mateix res no pot enviar en aquesta xarxa per a la teva aplicació. state i reason indiquen el motiu: per exemple didit_onboarding mentre la membresia pròpia de Didit a la xarxa no estigui activa, o questionnaire_needed abans que s’aprovi el teu qüestionari. Avui totes les xarxes informen d’aquest mode, tret que hagis connectat la teva pròpia membresia o hagis desactivat la xarxa. Connecta la teva pròpia membresia a Marketplace, o utilitza una contrapart INTERNAL, TRP o EMAIL accessible.
disabled_networks només afecta la membresia de plataforma de Didit, que encara no està disponible, de manera que avui no té cap efecte en l’encaminament. S’escull un canal de xarxa quan beneficiary_data de la transferència porta l’identificador de la contrapart en aquella xarxa (per exemple counterparty_gtr_vasp_code o counterparty_trust_membership_id), o quan l’entrada del directori de la contrapart la llista amb un codi d’aquella xarxa. Sobre GTR, VerifyVASP i Sygna, Didit llegeix la resposta de la contrapart a partir de la resposta de la xarxa o consultant la xarxa cada 5 minuts, i la transferència passa a COMPLETED, COUNTERPARTY_MISMATCHED_DATA o COUNTERPARTY_VASP_GENERAL_DECLINE. TRUST només permet l’enviament: una transferència enviada per aquest canal es queda a AWAITING_COUNTERPARTY fins que transcorri el període indicat per confirmation_timeout_hours i passi a EXPIRED, i aleshores s’aplica timeout_outcome. Si el missatge no es pot lliurar, la transferència passa a COUNTERPARTY_VASP_NOT_REACHABLE. Consulta Xarxes de Travel Rule per saber què abasta cada xarxa avui. platform_available és un estat de configuració, no una comprovació en directe de l’estat de la xarxa. connected indica que una membresia desada ha superat la validació local de credencials, no que l’intercanvi amb el proveïdor hagi funcionat. Activar is_enabled o buidar disabled_networks no pot aprovisionar una membresia que falti. Per a les comprovacions que pots fer sense credencials de xarxa, consulta Proves sense credencials de xarxa.

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.

Resposta

200 - application/json

Configuració actual de Travel Rule i perfil de VASP.

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