Mulai
Integrasi / SDK
Verifikasi Pengguna
Verifikasi Bisnis
Pemantauan Transaksi
Log PerubahancURL
curl -X POST 'https://verification.didit.me/v3/workflows/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"workflow_label": "Standard KYC",
"features": [
{"feature": "OCR"},
{"feature": "LIVENESS", "config": {"face_liveness_method": "passive"}},
{"feature": "FACE_MATCH", "config": {"face_match_score_decline_threshold": 40, "face_match_score_review_threshold": 60}}
]
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.workflows.create(
workflow_label="Standard KYC",
features=[{
"feature": "OCR",
"config": {"duplicated_user_action": "review"},
}, {
"feature": "LIVENESS",
"config": {"face_liveness_method": "passive"},
}, {
"feature": "FACE_MATCH",
"config": {"face_match_score_decline_threshold": 40, "face_match_score_review_threshold": 60},
}],
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.workflows.create({
workflow_label: "Standard KYC",
features: [{
feature: "OCR",
config: { duplicated_user_action: "review" },
}, {
feature: "LIVENESS",
config: { face_liveness_method: "passive" },
}, {
feature: "FACE_MATCH",
config: { face_match_score_decline_threshold: 40, face_match_score_review_threshold: 60 },
}],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Workflows.Create(ctx, didit.SimpleWorkflowRequest{
WorkflowLabel: didit.String("Standard KYC"),
Features: []didit.SimpleWorkflowFeature{{
Feature: "OCR",
Config: didit.Some(map[string]any{"duplicated_user_action": "review"}),
}, {
Feature: "LIVENESS",
Config: didit.Some(map[string]any{"face_liveness_method": "passive"}),
}, {
Feature: "FACE_MATCH",
Config: didit.Some(map[string]any{"face_match_score_decline_threshold": 40, "face_match_score_review_threshold": 60}),
}},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import java.util.Map;
import me.didit.Didit;
import me.didit.types.SimpleWorkflowFeature;
import me.didit.types.SimpleWorkflowRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.workflows().create(SimpleWorkflowRequest.builder()
.workflowLabel("Standard KYC")
.features(List.of(
SimpleWorkflowFeature.builder()
.feature(SimpleWorkflowFeature.Feature.of("OCR"))
.config(Map.of("duplicated_user_action", "review"))
.build(),
SimpleWorkflowFeature.builder()
.feature(SimpleWorkflowFeature.Feature.of("LIVENESS"))
.config(Map.of("face_liveness_method", "passive"))
.build(),
SimpleWorkflowFeature.builder()
.feature(SimpleWorkflowFeature.Feature.of("FACE_MATCH"))
.config(Map.of("face_match_score_decline_threshold", 40, "face_match_score_review_threshold", 60))
.build()))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->workflows->create([
'workflow_label' => 'Standard KYC',
'features' => [[
'feature' => 'OCR',
'config' => ['duplicated_user_action' => 'review'],
], [
'feature' => 'LIVENESS',
'config' => ['face_liveness_method' => 'passive'],
], [
'feature' => 'FACE_MATCH',
'config' => ['face_match_score_decline_threshold' => 40, 'face_match_score_review_threshold' => 60],
]],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.workflows.create(
workflow_label: "Standard KYC",
features: [{
feature: "OCR",
config: { duplicated_user_action: "review" },
}, {
feature: "LIVENESS",
config: { face_liveness_method: "passive" },
}, {
feature: "FACE_MATCH",
config: { face_match_score_decline_threshold: 40, face_match_score_review_threshold: 60 },
}]
)
puts result.to_husing System;
using System.Collections.Generic;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Workflows.CreateAsync(new SimpleWorkflowRequest
{
WorkflowLabel = "Standard KYC",
Features = new SimpleWorkflowFeature[]
{
new()
{
Feature = "OCR",
Config = new Dictionary<string, object> { ["duplicated_user_action"] = "review" },
},
new()
{
Feature = "LIVENESS",
Config = new Dictionary<string, object> { ["face_liveness_method"] = "passive" },
},
new()
{
Feature = "FACE_MATCH",
Config = new Dictionary<string, object> { ["face_match_score_decline_threshold"] = 40, ["face_match_score_review_threshold"] = 60 },
},
},
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "c3d4e5f6-7890-12cd-ef34-333333333333",
"workflow_id": "c3d4e5f6-7890-12cd-ef34-333333333333",
"workflow_label": "Standard KYC",
"workflow_type": null,
"is_default": false,
"is_archived": false,
"total_price": 0.15,
"min_price": 0.15,
"max_price": 0.15,
"features": "OCR + LIVENESS + FACE_MATCH",
"is_simple_workflow": false,
"is_editable": false,
"workflow_url": "https://verify.didit.me/u/w9TkPOx8RWG3UAz5ZRQGVQ",
"workflow_graph": {
"start_node": "ocr",
"nodes": "... one node per feature plus a final status node ..."
},
"max_retry_attempts": 3,
"retry_window_days": 7,
"session_expiration_time": 604800,
"version": 1,
"status": "published",
"published_at": "2026-05-17T10:30:00Z",
"created_at": "2026-05-17T10:30:00Z",
"updated_at": "2026-05-17T10:30:00Z"
}
Alur Kerja
API Membuat Workflow: Bangun Alur Verifikasi KYC
Buat workflow verifikasi Didit lewat API. KYC, KYB, AML, dan biometrik dalam satu alur berurutan. Bayar per panggilan, tanpa kontrak.
POST
/
v3
/
workflows
/
cURL
curl -X POST 'https://verification.didit.me/v3/workflows/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"workflow_label": "Standard KYC",
"features": [
{"feature": "OCR"},
{"feature": "LIVENESS", "config": {"face_liveness_method": "passive"}},
{"feature": "FACE_MATCH", "config": {"face_match_score_decline_threshold": 40, "face_match_score_review_threshold": 60}}
]
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.workflows.create(
workflow_label="Standard KYC",
features=[{
"feature": "OCR",
"config": {"duplicated_user_action": "review"},
}, {
"feature": "LIVENESS",
"config": {"face_liveness_method": "passive"},
}, {
"feature": "FACE_MATCH",
"config": {"face_match_score_decline_threshold": 40, "face_match_score_review_threshold": 60},
}],
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.workflows.create({
workflow_label: "Standard KYC",
features: [{
feature: "OCR",
config: { duplicated_user_action: "review" },
}, {
feature: "LIVENESS",
config: { face_liveness_method: "passive" },
}, {
feature: "FACE_MATCH",
config: { face_match_score_decline_threshold: 40, face_match_score_review_threshold: 60 },
}],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Workflows.Create(ctx, didit.SimpleWorkflowRequest{
WorkflowLabel: didit.String("Standard KYC"),
Features: []didit.SimpleWorkflowFeature{{
Feature: "OCR",
Config: didit.Some(map[string]any{"duplicated_user_action": "review"}),
}, {
Feature: "LIVENESS",
Config: didit.Some(map[string]any{"face_liveness_method": "passive"}),
}, {
Feature: "FACE_MATCH",
Config: didit.Some(map[string]any{"face_match_score_decline_threshold": 40, "face_match_score_review_threshold": 60}),
}},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import java.util.Map;
import me.didit.Didit;
import me.didit.types.SimpleWorkflowFeature;
import me.didit.types.SimpleWorkflowRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.workflows().create(SimpleWorkflowRequest.builder()
.workflowLabel("Standard KYC")
.features(List.of(
SimpleWorkflowFeature.builder()
.feature(SimpleWorkflowFeature.Feature.of("OCR"))
.config(Map.of("duplicated_user_action", "review"))
.build(),
SimpleWorkflowFeature.builder()
.feature(SimpleWorkflowFeature.Feature.of("LIVENESS"))
.config(Map.of("face_liveness_method", "passive"))
.build(),
SimpleWorkflowFeature.builder()
.feature(SimpleWorkflowFeature.Feature.of("FACE_MATCH"))
.config(Map.of("face_match_score_decline_threshold", 40, "face_match_score_review_threshold", 60))
.build()))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->workflows->create([
'workflow_label' => 'Standard KYC',
'features' => [[
'feature' => 'OCR',
'config' => ['duplicated_user_action' => 'review'],
], [
'feature' => 'LIVENESS',
'config' => ['face_liveness_method' => 'passive'],
], [
'feature' => 'FACE_MATCH',
'config' => ['face_match_score_decline_threshold' => 40, 'face_match_score_review_threshold' => 60],
]],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.workflows.create(
workflow_label: "Standard KYC",
features: [{
feature: "OCR",
config: { duplicated_user_action: "review" },
}, {
feature: "LIVENESS",
config: { face_liveness_method: "passive" },
}, {
feature: "FACE_MATCH",
config: { face_match_score_decline_threshold: 40, face_match_score_review_threshold: 60 },
}]
)
puts result.to_husing System;
using System.Collections.Generic;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Workflows.CreateAsync(new SimpleWorkflowRequest
{
WorkflowLabel = "Standard KYC",
Features = new SimpleWorkflowFeature[]
{
new()
{
Feature = "OCR",
Config = new Dictionary<string, object> { ["duplicated_user_action"] = "review" },
},
new()
{
Feature = "LIVENESS",
Config = new Dictionary<string, object> { ["face_liveness_method"] = "passive" },
},
new()
{
Feature = "FACE_MATCH",
Config = new Dictionary<string, object> { ["face_match_score_decline_threshold"] = 40, ["face_match_score_review_threshold"] = 60 },
},
},
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "c3d4e5f6-7890-12cd-ef34-333333333333",
"workflow_id": "c3d4e5f6-7890-12cd-ef34-333333333333",
"workflow_label": "Standard KYC",
"workflow_type": null,
"is_default": false,
"is_archived": false,
"total_price": 0.15,
"min_price": 0.15,
"max_price": 0.15,
"features": "OCR + LIVENESS + FACE_MATCH",
"is_simple_workflow": false,
"is_editable": false,
"workflow_url": "https://verify.didit.me/u/w9TkPOx8RWG3UAz5ZRQGVQ",
"workflow_graph": {
"start_node": "ocr",
"nodes": "... one node per feature plus a final status node ..."
},
"max_retry_attempts": 3,
"retry_window_days": 7,
"session_expiration_time": 604800,
"version": 1,
"status": "published",
"published_at": "2026-05-17T10:30:00Z",
"created_at": "2026-05-17T10:30:00Z",
"updated_at": "2026-05-17T10:30:00Z"
}
Gunakan endpoint ini untuk membuat alur kerja melalui API tanpa perlu membangun node graf alur kerja sendiri. Kirim array
Urutan fitur itu penting. Misalnya, tempatkan
Objek
Graf ini menggunakan
Untuk menyatakan “NFC tidak dilakukan karena alasan apa pun yang diketahui”, gunakan
Setiap kolom yang dikonfigurasi menjadi nilai yang dapat dicabangkan
Graf yang tidak valid mengembalikan
Node akhir menggunakan
features sesuai urutan pengguna harus menyelesaikan pemeriksaan tersebut. Didit mengubahnya menjadi alur kerja berbasis node secara internal dan menambahkan langkah status akhir secara otomatis.
Endpoint POST /v3/workflows/ ini hanya membuat alur kerja sederhana dan linear, yaitu daftar features yang datar. Untuk percabangan, perutean kondisional, Document AI, serta node keputusan dan penolakan, gunakan format graf yang dijelaskan di bawah. Format ini digunakan oleh pembangun visual di konsol dan alat alur kerja Didit MCP.
Lihat Konfigurasi Fitur Alur Kerja untuk setiap kolom config yang diterima oleh setiap fitur.
Alur kerja KYC dasar
{
"workflow_label": "Standard KYC",
"features": [
{
"feature": "OCR",
"config": {
"documents_allowed": {
"USA": {
"DL": {
"enabled": 1,
"sides": 2
}
}
},
"duplicated_user_action": "REVIEW"
}
},
{
"feature": "LIVENESS",
"config": {
"face_liveness_method": "PASSIVE"
}
},
{
"feature": "FACE_MATCH"
}
]
}
Alur kerja kuesioner
Pertama, buat kuesioner denganPOST /v3/questionnaires/. Kemudian gunakan questionnaire_id yang dikembalikan sebagai questionnaire_uuid.
{
"workflow_label": "Source of Funds",
"features": [
{
"feature": "QUESTIONNAIRE",
"config": {
"questionnaire_uuid": "11111111-2222-3333-4444-555555555555",
"review_questionnaire_manually": true
}
}
]
}
OCR sebelum FACE_MATCH, NFC, DATABASE_VALIDATION, atau pemeriksaan AML pengguna yang bergantung pada data dokumen.
Referensi konfigurasi fitur
Setiap itemfeatures[] memiliki bentuk berikut:
{
"feature": "OCR",
"label": "ID Verification",
"config": {}
}
config yang tepat bergantung pada fiturnya. Tinjau daftar kolom lengkap, nilai default, pengaturan wajib, rentang nilai, dan contoh di Konfigurasi Fitur Alur Kerja.
Untuk OCR, hilangkan config.documents_allowed, kirim null, atau kirim {} untuk mengizinkan semua jenis dokumen yang didukung. Sertakan kolom ini hanya jika Anda ingin membatasi alur kerja ke negara atau jenis dokumen tertentu. Untuk QUESTIONNAIRE, config.questionnaire_uuid wajib diisi.
Pengaturan alur kerja opsional
Anda dapat menyertakan kolom tingkat atas mana pun berikut saat membuat alur kerja untuk mengontrol perilaku sesi. Semua kolom ini bersifat opsional dan akan menggunakan nilai default alur kerja jika dihilangkan.| Kolom | Tipe | Deskripsi |
|---|---|---|
is_white_label_enabled | boolean | Aktifkan kustomisasi White Label untuk sesi yang dibuat dengan alur kerja ini. Default false. |
is_desktop_allowed | boolean | Izinkan alur verifikasi berjalan di browser desktop. Default false. |
max_retry_attempts | integer (0–10) | Jumlah maksimum percobaan ulang yang diizinkan setelah verifikasi ditolak. 0 memblokir pengguna setelah penolakan pertama. Default 3. |
retry_window_days | integer (1–365) atau null | Periode bergulir dalam hitungan hari yang digunakan untuk menghitung percobaan ulang (null = batas sepanjang waktu). Default 7. |
session_expiration_time | integer (3600–2419200) | Jumlah detik sebelum sesi yang belum selesai kedaluwarsa. Minimum 1 jam, maksimum 4 minggu. Default 604800 (7 hari). |
response_attributes | object atau null | Membatasi kolom yang dikembalikan untuk setiap fitur, misalnya {"id_verifications": ["full_name", "document_number"], "face_matches": null}. null atau kunci yang tidak disertakan akan mengembalikan semua kolom. Daftar kosong hanya mengembalikan status, warnings, node_id, is_nfc_skipped dan skip_reason, sedangkan kolom lainnya dikembalikan sebagai null. |
{
"workflow_label": "Standard KYC",
"is_white_label_enabled": true,
"is_desktop_allowed": true,
"max_retry_attempts": 5,
"retry_window_days": 14,
"session_expiration_time": 86400,
"features": [
{ "feature": "OCR" },
{ "feature": "LIVENESS" },
{ "feature": "FACE_MATCH" }
]
}
Percabangan & alur kerja berbasis node (graf)
Daftarfeatures yang linear tidak dapat menyatakan “jika X maka Y”. Untuk percabangan bersyarat (menolak berdasarkan status, mengarahkan berdasarkan kolom yang diekstrak, menahan langkah berdasarkan kecocokan), langkah permintaan Document AI, atau node akhir penolakan/keputusan, alur kerja Didit menggunakan graf node, yaitu struktur yang sama dengan yang dihasilkan pembangun visual di konsol.
Cara paling sederhana membuat alur kerja berbasis graf adalah melalui Didit MCP: minta agen dengan bahasa biasa (“setelah Verifikasi Identitas, jika profesi ≈ ‘Software Engineer’, tambahkan langkah bukti dana”), dan agen akan membangun, memvalidasi, serta menyimpan graf untuk Anda. Struktur di bawah ini adalah yang dihasilkan oleh alat-alat tersebut (dan konsol).
Bentuk graf
Graf berbentuk{ start_node, nodes }. nodes adalah peta dari id node ke node. Sisi bersifat implisit: setiap node menunjuk ke depan melalui next (tanpa syarat) dan/atau branches[].goto (bersyarat).
| Jenis node | Bentuk |
|---|---|
feature | { "node_type": "feature", "feature": "OCR", "config": {…}, "next": "<id>", "branches": [] } |
branch | { "node_type": "branch", "branches": [ { "id", "logic": "and"|"or", "rules": [<rule>], "goto": "<id>" } ], "next": "<fallback id>" } |
status (akhir) | { "node_type": "status", "session_status": "Approved"|"Declined"|"In Review"|"Determine" } |
action | { "node_type": "action", "actions": [ { "type": "add_tag"|"add_review"|… } ], "next": "<id>" } |
webhook | { "node_type": "webhook", "config": { "url", "method" }, "branches": [], "next": "<id>" } |
start_node harus berupa node fitur. Cabang dievaluasi secara berurutan, kecocokan pertama berlaku; rules: [] yang kosong adalah “else” penangkap semua (letakkan di urutan terakhir). session_status: "Determine" memutuskan secara otomatis dari gabungan hasil fitur.
Setiap node cabang wajib memiliki cabang else yang eksplisit: cabang dengan
rules: [] yang menangani sesi yang tidak cocok dengan kondisi mana pun. Jangan mengandalkan next pada node cabang sebagai cadangan. next yang berdiri sendiri ditampilkan sebagai edge yang ambigu di pembangun dan mudah terlewat. Saat Anda mengirim node cabang dengan next tetapi tanpa cabang else, API akan mengubah next tersebut menjadi cabang else eksplisit untuk Anda (sehingga { …, "branches": [<conditions>], "next": "liveness" } disimpan sebagai branches: [<conditions>, { "id": "else", "rules": [], "goto": "liveness" }]). Buat else sendiri agar eksplisit. Konversi tersebut hanyalah jaring pengaman, bukan pengganti.Aturan cabang & operator
Setiap aturan membandingkan kolom dengan nilai menggunakan operator:{ "field": "kyc.extra_fields.profession", "operator": "fuzzy_match", "value": "Software Engineer", "score": 80 }
- Kolom menyebutkan hasil fitur (
kyc.status,aml.status,document_ai.status,face_match.score, …) atau nilai yang diekstrak (kyc.full_name,kyc.age,kyc.nationality,kyc.extra_fields.profession, kolom Document AIdocument_ai.<key>,expected_details.*). Cabang hanya boleh membaca kolom yang fiturnya telah dijalankan pada setiap jalur yang menuju ke cabang tersebut. - Operator:
equals,not_equals,greater_than(_or_equals),less_than(_or_equals),contains,not_contains,in,not_in,is_empty,is_not_empty,regex, danfuzzy_match(hanya untuk kolom string; memerlukanscore0–100, yaitu ambang kemiripan, misalnya profesi ≥ 80% mirip dengan “Software Engineer”).
Cabang berdasarkan alasan NFC tidak dijalankan
Setelah nodeNFC, gunakan nfc.skip_reason dengan equals atau in untuk mengarahkan sesi berdasarkan alasan pembacaan chip tidak dilakukan. Kolom ini memiliki tujuh nilai tetap berikut:
USER_SKIPPEDDOCUMENT_WITHOUT_CHIPCHIP_CERTIFICATE_UNAVAILABLEDEVICE_WITHOUT_NFCINTEGRATION_WITHOUT_NFC_ACCESSMRZ_KEY_UNAVAILABLEJPKI_UNAVAILABLE
nfc.skip_reason bernilai null, sehingga aturan equals maupun in untuk alasan dilewati tidak akan cocok.
Kolom ini juga memiliki nilai untuk node NFC yang dilewati oleh gerbang. Ini mencakup kasus ketika tidak ada laporan atau peringatan NFC, dan kasus ketika allow_nfc_skip bernilai false tetapi gerbang dokumen atau perangkat mencegah NFC dijalankan. Dengan demikian, Anda dapat mengarahkan sesi-sesi ini tanpa bergantung pada entri nfc_verifications[].
Sesi yang disimpan sebelum kapabilitas NFC menjadi tiga status dapat memiliki
has_device_nfc_support: false. Sesi web lama karena itu dapat ditentukan sebagai DEVICE_WITHOUT_NFC, bukan INTEGRATION_WITHOUT_NFC_ACCESS.equals untuk NFC yang dilewati pengguna, in untuk NFC yang dilewati akibat gerbang atau kapabilitas, dan else eksplisit untuk NFC yang berhasil. Cabang berada setelah node NFC, dan setiap tujuan menunjuk ke depan ke node akhir:
{
"start_node": "ocr",
"nodes": {
"ocr": {
"node_type": "feature",
"feature": "OCR",
"next": "nfc"
},
"nfc": {
"node_type": "feature",
"feature": "NFC",
"config": { "allow_nfc_skip": false },
"next": "route_nfc"
},
"route_nfc": {
"node_type": "branch",
"branches": [
{
"id": "user_skipped",
"logic": "and",
"rules": [
{ "field": "nfc.skip_reason", "operator": "equals", "value": "USER_SKIPPED" }
],
"goto": "manual_review"
},
{
"id": "nfc_unavailable",
"logic": "and",
"rules": [
{
"field": "nfc.skip_reason",
"operator": "in",
"value": [
"DOCUMENT_WITHOUT_CHIP",
"CHIP_CERTIFICATE_UNAVAILABLE",
"DEVICE_WITHOUT_NFC",
"INTEGRATION_WITHOUT_NFC_ACCESS",
"MRZ_KEY_UNAVAILABLE",
"JPKI_UNAVAILABLE"
]
}
],
"goto": "manual_review"
},
{
"id": "else",
"logic": "and",
"rules": [],
"goto": "approved"
}
]
},
"manual_review": { "node_type": "status", "session_status": "In Review" },
"approved": { "node_type": "status", "session_status": "Approved" }
}
}
in dengan ketujuh nilai. Pertahankan cabang else eksplisit untuk NFC yang berhasil (nfc.skip_reason: null) serta nilai baru di masa depan yang belum dikenali oleh graf Anda.
Document AI (misalnya bukti dana)
Node fiturDOCUMENT_AI meminta satu atau beberapa dokumen dan mengekstrak kolom bernama:
{
"node_type": "feature",
"feature": "DOCUMENT_AI",
"label": "Proof of Funds",
"config": {
"document_ai_documents": [
{
"document_key": "proof_of_funds",
"title": "Proof of Funds",
"description": "Upload a recent bank statement.",
"fields": [
{
"key": "account_holder",
"name": "Account holder",
"instruction": "The full name of the account holder as printed on the statement.",
"type": "text",
"required": true,
"is_full_name": true
},
{
"key": "closing_balance",
"name": "Closing balance",
"instruction": "The closing balance amount.",
"type": "number",
"required": true
}
]
}
],
"document_ai_missing_required_fields_action": "REVIEW",
"document_ai_name_mismatch_action": "REVIEW"
},
"next": "final_decision"
}
document_ai.<key>, dan hasil langkah ini adalah document_ai.status.
Atur "is_full_name": true pada kolom yang memuat nama lengkap pemegang dokumen. Nilai yang diekstrak dibandingkan dengan nama lengkap identitas yang terverifikasi (nama dari OCR/verifikasi ID, atau detail yang diharapkan dari sesi), dan document_ai_name_mismatch_action menentukan apa yang terjadi jika ada ketidakcocokan di bawah document_ai_name_match_score_threshold. Penanda ini opsional: sebuah dokumen boleh tidak menandai kolom apa pun, dan paling banyak satu kolom per dokumen boleh mengaturnya. Lihat Konfigurasi fitur alur kerja → Document AI untuk setiap kolom konfigurasi Document AI.
Endpoint & siklus hidup draf
Pengeditan graf dilakukan per aplikasi dan menggunakan endpoint konsol/manajemen (Bearer pengguna +read:workflows/write:workflows). Graf hanya dapat diedit pada versi draf, sehingga siklus hidupnya adalah buat draf → atur graf → publikasikan:
| Metode | Path | Tujuan |
|---|---|---|
GET | …/verification-settings/{settings_uuid}/workflow-graph/ | Graf saat ini + status/is_editable |
POST | …/application/{app}/workflow-graph/validate/ (body { "graph": … }) | Validasi uji coba (dry-run) |
GET | …/application/{app}/workflow-graph/field-definitions/ | Kolom yang dapat dicabangkan + operator yang valid |
POST | …/verification-settings/{settings_uuid}/create-draft/ | Draf yang dapat diedit dari versi yang dipublikasikan |
PUT | …/verification-settings/{settings_uuid}/workflow-graph/ (body { "graph": … }) | Simpan graf |
PATCH | …/verification-settings/{settings_uuid}/ (body { "status": "published" }) | Publikasikan draf |
Peringatan validasi
Endpoint validate mengembalikan{ "is_valid": true, "graph": …, "warnings": [] }. Peringatan bersifat anjuran: graf tetap valid, dapat disimpan, dan dapat dipublikasikan meskipun ada peringatan. Setiap entri memuat node cabang dan jalur yang dimaksud, sehingga pembuat alur dapat menunjuk ke kondisi yang tepat:
{
"type": "branch_outcome_contradiction",
"node_id": "after_ocr",
"branch_id": "b1",
"severity": "warning",
"message": "Branch 1 only matches sessions where ID Verification Status is Approved or In Review, but every path from it ends in the session outcome \"Declined\". Check the condition or the outcome.",
"params": { "branchNumber": 1, "field": "ID Verification Status", "allowed": "Approved or In Review", "outcome": "Declined" }
}
type | Arti |
|---|---|
branch_outcome_contradiction | Kondisi jalur dan hasil yang dicapai setiap jalur dari situ saling bertentangan, misalnya kyc.status NOT EQUALS Declined diarahkan ke hasil Declined. Hasil tersebut bisa berada beberapa langkah lebih jauh di sepanjang jalur. |
branch_condition_unreachable | Jalur ini tidak pernah bisa cocok, karena setiap jalur yang menuju cabang ini sudah membatasi kolom status ke nilai-nilai yang dikecualikan oleh kondisi tersebut. |
else_branch_unreachable | Jalur else tidak pernah bisa dijalankan: jalur lain sudah mencakup setiap nilai yang dapat dimiliki kolom di sini. |
400 dengan daftar errors dan daftar warnings sebisanya. Hanya errors yang menghalangi penyimpanan.
Contoh: arahkan Software Engineers ke bukti dana
Setelah verifikasi identitas: jika hasilnya ditolak, tolak sesi; jika profesi pemegang ≈ “Software Engineer” (kemiripan minimal 80%), minta dokumen bukti dana; lalu buat keputusan akhir.
{
"start_node": "ocr_1",
"nodes": {
"ocr_1": { "node_type": "feature", "feature": "OCR", "label": "ID Verification", "next": "after_ocr" },
"after_ocr": {
"node_type": "branch",
"label": "Route after ID verification",
"branches": [
{ "id": "declined", "logic": "or", "rules": [ { "field": "kyc.status", "operator": "equals", "value": "Declined" } ], "goto": "decline" },
{ "id": "software_engineer", "logic": "and", "rules": [ { "field": "kyc.extra_fields.profession", "operator": "fuzzy_match", "value": "Software Engineer", "score": 80 } ], "goto": "proof_of_funds" },
{ "id": "else", "logic": "and", "rules": [], "goto": "final_decision" }
]
},
"proof_of_funds": {
"node_type": "feature",
"feature": "DOCUMENT_AI",
"label": "Proof of Funds",
"config": {
"document_ai_documents": [
{ "document_key": "proof_of_funds", "title": "Proof of Funds", "description": "Upload a recent bank statement.",
"fields": [
{ "key": "account_holder", "name": "Account holder", "type": "text", "required": true },
{ "key": "closing_balance", "name": "Closing balance", "type": "number", "required": true }
] }
],
"document_ai_missing_required_fields_action": "REVIEW"
},
"next": "final_decision"
},
"final_decision": { "node_type": "status", "session_status": "Determine", "label": "Final decision" },
"decline": { "node_type": "status", "session_status": "Declined", "label": "Declined" }
}
}
session_status: "Determine", yang memutuskan secara otomatis (disetujui / ditolak / dalam peninjauan) berdasarkan fitur yang benar-benar dijalankan pada sesi. Dengan begitu, jalur bukti dana maupun jalur else terselesaikan dengan benar, tanpa cabang mana pun yang membaca document_ai.status (kolom yang tidak ada pada jalur yang tidak menjalankan Document AI). Perlu diingat: cabang hanya boleh membaca kolom yang fiturnya dijalankan pada setiap jalur yang menuju cabang tersebut.
Kirim sebagai { "graph": <above> } ke endpoint …/workflow-graph/ (validasi dulu). Untuk membangun alur baru dari awal, gunakan didit_workflow_set_graph pada MCP. Untuk mengubah alur yang sudah ada, gunakan didit_workflow_edit_graph (operasi kecil yang mempertahankan node dan allow-list yang sudah ada). Lihat Didit MCP.Otorisasi
Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.
Body
application/json
Buat alur kerja linier sederhana. API mengonversi daftar fitur ini menjadi graf alur kerja berbasis node secara internal. Daftar kolom yang diizinkan secara KETAT: kunci apa pun yang tidak tercantum di sini (termasuk workflow_type) akan ditolak dengan 400.
Fitur verifikasi dalam urutan eksekusi. API menautkan setiap item ke item berikutnya dan menambahkan satu node status akhir secara otomatis.
Minimum array length:
1Show child attributes
Show child attributes
Nama tampilan untuk alur kerja (maksimal 50 karakter). Secara default bernilai "ID Verification" jika ditiadakan — selalu atur agar alur kerja tetap dapat dibedakan.
Maximum string length:
50Contoh:
"Standard KYC"
Atur alur kerja ini sebagai default untuk sesi baru.
Kosongkan kolom ini untuk membuat alur kerja yang dipublikasikan dan siap digunakan untuk sesi. Gunakan draft hanya jika Anda ingin menyimpan tanpa mempublikasikannya.
Opsi yang tersedia:
draft, published Aktifkan kustomisasi White Label untuk sesi yang dibuat dengan alur kerja ini.
Izinkan alur verifikasi berjalan di browser desktop.
Upaya coba lagi maksimum yang diizinkan setelah verifikasi yang ditolak. 0 memblokir pengguna setelah penolakan pertama.
Rentang yang diperlukan:
0 <= x <= 10Jendela bergulir dalam hitungan hari yang digunakan untuk menghitung percobaan ulang. null memberlakukan batas sepanjang masa.
Rentang yang diperlukan:
1 <= x <= 365Pengiriman deteksi liveness maksimum per sesi. Default 3: satu upaya awal ditambah dua percobaan ulang. Nilai ini juga disalin ke dalam node alur kerja deteksi liveness dan estimasi usia yang dibuat kecuali ditimpa oleh konfigurasi tingkat fitur.
Rentang yang diperlukan:
1 <= x <= 3Pengiriman pencocokan wajah maksimum per sesi. Default 3: satu upaya awal ditambah dua percobaan ulang. Nilai ini juga disalin ke dalam node alur kerja pencocokan wajah yang dibuat kecuali ditimpa oleh konfigurasi tingkat fitur.
Rentang yang diperlukan:
1 <= x <= 3Detik sebelum sesi yang belum selesai kedaluwarsa. Minimum 1 jam (3600), maksimum 4 minggu (2419200).
Rentang yang diperlukan:
3600 <= x <= 2419200Respons
Alur kerja dibuat. Badan respons adalah konfigurasi LENGKAP alur kerja — serialisasi mentah VerificationSettings yang sama seperti yang dikembalikan oleh GET /v3/workflows/{settings_uuid}/ (~190 kolom: setiap pengalih fitur, ambang batas, tindakan, dan workflow_graph yang dihasilkan), bukan item daftar ringkas. Simpan uuid (juga ditampilkan sebagai workflow_id) agar Anda dapat mereferensikannya dari panggilan pembuatan sesi berikutnya. Catatan: features berupa string yang digabungkan dengan " + " dan harga berupa angka JSON.
Kolom di bawah ini memiliki tipe; objek ini juga memuat setiap kolom lain dari konfigurasi alur kerja (pengalih fitur, ambang batas, tindakan peringatan, dokumen yang diizinkan, callback) sebagai properti tambahan. Kolom yang tidak berlaku untuk workflow_type bernilai null.
Pengidentifikasi per versi (settings_uuid). Setiap versi alur kerja memiliki pengidentifikasi tersendiri.
Pengidentifikasi stabil yang digunakan bersama oleh setiap versi alur kerja. Sesi yang dibuat dengannya menggunakan versi terbaru yang dipublikasikan.
Nama tampilan alur kerja.
Templat alur kerja. null untuk alur kerja graf yang dibuat tanpa templat.
Opsi yang tersedia:
kyc, kyb, adaptive_age_verification, biometric_authentication, address_verification, questionnaire_verification, email_verification, phone_verification, null Apakah ini merupakan alur kerja default aplikasi.
Alur kerja yang diarsipkan tidak dapat memulai sesi baru.
Nomor versi dalam alur kerja.
Versi draf dapat diedit; versi yang dipublikasikan bersifat tidak dapat diubah dan digunakan untuk sesi baru.
Opsi yang tersedia:
draft, published Kapan versi ini dipublikasikan. null untuk draf.
true saat alur kerja tidak memiliki workflow_graph khusus.
true hanya untuk versi draft.
URL publik yang memulai sesi dengan alur kerja ini.
Struktur graf alur kerja (node dan edge). null untuk alur kerja sederhana.
Fitur yang diaktifkan digabungkan dengan " + ", misalnya "OCR + LIVENESS".
Harga per sesi; untuk alur kerja graf, merupakan jalur termahal.
Harga jalur termurah melalui alur kerja.
Harga jalur termahal melalui alur kerja.
Harga add-on khusus organisasi, atau null jika tidak ada yang diatur.
Jumlah coba lagi yang diizinkan setelah verifikasi ditolak.
Jumlah hari selama percobaan ulang diizinkan.
Detik sebelum sesi yang belum selesai kedaluwarsa.
Kuesioner yang dilampirkan pada alur kerja, atau null.
Pengaturan verifikasi per peran untuk pihak kunci KYB.
Tingkat Tanda Tangan Elektronik mana yang dapat digunakan untuk menandatangani saat ini. Periksa ini sebelum Anda menyetel signature_level. Dikembalikan pada alur kerja kyc, kyb, dan graf.
Show child attributes
Show child attributes
Menentukan apakah alur kerja KYC atau KYB sederhana menjalankan verifikasi Bank. Verifikasi ini berjalan setelah langkah kontak (dan verifikasi Lokasi) dan sebelum validasi database, AML, serta analisis IP. Verifikasi Bank belum tersedia secara umum: mengaktifkannya ditolak di mana pun fitur ini belum diaktifkan.
Pengaturan verifikasi bank dari alur kerja sederhana, dengan kunci yang sama seperti yang diterima node BANK_VERIFICATION (misalnya bank_countries dan bank_method_order). Kunci yang tidak dikenal akan dibuang. Setiap kunci bersifat opsional dan kunci yang tidak ada akan menggunakan nilai default-nya, sehingga {} berarti semua nilai default. Lihat Pengaturan verifikasi bank.
Contoh:
{}
Menentukan apakah alur kerja KYC sederhana menjalankan verifikasi Lokasi. Verifikasi ini berjalan setelah langkah kontak dan sebelum verifikasi Bank serta validasi database. Alur kerja Bisnis (KYB) tidak dapat menjalankannya.
Pengaturan verifikasi lokasi dari alur kerja sederhana, dengan kunci yang sama seperti yang diterima node GEOLOCATION (misalnya is_geolocation_geofencing_enabled dan geolocation_max_attempts). Kunci yang tidak dikenal akan diabaikan. Setiap kunci bersifat opsional dan kunci yang tidak ada akan menggunakan nilai default-nya, sehingga {} berarti semua nilai default.
Contoh:
{}
Terakhir diubah pada 7 November 2026