Inizia
Integrazione / SDK
Verifica degli utenti
Verifica aziendale
Monitoraggio delle transazioni
Changelogcurl -X POST https://verification.didit.me/v3/kyb/select/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"kyb_response_id": "69aeeb95febb0f1704042259",
"vendor_data": "company-1234"
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.kyb.select(
kyb_response_id="69aeeb95febb0f1704042259",
vendor_data="company-1234",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.kyb.select({
kyb_response_id: "69aeeb95febb0f1704042259",
vendor_data: "company-1234",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.KYB.Select(ctx, didit.KYBRegistryCandidateRequest{
KYBResponseID: "69aeeb95febb0f1704042259",
VendorData: didit.String("company-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.KYBRegistryCandidateRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.kyb().select(KYBRegistryCandidateRequest.builder()
.kybResponseId("69aeeb95febb0f1704042259")
.vendorData("company-1234")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->kyb->select([
'kyb_response_id' => '69aeeb95febb0f1704042259',
'vendor_data' => 'company-1234',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.kyb.select(
kyb_response_id: "69aeeb95febb0f1704042259",
vendor_data: "company-1234"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Kyb.SelectAsync(new KYBRegistryCandidateRequest
{
KybResponseId = "69aeeb95febb0f1704042259",
VendorData = "company-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));API Select Registro KYB: Recupera il Profilo Aziendale
Usa POST /v3/kyb/select/ con un kyb_response_id della ricerca nel registro per recuperare il profilo aziendale completo di Didit.
curl -X POST https://verification.didit.me/v3/kyb/select/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"kyb_response_id": "69aeeb95febb0f1704042259",
"vendor_data": "company-1234"
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.kyb.select(
kyb_response_id="69aeeb95febb0f1704042259",
vendor_data="company-1234",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.kyb.select({
kyb_response_id: "69aeeb95febb0f1704042259",
vendor_data: "company-1234",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.KYB.Select(ctx, didit.KYBRegistryCandidateRequest{
KYBResponseID: "69aeeb95febb0f1704042259",
VendorData: didit.String("company-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.KYBRegistryCandidateRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.kyb().select(KYBRegistryCandidateRequest.builder()
.kybResponseId("69aeeb95febb0f1704042259")
.vendorData("company-1234")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->kyb->select([
'kyb_response_id' => '69aeeb95febb0f1704042259',
'vendor_data' => 'company-1234',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.kyb.select(
kyb_response_id: "69aeeb95febb0f1704042259",
vendor_data: "company-1234"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Kyb.SelectAsync(new KYBRegistryCandidateRequest
{
KybResponseId = "69aeeb95febb0f1704042259",
VendorData = "company-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));POST /v3/kyb/search/ restituisce le aziende candidate.
Select è il livello Lite: recupera il profilo dell’azienda e i suoi dirigenti, con addebito al prezzo Lite del paese (prezzi per paese). Salva la richiesta come Manual Check nella Business Console e restituisce un request_id che puoi usare per recuperare il risultato di verifica aziendale salvato. Per gli azionisti o i titolari effettivi usa POST /v3/kyb/shareholders/ o POST /v3/kyb/ubo/.
Didit attende che il registro di origine completi la richiesta prima di rispondere, quindi fetch_status è resolved nella maggior parte delle risposte. Se un registro lento mantiene il profilo in attesa oltre questo tempo, la risposta restituisce fetch_status: pending con data_resolved: false, e Didit completa automaticamente la verifica salvata non appena il provider termina l’elaborazione. Rileggi il risultato di verifica salvato invece di ripetere la ricerca, perché una nuova ricerca genera nuovi valori kyb_response_id.Autorizzazioni
La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.
Corpo
Handle del candidato da POST /v3/kyb/search/ (kyb_registry.companies[].kyb_response_id). Effimero: usalo poco dopo la ricerca che lo ha generato. Gli handle possono essere lunghi, quindi memorizza e invia il valore esattamente come restituito, senza troncarlo o presumere una lunghezza.
1024"69aeeb95febb0f1704042259"
Il tuo identificatore per questa azienda; restituito nella risposta e memorizzato con la sessione aziendale.
JSON a struttura libera memorizzato con la sessione aziendale e restituito nella risposta.
Deve essere true (valore predefinito). Le selezioni dal registro KYB vengono sempre salvate per consentire il tracciamento della fatturazione e del recupero; false restituisce 400.
Risposta
Azienda recuperata e fatturata. kyb_registry include il profilo completo; verifica data_resolved — se false, il registro delle imprese era ancora in fase di elaborazione e il record salvato si completa automaticamente una volta risolto.
ID della sessione aziendale creata per questo recupero. Il record memorizzato (visibile nella console) continua ad aggiornarsi se la ricerca nel registro viene completata dopo la risposta.
Il livello venduto da questo endpoint: basic (Lite) per select, shareholders, ubo.
basic, shareholders, ubo Il livello effettivamente fornito e fatturato. Inferiore a quello richiesto quando i registri del paese non contengono dati sull'assetto proprietario, oppure il registro non ha record sull'assetto proprietario per questa azienda.
basic, shareholders, ubo Profilo aziendale completo del registro delle imprese.
Show child attributes
Show child attributes
Eco del vendor_data inviato.
Eco del metadata inviato.