Erste Schritte
Integrieren / SDKs
Benutzerverifizierung
Unternehmensverifizierung
Transaktionsüberwachung
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));Unternehmensprofil abrufen: KYB Registry Select API
Vollständiges, kostenpflichtiges KYB-Unternehmensprofil bei Didit abrufen: POST /v3/kyb/select/ mit kyb_response_id aus der Registersuche.
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/ infrage kommende Unternehmen zurückgegeben hat.
Select ist die Lite-Stufe: Es ruft das Unternehmensprofil und dessen Organmitglieder ab und wird zum Lite-Preis des jeweiligen Landes abgerechnet (Preise pro Land). Die Anfrage wird als Manual Check in der Business Console gespeichert, und es wird eine request_id zurückgegeben, mit der Sie das gespeicherte Ergebnis der Unternehmensverifizierung abrufen können. Für die Gesellschafter oder die wirtschaftlich Berechtigten verwenden Sie POST /v3/kyb/shareholders/ oder POST /v3/kyb/ubo/.
Didit wartet, bis das Unternehmensregister die Abfrage abgeschlossen hat, bevor es antwortet. Daher hat fetch_status in den meisten Antworten den Wert resolved. Wenn ein langsames Register das Profil länger als diese Wartezeit im Status pending hält, gibt die Antwort fetch_status: pending mit data_resolved: false zurück. Didit schließt die gespeicherte Prüfung dann automatisch ab, sobald der Anbieter fertig ist. Lesen Sie das gespeicherte Verifizierungsergebnis erneut aus, statt die Suche zu wiederholen, da eine neue Suche neue kyb_response_id-Werte ausgibt.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
Unternehmen abgerufen und abgerechnet. kyb_registry enthält das vollständige Profil; prüfen Sie data_resolved – wenn false, verarbeitete das Unternehmensregister die Anfrage noch und der gespeicherte Datensatz wird automatisch vervollständigt, sobald er aufgelöst ist.
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 oder das Register keinen Eigentümereintrag für dieses Unternehmen führt.
basic, shareholders, ubo 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.