from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.update_kyb_party_draft(
"33333333-4444-5555-6666-777777777777",
"5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d",
ownership_percent=55.0,
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.updateKybPartyDraft(
"33333333-4444-5555-6666-777777777777",
"5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d",
{
ownership_percent: 55.0,
},
);
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.UpdateKYBPartyDraft(ctx, "33333333-4444-5555-6666-777777777777", "5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d", didit.SessionsUpdateKYBPartyDraftParams{
OwnershipPercent: didit.Float(55.0),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.SessionsUpdateKybPartyDraftParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().updateKybPartyDraft("33333333-4444-5555-6666-777777777777", "5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d", SessionsUpdateKybPartyDraftParams.builder()
.ownershipPercent(55.0)
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->updateKybPartyDraft('33333333-4444-5555-6666-777777777777', '5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d', [
'ownership_percent' => 55.0,
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.update_kyb_party_draft(
"33333333-4444-5555-6666-777777777777",
"5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d",
ownership_percent: 55.0
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Sessions.UpdateKybPartyDraftAsync("33333333-4444-5555-6666-777777777777", "5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d", new SessionsUpdateKybPartyDraftParams
{
OwnershipPercent = 55.0,
});
Console.WriteLine(JsonSerializer.Serialize(result));curl --request PATCH \
--url https://verification.didit.me/v3/session/{sessionId}/kyb/parties/drafts/{draftId}/ \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"ownership_percent": 55
}
'{
"draft_id": "5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d",
"created_at": "2026-10-31T10:00:00Z",
"updated_at": "2026-10-31T10:00:00Z",
"party": {
"entity_type": "person",
"first_name": "Ana",
"last_name": "Lopez",
"roles": [
"ubo",
"director"
],
"ownership_percent": 55,
"nationality": "MEX",
"email": "ana.lopez@example.com",
"date_of_birth": "1984-06-12"
}
}Editar rascunho de pessoa-chave KYB API
Altere os campos de um rascunho de pessoa-chave de uma sessão KYB na Didit; a pessoa combinada é validada no seu conjunto.
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.update_kyb_party_draft(
"33333333-4444-5555-6666-777777777777",
"5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d",
ownership_percent=55.0,
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.updateKybPartyDraft(
"33333333-4444-5555-6666-777777777777",
"5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d",
{
ownership_percent: 55.0,
},
);
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.UpdateKYBPartyDraft(ctx, "33333333-4444-5555-6666-777777777777", "5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d", didit.SessionsUpdateKYBPartyDraftParams{
OwnershipPercent: didit.Float(55.0),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.SessionsUpdateKybPartyDraftParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().updateKybPartyDraft("33333333-4444-5555-6666-777777777777", "5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d", SessionsUpdateKybPartyDraftParams.builder()
.ownershipPercent(55.0)
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->updateKybPartyDraft('33333333-4444-5555-6666-777777777777', '5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d', [
'ownership_percent' => 55.0,
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.update_kyb_party_draft(
"33333333-4444-5555-6666-777777777777",
"5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d",
ownership_percent: 55.0
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Sessions.UpdateKybPartyDraftAsync("33333333-4444-5555-6666-777777777777", "5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d", new SessionsUpdateKybPartyDraftParams
{
OwnershipPercent = 55.0,
});
Console.WriteLine(JsonSerializer.Serialize(result));curl --request PATCH \
--url https://verification.didit.me/v3/session/{sessionId}/kyb/parties/drafts/{draftId}/ \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"ownership_percent": 55
}
'{
"draft_id": "5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d",
"created_at": "2026-10-31T10:00:00Z",
"updated_at": "2026-10-31T10:00:00Z",
"party": {
"entity_type": "person",
"first_name": "Ana",
"last_name": "Lopez",
"roles": [
"ubo",
"director"
],
"ownership_percent": 55,
"nationality": "MEX",
"email": "ana.lopez@example.com",
"date_of_birth": "1984-06-12"
}
}Autorizações
A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.
Parâmetros de caminho
UUID da sessão de Verificação de empresas (KYB). Tem de pertencer à aplicação da chave de API.
"33333333-4444-5555-6666-777777777777"
UUID do rascunho de parte (draft_id retornado quando foi criado).
"5b0d7a52-9d3e-4f0c-8c6a-0e5f3a1b2c4d"
Parâmetros de consulta
Nó do fluxo do passo de KYB. Apenas necessário quando o fluxo tem mais de um nó de KYB; por predefinição, a Didit utiliza o nó próprio da sessão.
Corpo
Qualquer subconjunto dos campos da parte. A edição é fundida com o rascunho guardado e a parte resultante é validada na totalidade, pelo que um rascunho que podia ser submetido antes de uma edição continua a poder ser submetido depois dela.
Se a parte é uma pessoa singular ou uma empresa.
person, company Nome completo de uma pessoa. Envie este campo, ou first_name e last_name.
255128128Função desempenhada pela parte. Intercambiável com roles; quando ambas forem enviadas, são combinadas.
director, non_executive_director, secretary, chairman, ubo, shareholder, representative, founder, legal_advisor, authorized_signatory, trustee, beneficiary, settlor, protector, company_officer, investor, other Cada função que a parte desempenha. Uma pessoa necessita de pelo menos uma função (aqui ou em role).
director, non_executive_director, secretary, chairman, ubo, shareholder, representative, founder, legal_advisor, authorized_signatory, trustee, beneficiary, settlor, protector, company_officer, investor, other Cargo de uma pessoa.
128Nome de uma parte da empresa. Obrigatório quando entity_type é company.
255Número de registo de uma entidade empresarial.
100Para onde a ligação de verificação é enviada. Obrigatório quando a parte tem de concluir a verificação, o que depende das definições de funções e dos limiares de propriedade do fluxo.
Percentagem da empresa que a parte detém.
Nacionalidade de uma pessoa ou país de constituição de uma empresa. Obrigatório para todas as partes.
10032Campos adicionais definidos pelo fluxo.
Pedir para ignorar a verificação desta parte. Respeitado apenas quando a função da parte permite ignorar nas definições de Pessoas-chave do fluxo.