---
title: Pemrosesan Ulang dan Impor Basis Biometrik
description: Panduan untuk memproses ulang rekaman biometrik atau mengimpor basis biometrik ke platform Unico.
canonical: https://developer.unico.io/id/dual-api/resources/reprocessing
locale: id
generated_by: markdown-export
---

- [/id/](/id/)
- Sumber Daya
- Pemrosesan Ulang dan Impor Basis Biometrik

**Di halaman ini# Pemrosesan Ulang dan Impor Basis Biometrik

Panduan ini membahas cara melakukan **pemrosesan ulang** atau **impor basis biometrik** di platform Unico. Panduan ini menjelaskan persyaratan teknis dan operasional untuk integrasi yang efektif dan aman sesuai dengan praktik terbaik platform.
### Cakupan​

Materi ini mencakup dua jenis proses:

**Pemrosesan Ulang**: memproses ulang rekaman biometrik pengguna yang telah melalui basis klien dan Unico untuk evaluasi ulang atau migrasi antar sistem.
**Impor Basis Biometrik**: unggah awal atau pembaruan basis yang berisi selfie untuk tujuan verifikasi identitas dan/atau risk classification.
**Impor Basis Dokumen**: unggah basis dokumen bersama selfie untuk tujuan verifikasi Facematch atau CPF Match (khusus Brasil).

### Prasyarat​

Klien **harus memiliki kontrak aktif atau NDA** yang ditandatangani dengan Unico dan berada dalam fase integrasi (pengecualian jika disetujui oleh tim governance).
Proyek akan mengikuti **perjanjian TPS (transaksi per detik)** formal. Lihat [Perjanjian TPS](#tps-agreement) di bawah.
Sebelum mendapatkan kredensial produksi, **homologasi integrasi penuh wajib dilakukan** untuk memastikan kualitas data, kepatuhan payload, dan performa yang stabil.
**Akun layanan khusus** harus dibuat untuk pemrosesan ulang atau impor (misalnya, "Reprocessing" atau "Legacy_Import").
**API Key khusus** akan dibuat secara spesifik untuk pemrosesan ulang/impor.
**(Opsional)** Subsidiary khusus dapat dibuat untuk pemrosesan ulang/impor. Parameter ini diidentifikasi dalam payload sebagai `subsidiaryId`. Lihat [Parameter payload](#payload-parameters) di bawah.
API Key dan akun layanan **akan dinonaktifkan** setelah periode yang disepakati atau penyelesaian pemrosesan.

### Capability yang tersedia​

CapabilityDeskripsi**Identity Verification**Memverifikasi apakah selfie yang dikirimkan milik pemegang sebenarnya dari pengidentifikasi tersebut.**Klasifikasi Risiko Penipuan**Memeriksa riwayat perilaku penipuan yang terkait dengan wajah tersebut.**Facematch**Memverifikasi apakah foto dokumen cocok dengan selfie yang dikirimkan.**CPF Match** Brazil onlyMemverifikasi apakah CPF yang diberikan cocok dengan nomor CPF yang tercetak pada dokumen. Catatan: tidak semua RG mencantumkan CPF.
### Persyaratan selfie​

Harus dikirimkan dalam format **base64**.
Gambar harus mengikuti **standar ICAO** (latar belakang terang, wajah di tengah, tanpa aksesori yang menghalangi identifikasi, pencahayaan yang tepat).
Dimensi yang direkomendasikan: **1080x1920** (potret) atau **1920x1080** (lanskap).
Ukuran maksimum: **800 KB** (kompres dengan JPEG 92 jika diperlukan).
Orientasi: **portrait**.

### Persyaratan dokumen​

**Jenis dokumen yang didukung**: lihat [Pengambilan Dokumen dan Penggunaan Kembali — Dokumen yang didukung](/id/capabilities/document-reuse-and-capture#supported-documents).
Gambar harus mencakup bagian **depan dan belakang** dokumen, terlihat sepenuhnya tanpa pemotongan.
Dokumen harus **terbaca** — jelas, berpenampilan baik, dan bebas dari hambatan.

### Perjanjian TPS​

TPS maksimum yang disepakati untuk proyek ini adalah **10 TPS**.
Distribusikan permintaan secara merata dari waktu ke waktu daripada mengirimkannya dalam ledakan besar.
Batas ini **tidak boleh dilampaui** tanpa persetujuan formal dari tim Unico.
Permintaan di atas batas dapat secara otomatis di-drop atau diblokir.
Jika diperlukan peningkatan sementara, **perjanjian formal sebelumnya** diperlukan.

### Integrasi​

#### Endpoint​

LingkunganBase URLAksesCatatanStaging`https://api.id.uat.unico.app`TerbukaWajib untuk pengujianProduction`https://api.id.unico.app`Hanya setelah homologasi disetujuiMemerlukan kontrol TPS yang ketat
#### Header yang diperlukan​

```
Authorization: Bearer {access_token}APIKEY: {your_api_key}Content-Type: application/json
```

#### Parameter payload​

```
{  "subject": {    "duiType": 1,    "code": "11032395702",    "name": "User Name",    "email": "username@gmail.io",    "phone": "21998571922",    "birthDate": "30/07/1989",    "gender": "M"  },  "useCase": "Reprocessamento/Importação",  "subsidiaryId": "35d734c4-7fbb-4b2f-a1dc-7e1575514819",  "imageBase64": "/9j/4AAQSkZJR...",  "document": {    "purpose": "Reprocessamento",    "documentId": "doc-001",    "files": [      {        "data": "doc_base64_frente",        "faceDocumentMatch": true      },      {        "data": "doc_base64_verso"      }    ]  }}
```

FieldTipeWajibDeskripsi`subject`objectYaData identifikasi pengguna.`subject.duiType`integerYaPengidentifikasi tipe dokumen. Lihat [nilai `duiType`](#duitype-values) di bawah.`subject.code`stringYaCPF atau pengidentifikasi pengguna lainnya.`subject.name`stringYaNama lengkap pengguna.`subject.email`stringTidakEmail pengguna.`subject.phone`stringTidakNomor telepon pengguna.`subject.birthDate`stringTidakTanggal lahir pengguna (`DD/MM/YYYY`).`subject.gender`stringTidakJenis kelamin pengguna (`M` atau `F`).`useCase`stringYaNama use case ("Reprocessamento" atau "Importação de base").`subsidiaryId`stringTidakUUID subsidiary (disediakan oleh Unico).`imageBase64`base64YaGambar selfie pengguna yang dikonversi ke base64.`document`objectTidakData dokumen yang terkait dengan proses.`document.purpose`stringTidakTujuan dokumen (misalnya, `"Reprocessamento"`).`document.documentId`stringTidakPengidentifikasi dokumen.`document.files`arrayTidakDaftar file gambar dokumen.`document.files[].data`base64TidakGambar dokumen yang dikonversi ke base64.`document.files[].faceDocumentMatch`booleanTidakMenunjukkan apakah wajah dalam dokumen cocok dengan selfie yang dikirimkan.
**Nilai `duiType`**NegaraKodeDeskripsiAR6Paspor ArgentinaAR7DNI ArgentinaAR49SIM Argentina (Licencia Nacional de Conducir)AT34Nomor Pajak Austria (STNR)BE36Nomor Nasional Belgia (NN)BR1CPF BrasilBR5Paspor BrasilBR14CNPJ BrasilCA28SIN KanadaCH33Nomor AHV/AVS SwissCL9RUN ChiliCL52Paspor ChiliCL57SIM Chili (Licencia de Conducir)CO26NIT KolombiaCO53Paspor KolombiaCO55SIM Kolombia (Licencia de Conducción)CO56Kartu Kewarganegaraan Kolombia (Cédula de Ciudadanía)DE41Nomor Identifikasi Pajak Jerman (IdNr)DK29CPR DenmarkEC10NI EkuadorES50Nomor Identitas Warga Asing Spanyol (NIE)ES51Dokumen Identitas Nasional Spanyol (DNI)FI35Kode Identitas Pribadi Finlandia (HETU)FR46Nomor Referensi Pajak Prancis (SPI)GB30Nomor Asuransi Nasional Inggris (NINO)GT12CUI GuatemalaID16NIK IndonesiaIE47Nomor Layanan Publik Pribadi Irlandia (PPSN)IT37Codice Fiscale Italia (CF)LU48Nomor Identifikasi Nasional Luksemburg (Matricule)MX2CURP MeksikoMX25RFC Meksiko (Perorangan)MX58SIM Meksiko (Licencia de Conducir)NG8NIN NigeriaNG20Nomor Verifikasi Bank Nigeria (BVN)NG43Token BVN Nigeria (hash)NG44Token NIN Nigeria (hash)NL42Nomor Layanan Warga Negara Belanda (BSN)NO39Nomor Identitas Nasional Norwegia (Fødselsnummer)PE27RUC PeruPE40DNI PeruPE54Paspor PeruPL31PESEL PolandiaPT45Nomor Identifikasi Pajak Portugal (NIF)SE32Nomor Pribadi Swedia (PNR)SE38Nomor Koordinasi Swedia (Samordningsnummer)TR24Nomor Identifikasi Turki (TCKN)US4SSN Amerika SerikatUS11Paspor Amerika SerikatUS18SIM Amerika SerikatUS21Kartu Paspor Amerika SerikatUS22Paspor Polikarbonat Amerika SerikatUS23Kartu Identitas Amerika SerikatUY13CI UruguayZZ15Alamat emailZZ17Nomor telepon—0Tidak ditentukan—3Pengidentifikasi internal Unico
#### Catatan penting​

Selfie **harus mematuhi standar ICAO** dengan kualitas dan pencahayaan yang tepat.
Selfie harus dalam **format base64**.
Hindari pengiriman massal tanpa kontrol TPS — ini dapat memicu pembatasan laju (lihat [Penanganan error](#error-handling) di bawah).
Selalu uji data dan integrasi di lingkungan staging terlebih dahulu.

#### Respons​

**Berhasil — 200 OK**
Tanpa dokumenDengan dokumen (Facematch)```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "status": 3,  "unicoId": {    "result": "inconclusive"  },  "riskLevel": {    "result": "inconclusive"  }}
```

FieldTipeDeskripsi`id`stringPengidentifikasi proses. Simpan untuk kueri di masa mendatang atau jika Anda mengimplementasikan Validation (1:1) nanti.`status`integerStatus transaksi.`unicoId.result`stringRespons capability Verifikasi Identitas.`riskLevel.result`stringHasil klasifikasi risiko penipuan. Nilai yang mungkin: `reproved`, `risk-critical`, `risk-high`, `inconclusive`.```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "score": 0,  "status": 3,  "unicoId": {    "result": "yes"  },  "faceDocumentMatch": {    "faceMatch": true  },  "riskLevel": {    "result": "inconclusive"  }}
```

FieldTipeDeskripsi`id`stringPengidentifikasi proses. Simpan untuk kueri di masa mendatang atau jika Anda mengimplementasikan Validation (1:1) nanti.`status`integerStatus transaksi.`score`numberSkor Facematch.`unicoId.result`stringRespons capability Verifikasi Identitas.`faceDocumentMatch.faceMatch`booleanApakah foto dokumen cocok dengan selfie yang dikirimkan.`riskLevel.result`stringHasil klasifikasi risiko penipuan. Nilai yang mungkin: `reproved`, `risk-critical`, `risk-high`, `inconclusive`.
**Error pemrosesan gambar**
```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "status": 5}
```

**Error umum**
Kode dalam rentang `4xx` menunjukkan error validasi dengan data yang diberikan. Kode dalam rentang `5xx` menunjukkan kegagalan di sisi server.
Kode HTTPTipe ErrorKemungkinan PenyebabTindakan yang Disarankan`400`Bad RequestPayload tidak validValidasi struktur dan konten.`401`UnauthorizedToken kedaluwarsa atau tidak validBuat ulang token.`403`ForbiddenAPI Key salah atau izin tidak memadaiVerifikasi kredensial.`429`Too Many RequestsLaju permintaan terlampauiTunggu dan patuhi batas TPS.`500+`Internal Server ErrorKegagalan internalCoba lagi setelah beberapa detik; buka tiket jika terus berlanjut.
### Penanganan error​

**Rate Limit (HTTP 429)** harus dipantau dengan cermat. Kelebihan beban permintaan dapat memblokir pipeline.
Selalu patuhi TPS yang disepakati dengan Unico (lihat [Perjanjian TPS](#tps-agreement)).
Untuk kegagalan yang terus-menerus (5xx), proses ulang dengan kontrol retry/backoff.
Terakhir diperbarui pada 8 Okt 2026**