Identitas Digital

Identitas Digital tersedia di API versi 1 dan 2. Namun, API versi 1 akan dihentikan pada masa mendatang, sehingga integrasi baru sebaiknya menggunakan API versi 2. Permintaan memerlukan cakupan OAuth write.digital_identity.

Deskripsi kolom

Lihat spesifikasi OpenAPI untuk skema lengkap (termasuk bidang opsional).

{
  "id": { "type": "string" }, // (Required) Unique identifier for the data
  "document_type": { "type": "string" }, // (Required) Must be "none"
  "credential_type": { "type": "string" }, // (Required) Must be "digital_identity"
  "data": { // { "type": "object" }, (Required)
    "credential": { // { "type": "object" }, (Required)
      "full_name": { "type": "string" }, // (Required)
      "date_of_birth": { "type": ["string", "null"], "format": "date" }, // (Optional) Encouraged to be included if available. Date format: "YYYY-MM-DD"
      "identity_document_validity": { "type": "string" }, // (Required) Must be one of "manual", "government_database", "verifiable_credential"
      "identity_document_liveness": { "type": "string" }, // (Required) Must be one of "automated", "in_person",
      "identity_document_person_match": { "type": "string" }, // (Required) Must be one of "manual", "automated", "government_database"
    },
    "partner_chain": { "type": ["array", "null"] } // (Optional unless otherwise specified) Array of objects to specifiy partner institutions, e.g. [{ "name": "Partner Organization" }]
  }
}

Memanfaatkan kolom Identitas Digital

Validasi identitas

Payload Anda harus menyertakan bidang yang menjelaskan tingkat validasi yang terlibat dalam proses asesmen Anda.

Ini memungkinkan kami memahami tingkat verifikasi yang dilakukan dalam menilai pengajuan Identitas Digital ini.

Validasi	Kolom		Detail
Apakah Anda sudah mengonfirmasi bahwa pengguna memiliki dokumen identitas pemerintah yang valid?	`identity_document_validity`	`manual`	Ya, seseorang melihat dokumennya.
		`government_database`	Ya, melalui verifikasi terhadap database pemerintah (mis. DUKCAPIL, DVS).
		`verifiable_credential`	Ya, melalui verifikasi menggunakan sumber/format yang dapat diverifikasi secara kriptografis (mis. Singpass, ISO mDL).
Apakah Anda sudah mengonfirmasi bahwa dokumen ini diterima dari pengguna yang sedang aktif?	`identity_document_liveness`	`automated`	Ya, melalui sistem verifikasi liveness otomatis (mis. Amazon Rekognition).
	`identity_document_liveness`	`in_person`	Ya, dokumen diberikan secara langsung.
Apakah Anda sudah mengonfirmasi bahwa pengguna adalah orang yang sama seperti yang tertera pada dokumen identitas pemerintah?	`identity_document_person_match`	`manual`	Ya, seseorang membandingkan foto pengguna dengan foto pada dokumen identitas pemerintah
		`automated`	Ya, sistem otomatis digunakan untuk membandingkan foto pengguna dengan foto pada dokumen identitas pemerintah (mis. Amazon Rekognition)
		`government_database`	Ya, sistem otomatis digunakan untuk membandingkan foto pengguna dengan foto yang tersimpan di database pemerintah (mis. FVS)

Jika Anda tidak dapat memberi label pengajuan Anda berdasarkan respons yang kami berikan, hubungi kami untuk bantuan lebih lanjut.

Rantai mitra

Kolom partner_chain mencatat hubungan perantara dalam hierarki mitra berlapis yang tidak direpresentasikan di bagian lain dalam integrasi. Ini meningkatkan granularitas analitik yang dapat diberikan SEEK Pass kepada Anda.Klik di sini untuk detail lebih lanjut.

Contoh payload

{
  "id": "fa651300-b91a-49cb-8ee7-cac68b3fdf74",
  "document_type": "none",
  "credential_type": "digital_identity",
  "data": {
    "credential": {
      "full_name": "John Doe",
      "date_of_birth": "1990-01-30", // Optional but encouraged to be included if available
      "identity_document_validity": "manual",
      "identity_document_liveness": "in_person",
      "identity_document_person_match": "government_database"
    }
  }
}

Sebelumnya: Batch Kredensial

Berikutnya: Pendidikan