Erste Schritte
Integrieren / SDKs
Benutzerverifizierung
Unternehmensverifizierung
Transaktionsüberwachung
Changelogcurl -X POST https://verification.didit.me/v3/kyb/ubo/ \
-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.list_ubos(
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.listUbos({
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.ListUBOs(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().listUbos(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->listUbos([
'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.list_ubos(
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.ListUbosAsync(new KYBRegistryCandidateRequest
{
KybResponseId = "69aeeb95febb0f1704042259",
VendorData = "company-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));KYB-Register-UBO-API: wirtschaftlich Berechtigte
Rufen Sie mit Didit POST /v3/kyb/ubo/ und einer kyb_response_id aus der Registersuche Firmenprofil, Gesellschafter und UBOs ab.
curl -X POST https://verification.didit.me/v3/kyb/ubo/ \
-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.list_ubos(
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.listUbos({
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.ListUBOs(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().listUbos(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->listUbos([
'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.list_ubos(
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.ListUbosAsync(new KYBRegistryCandidateRequest
{
KybResponseId = "69aeeb95febb0f1704042259",
VendorData = "company-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));POST /v3/kyb/search/ Kandidatenunternehmen zurückgegeben hat und Sie die letztlich wirtschaftlich Berechtigten benötigen: die Gesellschafter sowie die natürlichen Personen und übergeordneten Unternehmen, die über die Eigentumskette ermittelt werden (registry_data.ubo_resolution).
Die Abrechnung erfolgt zum UBO-Preis des Landes (Preise pro Land). Geliefert wird die höchste Stufe, die das Land und das Register bereitstellen können. registry_tier_delivered gibt an, was abgerechnet wurde: shareholders, wenn der Bericht keine natürliche Person als wirtschaftlich Berechtigte nennt, basic, wenn überhaupt kein Eigentumsdatensatz vorliegt (dann ist registry_ownership_status unavailable), oder not_held, wenn die Quelle der Eigentümerstruktur geantwortet hat, dass sie keine Daten zu diesem Unternehmen führt (Eigentumsstatus).
Solange der Bericht noch erstellt wird oder der Abschnitt zur Eigentümerstruktur noch nicht aus dem Register abgerufen wurde, gibt der Endpoint 202 Accepted, kyb_registry.fetch_status: "pending", kyb_registry.registry_ownership_status: "pending" und registry_tier_delivered: null zurück.
Bewahren Sie die zurückgegebene request_id auf und rufen Sie GET /v3/session/{request_id}/decision/ ab, bis registry_checks[0].company.fetch_status den Wert resolved hat.
Didit vervollständigt den ausstehenden Bericht automatisch und berechnet die gelieferte Stufe, sobald er fertig ist.
Senden Sie die Anfrage nicht erneut, solange sie aussteht: Jeder neue POST erstellt eine eigene Anfrage.
Nur in v3 verfügbar. POST /v2/kyb/select/ und POST /v3/kyb/select/ behalten ihren Vertrag und ihren Preis bei.Autorisierungen
Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.
Body
Kandidaten-Handle aus POST /v3/kyb/search/ (kyb_registry.companies[].kyb_response_id). Flüchtig: Verwenden Sie es kurz nach der Suche, die es erzeugt hat. Handles können lang sein; speichern und senden Sie den Wert daher genau so, wie er zurückgegeben wurde, ohne ihn zu kürzen oder eine bestimmte Länge anzunehmen.
1024"69aeeb95febb0f1704042259"
Ihre Kennung für dieses Unternehmen; wird zurückgegeben und mit der Unternehmenssitzung gespeichert.
Freiform-JSON, das mit der Unternehmenssitzung gespeichert und zurückgegeben wird.
Muss true sein (Standardwert). Auswahlen aus dem KYB-Register werden immer dauerhaft gespeichert, damit Abrechnung und Abruf nachverfolgt werden können; false gibt 400 zurück.
Antwort
Unternehmensbericht zurückgegeben und zur gelieferten Stufe abgerechnet. Eigentümerstruktur-Berichte, die noch vorbereitet werden, können 202 zurückgeben; behalten Sie request_id, um deren gespeicherte Entscheidung abzurufen.
ID der Unternehmenssitzung, die für diesen Abruf erstellt wurde. Der gespeicherte Datensatz (in der Konsole sichtbar) wird weiter aktualisiert, falls das Register die Abfrage erst nach der Antwort auflöst.
Die Stufe, die dieser Endpoint bereitstellt: basic (Lite) für ausgewählte, shareholders, ubo.
basic, shareholders, ubo Die tatsächlich gelieferte und abgerechnete Stufe. Niedriger als angefordert, wenn die Register des Landes keine Eigentümerdaten enthalten, wenn das Register keinen Eigentümereintrag für dieses Unternehmen führt oder wenn der aufgelöste Bericht einer ubo-Anfrage keine natürliche Person als wirtschaftlich Berechtigten nennt.
basic, shareholders, ubo, null Vollständiges Unternehmensprofil aus dem Register.
Show child attributes
Show child attributes
Wiedergabe der von Ihnen gesendeten vendor_data.
Rückgabe der von Ihnen gesendeten metadata.