Operasi Bisnis: CRUD KYB Vendor via API Didit

Seluruh pengelolaan entitas Bisnis dilakukan melalui enam endpoint publik di bawah /v3/businesses/. Halaman ini memberikan gambaran konseptual. Lihat Referensi API untuk skema permintaan dan respons lengkap.

Daftar bisnis

GET /v3/businesses/ Daftar bisnis berhalaman untuk aplikasi Anda, dengan filter status, pencarian, negara, dan rentang tanggal.

curl -G https://verification.didit.me/v3/businesses/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "status=ACTIVE" \
  --data-urlencode "country_code=GBR" \
  --data-urlencode "page_size=50"

Ambil bisnis

GET /v3/businesses/{vendor_data}/ Ambil satu bisnis berdasarkan vendor_data.

curl https://verification.didit.me/v3/businesses/biz-acme/ \
  -H "x-api-key: YOUR_API_KEY"

Buat bisnis

POST /v3/businesses/create/ Buat Bisnis terlebih dahulu sebelum sesi Verifikasi Bisnis (KYB) berjalan:

curl -X POST https://verification.didit.me/v3/businesses/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_data": "biz-acme",
    "display_name": "Acme Corp",
    "country_code": "GBR",
    "metadata": { "partner": "Acme Holdings" }
  }'

Mengembalikan error konflik jika bisnis dengan vendor_data tersebut sudah ada. Gunakan PATCH untuk memperbarui bisnis yang sudah ada.

Perbarui bisnis

PATCH /v3/businesses/{vendor_data}/ Perbarui kolom profil yang dapat diubah. Kolom yang berasal dari pencarian registri (legal_name, registration_number, country_code) hanya dapat dibaca setelah verifikasi, tetapi dapat ditimpa. Penimpaan ditandai di log audit. Kolom yang dapat diubah: display_name, metadata, tags. Hanya dibaca setelah verifikasi: semua kolom turunan registri, penghitung agregat, peta features.

curl -X PATCH https://verification.didit.me/v3/businesses/biz-acme/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "metadata": { "tier": "enterprise" } }'

Menghasilkan event webhook business.data.updated.

Ubah status

PATCH /v3/businesses/{vendor_data}/update-status/ Pindahkan bisnis di antara ACTIVE, FLAGGED, dan BLOCKED.

curl -X PATCH https://verification.didit.me/v3/businesses/biz-acme/update-status/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "BLOCKED",
    "reason": "Sanctioned subsidiary detected in ownership chain"
  }'

Dari → ke	Pemicu umum
`ACTIVE` → `FLAGGED`	Sesi Verifikasi Bisnis (KYB) berpindah ke `In Review`, kecocokan AML pada Pemantauan AML Berkelanjutan, aturan transaksi
`ACTIVE` → `BLOCKED`	Entitas yang terkonfirmasi masuk daftar sanksi, entri daftar blokir manual
`FLAGGED` → `ACTIVE`	Analis menyelesaikan peninjauan
`BLOCKED` → `ACTIVE`	Pembukaan blokir manual setelah remediasi

Menghasilkan event webhook business.status.updated.

Hapus bisnis (batch)

POST /v3/businesses/delete/ Hapus satu atau beberapa bisnis. Catatan bisnis dihapus secara permanen. Sesi verifikasinya tidak tercakup oleh endpoint ini dan tetap ada, dengan tautannya ke bisnis tersebut dikosongkan. Hapus sesi tersebut dengan Hapus Sesi. Transaksi juga tidak tercakup. Hapus transaksi tersebut dari Console.

curl -X POST https://verification.didit.me/v3/businesses/delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "vendor_data": ["biz-acme", "biz-alpha", "biz-beta"] }'

Idempoten: menghapus bisnis yang sudah dihapus tidak memberikan efek apa pun.

Model izin

Semua endpoint /v3/businesses/* dibatasi oleh resource izin businesses:

Peran	list	get	create	update	update-status	delete
OWNER	✅	✅	✅	✅	✅	✅
ADMIN	✅	✅	✅	✅	✅	✅
COMPLIANCE_OFFICER	✅	✅	❌	✅	✅	❌
DEVELOPER	✅	✅	✅	❌	❌	❌
READER	✅	✅	❌	❌	❌	❌

Lihat Peran & izin.

Webhook yang dipicu oleh operasi ini

Operasi	Webhook
`create`	`business.data.updated`
`update`	`business.data.updated` dengan `changed_fields`
`update-status`	`business.status.updated`
`delete`	`business.data.updated` dengan `deleted_at` terisi

Langkah selanjutnya

Model data

Referensi kolom lengkap.

API daftar

Skema GET /v3/businesses/.

API buat

Skema POST /v3/businesses/create/.

Ikhtisar

Harga

Alur Kerja & Verifikasi

Peninjauan & Operasional

Entitas (Pengguna & Bisnis)

Pengaturan & Kustomisasi

Keamanan & Kepatuhan

Didit Academy

Sumber Daya

Operasi Bisnis: CRUD KYB Vendor via API Didit

Daftar bisnis

Ambil bisnis

Buat bisnis

Perbarui bisnis

Ubah status

Hapus bisnis (batch)

Model izin

Webhook yang dipicu oleh operasi ini

Langkah selanjutnya

Model data

API daftar

API buat

​Daftar bisnis

​Ambil bisnis

​Buat bisnis

​Perbarui bisnis

​Ubah status

​Hapus bisnis (batch)

​Model izin

​Webhook yang dipicu oleh operasi ini

​Langkah selanjutnya

Model data

API daftar

API buat

Daftar bisnis

Ambil bisnis

Buat bisnis

Perbarui bisnis

Ubah status

Hapus bisnis (batch)

Model izin

Webhook yang dipicu oleh operasi ini

Langkah selanjutnya