Primers passos
Integració / SDK
Verificació d'usuaris
Verificació d'empreses
Monitoratge de transaccions
Registre de canvisINTERNAL entre dos clients de Didit, el protocol obert Travel Rule (TRP) i EMAIL. Les quatre vies de xarxa (GTR, TRUST, VERIFYVASP, SYGNA) necessiten una membresia d’aquella xarxa al costat emissor.
Aquesta pàgina explica què fa cadascuna avui, perquè sàpigues on pots arribar a les teves contraparts abans de dependre d’una ruta.
Estat en resum
«Funciona» vol dir que Didit envia l’intercanvi i llegeix la resposta. «Implementada, encara no demostrada en producció» vol dir que Didit envia l’intercanvi i llegeix la resposta de la xarxa, però encara no s’ha completat cap intercanvi per aquesta xarxa contra una xarxa en producció. Cap de les dues no vol dir mai que una contrapart concreta sigui accessible: això depèn de la contrapart, i les
routes de cada VASP al directori indiquen quines vies pot usar avui la teva aplicació per a ella.
EMAIL només transporta les teves sol·licituds de sortida: la pàgina de resposta és on una contrapart contesta una d’elles, i cap VASP no pot enviar-te una transferència per correu electrònic.
Abans de confiar en GTR, VerifyVASP, Sygna Bridge o TRUST, connecta la teva membresia i fes un primer intercanvi amb una contrapart que coneguis.
Vies que no requereixen membresia
INTERNAL
Tots dos VASP funcionen a Didit, de manera que l’intercanvi es liquida dins la plataforma sense cap crida de sortida. El destinatari ha de ser un client actiu de Didit amb la Travel Rule activada, que hagi demostrat el control de la cartera de destinació amb un missatge signat o un dipòsit de prova. Una cartera autodeclarada, només amb captura de pantalla o no verificada no rep res. Consulta Enviament d’una transferència.TRP
Didit parla el protocol Travel Rule de forma nativa. Una transferència va perTRP quan porta la Travel Address de la contrapart, quan l’entrada de la llibreta d’adreces de la cartera de destinació n’emmagatzema una, o quan la contrapart es resol al directori amb un endpoint TRP que el directori ha verificat.
Tot intercanvi TRP que no acabi en una sola crida necessita l’host públic TRP de Didit, al qual apunten les Travel Address:
- Enviament. Una contrapart que respon de seguida a la teva consulta completa o rebutja la transferència en la seva resposta. Una contrapart que respon més tard publica la seva resposta a l’host TRP de Didit, de manera que aquest intercanvi no es pot completar fins que l’host estigui actiu; la transferència espera i caduca en la seva data límit. Didit envia la consulta una sola vegada i no la reintenta: quan l’host TRP de la contrapart no és accessible o rebutja la consulta, la transferència passa de seguida a
COUNTERPARTY_VASP_NOT_REACHABLE, i pots reintentar-la ambaction: "resend". - Recepció. Els altres VASP arriben a tu a través de la teva Travel Address en aquest host, de manera que cap contrapart no et pot enviar una consulta TRP fins que estigui activat.
Vies de xarxa
Amb la teva pròpia membresia
Connecta la teva pròpia membresia a Marketplace de la consola (categoria de xarxes Travel Rule). Les teves transferències viatjaran llavors amb la teva pròpia identitat de xarxa, i una membresia connectada sempre té prioritat sobre la de Didit.
GTR, TRUST i VerifyVASP també accepten un certificat de client TLS mutu, una clau de client i un paquet de CA (PEM), per a una membresia que utilitzi TLS mutu o una CA privada.
- Didit envia en segon pla i torna a intentar-ho quan una xarxa no respon, o respon amb un error temporal (sense resposta a temps, una connexió fallida, HTTP
408,429o5xx): després de 30 segons, després de 2, 10, 30 i 60 minuts. Després del sisè intent fallit, la transferència passa aCOUNTERPARTY_VASP_NOT_REACHABLE. Un rebuig, com una altra resposta4xxo una redirecció, no es torna a intentar: la transferència passa aCOUNTERPARTY_VASP_NOT_REACHABLEimmediatament. - Una transferència de la qual mai no arriba la resposta espera a
AWAITING_COUNTERPARTYfins que passen lesconfirmation_timeout_hours, i després caduca i s’aplica el teutimeout_outcome. - Rebre una transferència que un altre VASP t’envia per GTR, VerifyVASP o Sygna Bridge encara no està activat: Didit l’activa per xarxa, i fins llavors aquestes xarxes no poden lliurar-te una transferència.
- Desar una membresia retorna
400quan el seu codi de participant és el codi propi de Didit en aquesta xarxa, o un codi que ja té una altra aplicació. - Les sol·licituds a la xarxa porten les teves credencials només a l’host propi d’aquesta xarxa i mai no segueixen una redirecció. El paquet de dades de TRUST arriba al beneficiari sense la teva clau d’API, el teu ID de membre ni el teu certificat de client.
Mitjançant la membresia de Didit
Un cop Didit té una membresia de xarxa, un client sense membresia pot accedir a la xarxa com a participant propi amb la membresia de Didit, amb el codi de participant que li assigna la xarxa: els missatges de sortida indiquen el teu codi, mai el de Didit. Això només s’ofereix per a GTR i Sygna Bridge. TRUST admet un VASP cada vegada i un Enclave de VerifyVASP serveix un sol VASP, de manera que a totes dues només s’hi accedeix amb la teva pròpia membresia. Unir-se requereix tres passos: respondre el qüestionari de diligència deguda de la xarxa de Didit, obtenir-ne l’aprovació de Didit i sol·licitar la xarxa. Didit et registra a la xarxa, i el teu participant passa a estar actiu quan la xarxa li assigna un codi. Aquest flux encara no està obert. Mentre no ho estigui, desar o enviar el qüestionari i sol·licitar una xarxa responen403 amb code: travel_rule_platform_networks_disabled, i GET /v3/travel-rule/networks/ informa de platform_networks_enabled: false.
Llegir l’estat de l’aplicació
GET /v3/travel-rule/settings/ i GET /v3/travel-rule/networks/ retornen networks, indexat per gtr, trust, verifyvasp i sygna. Cada entrada indica què pot fer la xarxa per a la teva aplicació avui:
mode resumeix l’estat com a own, didit, off o unavailable. Primer es comprova la teva pròpia membresia, després disabled_networks i finalment la membresia de Didit. Avui, una xarxa mostra own_membership quan connectes la teva pròpia membresia. En cas contrari, GTR i Sygna Bridge mostren didit_onboarding (unavailable amb sandbox_application en una aplicació de sandbox), i TRUST i VerifyVASP mostren unavailable amb own_membership_only, també en sandbox.
Una aplicació de sandbox mai envia per una xarxa, ni tan sols amb la teva pròpia membresia connectada i amb own_membership com a estat: les seves transferències van a la Didit Test VASP.
connected vol dir que la teva membresia desada ha superat la validació local, no que un intercanvi hagi reeixit. El primer intercanvi en producció ho verifica amb la xarxa.
Què canvia quan una xarxa entra en producció
Aquesta pàgina, l’estat denetworks i totes les rutes del directori canvien juntes. No canvia res en la teva integració: una transferència comença a encaminar-se per la xarxa tan bon punt la teva aplicació hi tingui una membresia, seguint l’ordre de vies descrit a Com encamina Didit un intercanvi.
Per sol·licitar una xarxa que Didit encara no assoleix, fes servir el seu bloc Sol·licitar accés al Marketplace. Cada sol·licitud mostra el seu estat (Oberta, Contactada, En curs, En producció o Rebutjada) amb la darrera nota de Didit. Quan Didit canvia l’estat o la nota, envia un correu electrònic al membre de l’equip que va fer la sol·licitud, mentre segueixi a la teva organització. Una sol·licitud feta amb una clau d’API no rep cap correu, així que segueix-la al Marketplace.
Passos següents
Travel Rule
El cicle de vida de l’intercanvi, la configuració, les vies i l’API /v3/.
Prova al sandbox
Prova cada resultat amb la Didit Test VASP abans de passar a producció.
Interoperabilitat
Els endpoints que fan servir les VASP contrapart per arribar a tu.
Directori
Troba una VASP i les rutes que la teva aplicació pot fer servir per a ella.