> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Pencarian Registri Perusahaan Afrika Selatan API

> Pencarian registri perusahaan Afrika Selatan yang akurat lewat Didit. Bayar per panggilan mulai $0.75, tanpa kontrak, tanpa minimum.

Mencari perusahaan di Afrika Selatan berdasarkan nomor registrasi di registri komersial CIPC. Didit menyediakan layanan ini melalui `POST /v3/database-validation/` agar Anda dapat memverifikasi data yang dikirim terhadap sumber resmi dan menerima hasil pencocokan yang sudah dinormalisasi.

## Cakupan

* **Cakupan:** —
* **Negara:** Afrika Selatan
* **ID layanan:** `zaf_company_registry`
* **Domain data:** Pemerintah
* **Kategori:** CompanyRegister

## Input

| Kolom | Wajib | Contoh |
| - | -: | - |
| `company_registration_number` | Ya | `REG-123456` |
| `company_name` | Tidak | `Sample Company LLC` |
| `vendor_data` | Tidak | `user-1234` |

* **Input wajib:** `company_registration_number`
* **Input opsional:** `company_name`, `vendor_data`
* **Persetujuan:** Tidak diperlukan
* **Ketersediaan dalam alur kerja:** Tersedia dalam alur kerja dengan pemetaan kolom
* **Cakupan:** —
* **Harga:** \$0.75 per kueri yang berhasil

Dalam alur kerja, `company_registration_number` tidak dicetak pada dokumen identitas, sehingga tidak ada langkah yang menghasilkannya sendiri. Kumpulkan nilai ini dari jawaban Kuesioner, kolom ekstraksi Document AI, atau nilai yang Anda kirim saat membuat sesi, lalu petakan pada langkah Validasi Database. Sampai nilai ini dipetakan, editor alur kerja menampilkan layanan ini dalam keadaan nonaktif dan menyebutkan input yang belum ada. Saat dijalankan, input yang hilang berarti pemeriksaan dilewati sebelum ada kueri, sehingga Anda tidak pernah ditagih untuk database yang tidak dapat dikueri.

## Parameter body

**issuing\_state** `string` *required* (default: ZAF)

Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.

Contoh: `ZAF`

**services** `string` *required* (default: zaf\_company\_registry)

Array yang berisi ID layanan ini. Mengunci layanan membuat permintaan hanya mengarah ke database yang tepat ini.

Contoh: `zaf_company_registry`

**company\_registration\_number** `string` *required* (default: REG-123456)

Nilai `company_registration_number` yang dibutuhkan oleh layanan database ini.

Contoh: `REG-123456`

**company\_name** `string`

Nilai `company_name` yang dibutuhkan oleh layanan database ini.

Contoh: `Sample Company LLC`

**vendor\_data** `string` (default: user-1234)

Referensi pengguna yang stabil untuk orang ini di sistem Anda, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan mandiri ke pengguna akhir yang sama dan mengurangi gangguan deteksi duplikat.

Contoh: `user-1234`

## Aturan input & catatan validasi

* Kirim kolom yang tercantum di atas persis seperti yang diambil dari pengguna atau dokumen.
* Didit memvalidasi kolom wajib sebelum memanggil database. Permintaan yang ditolak sebelum pencarian sumber tidak dikenakan biaya.

## Cara memanggilnya

```bash cURL theme={null}
curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_company_registry" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"
```

Setiap panggilan yang berhasil mengembalikan HTTP `200`. Kolom **`outcome_code`** memberi tahu Anda apa yang sebenarnya terjadi, misalnya membedakan ketidakcocokan biometrik yang nyata (`BIOMETRIC_NO_MATCH`) dengan swafoto yang tidak dapat dibaca (`BIOMETRIC_IMAGE_UNUSABLE`). `status` yang ditampilkan adalah status fitur default; [tindakan Partial Match / No Match](https://docs.didit.me/id/core-technology/database-validation/database-validation-warnings.md) yang Anda konfigurasi dapat mengubahnya.

**`MATCH`** - Registri mengonfirmasi identitas dan setiap kolom yang diperiksa cocok.

```json 200 OK — MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_company_registry",
      "service_name": "South Africa - Company Registry Lookup",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`NO_MATCH`** - Registri tidak mengembalikan kecocokan untuk data yang dikirim.

```json 200 OK — NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_company_registry",
      "service_name": "South Africa - Company Registry Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

## Data yang dikembalikan

Kolom persis yang muncul di `source_data` bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk `zaf_company_registry` saat ini mendokumentasikan bentuk ternormalisasi berikut:

* Bervariasi tergantung respons registri.

## Harga & SLA

Kueri Pencarian Registri Perusahaan Afrika Selatan hanya ditagih ketika Didit menerima hasil yang meyakinkan dari sumber validasi.

* **Harga per panggilan:** \$0.75 USD.
* **Penagihan:** per kueri yang berhasil. Anda tidak ditagih ketika registri tidak dapat dihubungi, ketika kolom wajib tidak ada, atau ketika permintaan ditolak sebelum mencapai sumber.
* **Latensi:** p95 tipikal \< 2 dtk.
* **Ketersediaan:** 99.9% per kuartal di sisi Didit; ketersediaan sumber hilir bervariasi menurut negara dan dataset.

## Lanjutkan membaca

* [Ikhtisar Validasi Database Afrika Selatan](https://docs.didit.me/api-reference/database-validation/south-africa.md)
* [Ikhtisar Validasi Database](https://docs.didit.me/id/core-technology/database-validation/overview.md)
* [Kode hasil](https://docs.didit.me/id/core-technology/database-validation/database-validation-outcome-codes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.