Verifikasi Identitas identity.face.match

Face Match

POST /api/v1/kyc/face/match

Bandingkan wajah dari dokumen dan selfie untuk memastikan pemilik identitas adalah orang yang sama.

Body parameters

Kirim sebagai JSON body atau multipart payload. Field yang ditandai required wajib diisi.

Name	Type	Required	Description
`id_image`	file	required	File gambar KTP atau identitas.
`selfie_image`	file	required	File gambar selfie untuk dibandingkan.

Headers

Headers berikut wajib disertakan pada setiap request ke endpoint ini.

Name	Required	Description
`X-API-Key`	required	Secret Key untuk server-to-server API.
`Content-Type`	required	application/json atau multipart/form-data sesuai kebutuhan endpoint.

Responses

Status code mengikuti pola umum OGI. Detail field response mengikuti jenis endpoint dan contoh di panel kanan.

Code	Status	Deskripsi
`200`	OK	Request berhasil diproses.
`400`	Bad Request	Payload tidak valid (field hilang/format salah).
`401`	Unauthorized	API key tidak valid atau tidak disertakan.
`429`	Too Many Requests	Rate limit terlampaui.
`500`	Internal Server Error	Kesalahan internal sistem.

Siap mengevaluasi?

Hubungi tim solusi kami untuk akses evaluasi teknis dan diskusi integrasi.

Diskusikan Kebutuhan Kembali ke ringkasan

Contoh request 200 OK

POST /api/v1/kyc/face/match

request

curl -X POST https://api.orbitglobalinformasi.com/api/v1/kyc/face/match \
  -H "X-API-Key: sk_test_..." \
  -F id_image=@ktp.jpg \
  -F selfie_image=@selfie.jpg

const form = new FormData();
form.append('id_image', idFile);
form.append('selfie_image', selfieFile);

await fetch('https://api.orbitglobalinformasi.com/api/v1/kyc/face/match', {
  method: 'POST',
  headers: { 'X-API-Key': process.env.OGI_API_KEY },
  body: form
});

$ch = curl_init('https://api.orbitglobalinformasi.com/api/v1/kyc/face/match');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => [
    'id_image' => new CURLFile('ktp.jpg'),
    'selfie_image' => new CURLFile('selfie.jpg')
  ],
  CURLOPT_HTTPHEADER => ['X-API-Key: ' . $_ENV['OGI_API_KEY']],
  CURLOPT_RETURNTRANSFER => true,
]);

Response

application/json

{
  "request_id": "a19c04fe",
  "status": "success",
  "face_match": {
    "available": true,
    "matched": true,
    "similarity_score": 0.88,
    "threshold": 0.75
  },
  "similarity_score": 0.88,
  "processing_time_ms": 920,
  "error": null
}

{
  "request_id": "a19c04fe",
  "status": "not_matched",
  "face_match": {
    "available": true,
    "matched": false,
    "similarity_score": 0.42,
    "threshold": 0.75
  },
  "similarity_score": 0.42,
  "processing_time_ms": 250,
  "error": null
}

Required headers

X-API-Key required
Content-Type required