Panduan Pengembang e-KYC Now

Jenis Aliran

Aliran Dasar

Dirancang untuk skenario orientasi berisiko rendah di mana kecepatan adalah prioritas.
Alur ini memverifikasi keaslian dokumen identitas yang dikeluarkan pemerintah menggunakan database global.

Aliran Premium (Paling Aman)

Alur verifikasi kami yang paling aman.
Menggabungkan verifikasi dokumen dengan deteksi keaktifan biometrik dan skrining AML untuk meningkatkan kepatuhan dan pencegahan penipuan.

Setelah alur dibuat, Flow ID akan dihasilkan untuk aliran Dasar dan Premium.

Flow ID ini diperlukan untuk integrasi API dan harus diteruskan di header permintaan saat memanggil API KYC.

‍

Hasilkan Kunci API

• Arahkan ke bagian Panduan Pengembang di konsol dan klik Generate API Key.
• Salin dan simpan kunci API yang dihasilkan dengan aman, karena akan diperlukan untuk semua permintaan API.
• Jaga kerahasiaan kunci API setiap saat; jika terekspos, hilang, atau dikompromikan, segera buat kunci baru.
• Harap dicatat bahwa hanya satu kunci API aktif yang diizinkan pada satu waktu, dan menghasilkan kunci baru akan secara otomatis membatalkan kunci sebelumnya.

Penggunaan Alur Uji Coba

Untuk tujuan pengujian, Anda dapat menggunakan fitur Aliran Uji Coba yang tersedia di konsol.

• Untuk memulai, salin Kunci API Uji Coba dari bagian Panduan Pengembang.

Arahkan ke halaman Kelola Alur dan klik ikon “+” untuk alur yang diinginkan.

• Isi detail yang diperlukan dan klik Hasilkan. Setelah pembuatan berhasil, URL pengalihan KYC akan disediakan.

Catatan: URL yang dihasilkan hanya berlaku selama 30 menit dan harus digunakan secara ketat untuk tujuan pengujian. Jangan bagikan URL ini, karena ini sekali pakai dan terikat waktu. Anda hanya memiliki lima (5) percobaan gratis yang diizinkan. Setiap kali URL uji coba dibuat, satu percobaan akan digunakan.

Contoh URL Uji Coba

https://ekyc-staging.messagecentral.com/kyc/flow/aEzRTHuaJcwda4WtETc119_S-ljpyGpeo0aLzz4705w

Catatan: URL percobaan sampel dibuat dengan ID Alur yang telah ditentukan sebelumnya.

Jangan memodifikasi atau mengganti ID Alur ini dengan alur lain, karena hal itu dapat mengakibatkan kesalahan yang tidak terduga dan konsumsi kredit percobaan yang tidak perlu.

Hasilkan URL dari API

Titik akhir

POSTING https://ekyc.messagecentral.com/ekyc/api/v1/redirection/generate-url

Otentikasi, Header & Tubuh

Anda harus meneruskan header dan badan berikut dengan setiap permintaan:

Contoh Header dan Tubuh

flow_id:hfBIyufQ 9o9AAUfTbmKri9KHPXLStaffLbVG64JZim

api_key: Pembawa <YOUR API KEY>

nama_perusahaan: <YOUR COMPANY NAME>

Jenis Konten: aplikasi/json

Contoh cURL

curl --location 'https://ekyc.messagecentral.com/ekyc/api/v1/redirection/generate-url' \

--header flow_id: FLOW_ID \

--header api_key: Bearer YOUR_API_KEY \

--form company_name="YOUR_COMPANY_NAME"

Catatan: Flow_id dan api_key yang ditampilkan dalam contoh ini hanya untuk tujuan demonstrasi. Anda harus menggantinya dengan nilai Anda sendiri yang dihasilkan dari konsol. Jangan pernah mengekspos kunci API Anda di aplikasi sisi klien.

Tanggapan

Respon Sukses (200 OK)

{

 "url": "https://ekyc.messagecentral.com/kyc/flow HfBIyufQ-9O9AauFtBMKRi9kHPXlStAfFlbvg64JzIM",

 "token": "HfBIyufQ-9O9AauFtBMKRi9kHPXlStAfFlbvg64JzIM",

 "journey_id": "M17682023316961BQG_SE",

 "expires_in_minutes": 30,

 "message": "Embed this URL in your application for KYC verification"

}

Bidang Respons Dijelaskan

Catatan: URL yang dihasilkan kedaluwarsa setelah waktu yang ditentukan. Anda harus meregenerasinya setelah kedaluwarsa.

Tanggapan Kesalahan (401 Tidak Sah)

1. Nama Perusahaan Hilang

{
 "detail": "Missing company name in Header"
}

Pastikan company_name ada di badan permintaan.

2. Format Kunci API Tidak Valid

{

 "detail": "API Key must be 'Bearer '"

}

Pastikan kunci API diawali dengan Bearer.

3. ID Aliran Hilang

{

 "detail": "Missing flow_id header/query."

}

Pastikan flow_id dikirim dalam header permintaan.

Pedoman Keamanan & Penggunaan (Penting)

API ini harus dipanggil secara ketat dari server backend Anda.

JANGAN panggil API ini dari aplikasi frontend

Jangan panggil API ini langsung dari:

• Browser (React, Angular, Vue, dll.)
• Aplikasi seluler (Android/iOS)
• JavaScript sisi klien

Mengekspos API ini di frontend mungkin bocorkan kunci API Anda, yang dapat menyebabkan akses dan penyalahgunaan yang tidak sah.

Praktik Terbaik Keamanan

Selalu simpan api_key Anda di:

• Variabel lingkungan
• Manajer rahasia (AWS Secrets Manager, Vault, dll.)

Putar kunci API secara berkala

Buat ulang URL hanya jika diperlukan (URL terikat waktu)

Catatan Pembatasan Tarif/Penyalahgunaan

Catatan: Permintaan yang berlebihan atau kasar mungkin terbatas pada tarif untuk memastikan stabilitas platform.

Untuk pertanyaan dan kekhawatiran, hubungi kami!

support@messagecentral.com

https://www.messagecentral.com/

Pertanyaan yang Sering Diajukan