Saltar al contingut principal
POST
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
wallet_address
string

L'adreça de la cartera que s'ha de verificar. Opcional; quan està buida, s'ha de proporcionar l'adreça quan s'inicia una prova.

Maximum string length: 128
chain
string

Token de la blockchain per a l'adreça, per exemple ETH, BTC o SOL. Utilitza el mateix token que a la teva llibreta d'adreces de carteres. La signatura de missatges i la prova de Satoshi només s'ofereixen per a blockchains compatibles. L'entrada de la llibreta d'adreces que la prova verifica l'emmagatzema sota el seu identificador canònic (ETH, BTC, SOL, TRX).

Maximum string length: 32
holder_name
string

Nom del titular de la cartera, utilitzat per a la coincidència del nom del beneficiari.

Maximum string length: 255
vendor_data
string

El teu identificador intern per al titular, traslladat a l'entrada de la llibreta d'adreces creada.

Maximum string length: 255
transaction_id
string<uuid> | null

Opcional. UUID de transacció de Didit d'una transferència de Travel Rule que s'ha de fer avançar quan la prova es verifiqui.

satoshi_deposit_address
string

Opcional. Una adreça de dipòsit que controles; proporcionar-la habilita el mètode de prova SATOSHI_TEST.

Maximum string length: 128
callback_url
string

Opcional. URL http(s) absoluta a la qual el giny redirigeix el client després de completar el procés.

Maximum string length: 512
expires_in_minutes
integer
predeterminat:60

Opcional. Temps de vida de l'enllaç generat, en minuts. S'amplia automàticament per cobrir la finestra de la prova de Satoshi quan s'ofereix SATOSHI_TEST.

Rang requerit: 5 <= x <= 10080

Resposta

La sessió del widget emesa.

widget_session_id
string<uuid>
token
string

Token de sessió opac inserit a la URL del widget.

url
string

L'URL del giny allotjat de titularitat de la cartera. Obre'l literalment al navegador del sistema (mai dins d'un webview de l'SDK mòbil).

expires_at
string<date-time>
Darrera modificació el 7 de novembre del 2026