Verifikasi Pemegang Rekening Bank Afrika Selatan API

​

Cakupan

• Cakupan: —
• Negara: Afrika Selatan
• ID layanan: zaf_bank_account_holder
• Domain data: Keuangan
• Kategori: Perbankan

​

Input

• Input wajib: national_id, bank_account_number, bank_name
• Input opsional: account_type, first_name, last_name, initials, email, phone_number, vendor_data
• Persetujuan: Wajib
• Ketersediaan di alur kerja: Tersedia di alur kerja dengan pemetaan kolom
• Cakupan: —
• Harga: $0.40 per kueri yang berhasil

​

Parameter body

​

Aturan input & catatan validasi

• account_type harus salah satu tipe akun AVS Afrika Selatan: current, savings, transmission, subscriptionShare, notKnown. Pencocokan tidak sensitif terhadap huruf besar-kecil. Hilangkan kolom ini jika Anda tidak mengetahui tipe akunnya: Didit kemudian mengirim notKnown, dan pemeriksaan silang tipe akun dilaporkan sebagai tidak terkonfirmasi, bukan membuat permintaan gagal.

​

Cara memanggil

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_bank_account_holder" \
  -F "vendor_data=user-1234" \
  -F "consent=true" \
  -F "national_id=8708150847085" \
  -F "bank_account_number=1234567890" \
  -F "bank_name=ABSA" \
  -F "account_type=current" \
  -F "last_name=Doe" \
  -F "initials=JD"

Setiap panggilan yang berhasil mengembalikan HTTP 200. Kolom outcome_code memberi tahu Anda apa yang sebenarnya terjadi, misalnya membedakan ketidakcocokan biometrik nyata (BIOMETRIC_NO_MATCH) dari swafoto yang tidak dapat dibaca (BIOMETRIC_IMAGE_UNUSABLE). status yang ditampilkan adalah status fitur default. Tindakan Kecocokan Sebagian / Tidak Ada Kecocokan yang Anda konfigurasi dapat menggantinya.

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_bank_account_holder",
      "service_name": "South Africa - Bank Account Holder Verification",
      "source_data": {
        "accepts_credits": true,
        "accepts_debits": true,
        "account_found": true,
        "account_number_length_valid": true,
        "account_open": true,
        "account_type_match": true,
        "id_match": true,
        "identification_number": "SAMPLE-ID-12345",
        "initials_match": true,
        "surname_match": true
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "ZAF",
  "match_type": "partial_match",
  "validations": [
    {
      "outcome_code": "PARTIAL_MATCH",
      "service_id": "zaf_bank_account_holder",
      "service_name": "South Africa - Bank Account Holder Verification",
      "source_data": {
        "accepts_credits": true,
        "accepts_debits": true,
        "account_found": true,
        "account_number_length_valid": false,
        "account_open": true,
        "account_type_match": true,
        "id_match": true,
        "identification_number": "SAMPLE-ID-12345",
        "initials_match": true,
        "surname_match": false
      },
      "validation": {
        "full_name": "partial_match",
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_bank_account_holder",
      "service_name": "South Africa - Bank Account Holder Verification",
      "source_data": {
        "accepts_credits": false,
        "accepts_debits": false,
        "account_found": false,
        "account_number_length_valid": false,
        "account_open": false,
        "account_type_match": false,
        "id_match": false,
        "identification_number": "NO_MATCH",
        "initials_match": false,
        "surname_match": false
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

​

Data yang dikembalikan

• accepts_credits
• accepts_debits
• account_found
• account_number_length_valid
• account_open
• account_type_match
• id_match
• identification_number
• initials_match
• surname_match

​

Harga & SLA

• Harga per panggilan: $0.40 USD.
• Penagihan: per kueri yang berhasil. Anda tidak dikenai biaya ketika registri tidak dapat dijangkau, ketika kolom wajib tidak ada, atau ketika permintaan ditolak sebelum mencapai sumber.
• Latensi: p95 tipikal < 2 detik.
• Ketersediaan: 99.9% per kuartal di sisi Didit; ketersediaan sumber hilir bervariasi menurut negara dan dataset.

​

Apa yang Dikonfirmasi oleh MATCH

• account_found - bank memiliki rekening dengan nomor ini. Semua yang lain tidak berarti ketika nilai ini false.
• account_open - rekening masih terbuka. Sebuah rekening bisa ditemukan tetapi sudah ditutup.
• id_match - rekening dimiliki oleh ID nasional yang Anda kirim. Inilah pemeriksaan yang menjadi alasan layanan ini ada.
• initials_match, surname_match - initials dan last_name yang Anda kirim cocok dengan pemegang rekening dalam catatan.
• account_type_match - account_type yang Anda kirim cocok dengan jenis rekening yang sebenarnya.
• email_match, phone_match - email dan phone_number yang Anda kirim cocok dengan detail kontak yang dimiliki bank.
• accepts_debits, accepts_credits - rekening dapat menerima instruksi debit dan kredit.
• account_number_length_valid - nomor rekening memiliki panjang yang diharapkan bank.

• MATCH - rekening ada dan setiap kolom yang Anda kirim cocok, termasuk id_match.
• PARTIAL_MATCH - rekening dimiliki oleh ID nasional yang Anda kirim, tetapi setidaknya satu kolom lain yang Anda kirim tidak cocok (misalnya nama keluarga yang ejaannya berbeda dalam catatan bank). outcome_detail menyebutkan kolom yang gagal.
• NO_MATCH - bank tidak memiliki rekening tersebut, atau rekening ada tetapi milik orang lain. Keduanya adalah jawaban konklusif tentang orang tersebut.

​

Nilai bank_name dan account_type yang diterima

​

Membedakan rekening yang tidak ada dari sumber yang tidak tersedia

• Rekening tidak ada - 200 OK, match_type: "no_match", outcome_code: "NO_MATCH", source_data.account_found: false. Ini adalah jawaban nyata dari bank. Ditagih, dan tindakan Anda untuk kondisi no-match berlaku.
• Sumber tidak menjawab - 502 Bad Gateway dengan validation_errors[].code = empty_provider_response dan retryable: true. Tidak ada yang terbukti tentang orang tersebut, tidak ada yang ditagih, dan permintaan aman untuk dicoba lagi.
• Sumber menolak menjalankan kueri - 400 Bad Request dengan validation_errors[].code = provider_rejected_input dan retryable: false. Sumber tidak pernah melakukan pencarian karena tidak mau menerima data yang dikirim. Perbaiki data; mencoba lagi dengan nilai yang sama tidak akan berhasil. Tidak ada yang ditagih.
• Sumber menjawab dan menolak input Anda - 502 Bad Gateway dengan validation_errors[].code = provider_invalid_input (misalnya nomor rekening yang gagal pemeriksaan format milik bank). Mencoba lagi tidak ada gunanya sampai input diperbaiki; tidak ada yang ditagih.
• Permintaan Anda tidak pernah keluar dari Didit - 400 Bad Request, yang mencantumkan kolom yang harus diperbaiki. Tidak ada yang ditagih.

​

Lanjutkan membaca

• Ikhtisar Validasi Database Afrika Selatan
• Ikhtisar Validasi Database
• Kode Hasil