Pengenalan
Memulakan integrasi dengan Plaid adalah langkah penting untuk mana-mana aplikasi yang memerlukan akses selamat kepada data kewangan pengguna melalui perbankan terbuka. Panduan Quickstart ini akan memandu anda melalui proses persediaan aplikasi anda, mendapatkan kunci API, dan membuat panggilan API pertama anda untuk menyambung akaun bank pengguna. Dengan mengikuti langkah-langkah ini, anda boleh mula memanfaatkan kuasa data kewangan secara berkesan dan selamat.
Matriks Teknologi–Kewangan
| Prasyarat (Perkakasan/Perisian/Akaun) | Kos (Beli atau Sewa/Pembiayaan) | Jangka Hayat atau Pembaharuan | Nota Cukai / Potongan | Had Operasi atau Kadar Pengeluaran |
|---|---|---|---|---|
| Akaun Plaid (Sandbox) | Percuma | N/A | N/A | Akses kepada data ujian; had panggilan API terhad |
| Kunci API Plaid (ID Klien, Kunci Rahsia) | Percuma | N/A | N/A | Digunakan untuk pengesahan API |
| Pelayan Pelayan (Server-side) | $0 (Serverless) - $50/bulan (Pengurusan) | N/A | OpEx | Boleh mengendalikan beribu-ribu permintaan API per minit |
| Pelayan Klien (Client-side - Web) | $0 (JavaScript percuma) | N/A | N/A | Bergantung pada prestasi penyemak imbas pengguna |
| Node.js & npm (untuk Quickstart) | Percuma | N/A | N/A | Diperlukan untuk menjalankan aplikasi Quickstart tempatan |
Langkah Demi Langkah
Langkah 1: Dapatkan Kunci API Plaid
Langkah pertama dalam memulakan integrasi Plaid adalah mendaftar untuk akaun di Dashboard Plaid. Selepas pendaftaran, anda akan diberikan Kunci API, yang terdiri daripada ID Klien dan Kunci Rahsia Sandbox. Kunci ini adalah pengenalan unik anda kepada Plaid dan digunakan untuk mengesahkan semua permintaan API yang dibuat oleh aplikasi anda. Pastikan anda menyimpan Kunci Rahsia ini dengan selamat, kerana ia tidak boleh dikongsi dan digunakan untuk mengesahkan identiti anda kepada Plaid.
Langkah 2: Klon dan Konfigurasi Aplikasi Quickstart
Untuk mempercepatkan proses, Plaid menyediakan aplikasi Quickstart yang boleh anda jalankan secara tempatan. Klon repositori ini dari GitHub. Anda kemudian perlu mengkonfigurasi fail .env dengan ID Klien dan Kunci Rahsia Sandbox yang anda peroleh pada langkah sebelumnya. Setelah dikonfigurasi, anda boleh menjalankan aplikasi menggunakan arahan npm install diikuti dengan npm start di terminal anda. Ini akan memulakan pelayan pelayan dan klien yang diperlukan untuk menguji integrasi Plaid.
Langkah 3: Cipta Item Pertama Anda
Dengan aplikasi Quickstart berjalan, anda boleh mula mencipta ‘Item’ pertama anda. Item ialah istilah Plaid untuk sambungan log masuk ke institusi kewangan. Dalam antara muka Quickstart, klik butang ‘Launch Link’ dan pilih mana-mana institusi yang tersedia dalam persekitaran Sandbox. Anda akan diminta untuk memasukkan kelayakan ujian yang disediakan oleh Plaid (biasanya user_good dan pass_good). Kejayaan log masuk ini akan mencipta Item pertama anda, yang mewakili sambungan pengguna ke akaun bank mereka.
Langkah 4: Panggil API /link/token/create
Selepas Item dibuat, aplikasi anda perlu mendapatkan link_token daripada Plaid. Ini dilakukan dengan membuat permintaan POST ke endpoint /link/token/create Plaid. Permintaan ini memerlukan beberapa parameter, termasuk ID Klien anda, client_name (nama aplikasi anda), user (objek yang mengenal pasti pengguna), dan products (senarai produk Plaid yang anda ingin gunakan, cth. ['transactions', 'auth']). link_token yang diterima ialah token sementara yang digunakan untuk menginisialisasi Plaid Link di bahagian klien.
Langkah 5: Inisialisasi Plaid Link dan Tukar Token
link_token yang diterima digunakan untuk memulakan Plaid Link, modul antara muka pengguna yang dikendalikan oleh Plaid. Apabila pengguna berjaya melengkapkan proses log masuk melalui Plaid Link, Plaid akan memulangkan public_token kepada aplikasi anda melalui callback onSuccess. Token ini kemudiannya dihantar ke pelayan anda, di mana anda akan membuat panggilan API /item/public_token/exchange untuk menukarnya kepada access_token yang kekal. access_token ini adalah kunci untuk membuat panggilan API Plaid seterusnya bagi Item tersebut.
Langkah 6: Buat Permintaan API Menggunakan access_token
Setelah anda berjaya memperoleh access_token, anda boleh menggunakannya untuk mengakses pelbagai data kewangan pengguna. Sebagai contoh, anda boleh membuat panggilan ke endpoint /accounts/get menggunakan access_token untuk mendapatkan senarai akaun yang dikaitkan dengan Item, termasuk nama akaun, nombor akaun (disamarkan), dan baki semasa. Data ini kemudiannya boleh dipaparkan dalam aplikasi anda atau digunakan untuk tujuan lain, seperti pengurusan bajet atau pemindahan dana.
Tips & Amalan Terbaik
- Simpan
access_tokendanitem_iddengan selamat di bahagian pelayan anda. - Gunakan
link_tokenhanya sekali untuk mencipta Item. - Sediakan penanganan ralat yang kukuh untuk panggilan API Plaid.
- Patuhi dasar privasi Plaid dan peraturan perlindungan data.
- Pertimbangkan untuk menggunakan produk Plaid lain seperti Identity Verification atau Income Verification.
- Sentiasa rujuk dokumentasi Plaid terkini untuk kemas kini API.
Kesilapan Biasa
| Ralat Teknikal | Kesan Kewangan | Pembaikan Selamat |
|---|---|---|
link_token tamat tempoh sebelum digunakan | Pengguna tidak dapat melengkapkan sambungan akaun, kehilangan potensi pelanggan | Pastikan link_token dijana sejurus sebelum memulakan Plaid Link dan digunakan dalam tempoh sahnya. |
public_token tidak diterima dalam callback onSuccess | Pengguna tidak dapat melengkapkan proses sambungan, data tidak dapat diperoleh | Semak konfigurasi Plaid Link di bahagian klien dan pastikan callback onSuccess dikendalikan dengan betul. |
Gagal menukar public_token kepada access_token | Tidak dapat mengakses data akaun pengguna, fungsionaliti aplikasi terhad | Pastikan panggilan /item/public_token/exchange dibuat dengan betul di bahagian pelayan menggunakan public_token yang sah. |
access_token hilang atau bocor | Akses tidak sah kepada data kewangan pengguna, risiko keselamatan yang serius | Simpan access_token dengan selamat di pangkalan data pelayan anda dan gunakan kaedah pengesahan yang kukuh. |
Ringkasan / Pengajaran Utama
- Plaid Quickstart menyediakan laluan pantas untuk integrasi API perbankan terbuka.
- Anda memerlukan kunci API Plaid (ID Klien, Kunci Rahsia Sandbox).
- Proses melibatkan penjanaan
link_token, inisialisasi Plaid Link, dan pertukaranpublic_tokenkepadaaccess_token. access_tokendigunakan untuk membuat panggilan API Plaid seterusnya.- Keselamatan
access_tokenadalah kritikal untuk melindungi data pengguna. - Plaid menawarkan pelbagai produk di luar penyambungan akaun asas.
Kesimpulan
Dengan mengikuti panduan Quickstart ini, anda kini mempunyai asas yang kukuh untuk menyepadukan Plaid ke dalam aplikasi anda. Keupayaan untuk menyambung akaun bank pengguna dengan selamat membuka pelbagai kemungkinan untuk perkhidmatan kewangan, pengurusan wang peribadi, dan banyak lagi. Ingat untuk sentiasa mengutamakan keselamatan data dan merujuk kepada dokumentasi Plaid untuk panduan yang lebih terperinci dan ciri-ciri lanjutan.
Nota: Panduan ini menyediakan maklumat pendidikan tentang persediaan Plaid Quickstart. Ia bukan nasihat kewangan, cukai, atau pelaburan. Berunding dengan profesional bertauliah untuk nasihat khusus untuk keperluan perniagaan dan bidang kuasa anda.
Bacaan berkaitan
- Lindungi DuitNow Anda: Cara Atasi Masalah Penipuan & Keselamatan
- Kos Gratuity: Terminal Digital Pacu Kenaikan Tip Global
- Kos Penipuan: Atasi Masalah Akses Laman Web Kecurian Identiti
Sumber: Link bank accounts via open banking API oleh Plaid Quickstart
Ringkasan langkah
-
Langkah 1: Dapatkan Kunci API Plaid
Daftar di Dashboard Plaid untuk mendapatkan ID Klien dan Kunci Rahsia Sandbox anda. Kunci ini diperlukan untuk mengautentikkan aplikasi anda dengan Plaid.
-
Langkah 2: Klon dan Konfigurasi Aplikasi Quickstart
Klon repositori Quickstart dari GitHub. Kemas kini fail .env dengan Kunci API Plaid anda dan jalankan aplikasi secara tempatan menggunakan npm.
-
Langkah 3: Cipta Item Pertama Anda
Dalam aplikasi Quickstart yang berjalan, klik 'Launch Link', pilih institusi (dalam Sandbox), dan gunakan kelayakan ujian (cth. user_good, pass_good) untuk mencipta Item pertama anda.
-
Langkah 4: Panggil API /link/token/create
Di bahagian pelayan (server-side), buat permintaan ke endpoint `/link/token/create` Plaid menggunakan kunci API anda untuk mendapatkan `link_token` yang bersifat sementara.
-
Langkah 5: Inisialisasi Plaid Link dan Tukar Token
Gunakan `link_token` untuk memulakan Plaid Link di bahagian klien (client-side). Selepas pengguna berjaya log masuk, anda akan menerima `public_token`. Tukar `public_token` ini kepada `access_token` yang kekal melalui panggilan `/item/public_token/exchange`.
-
Langkah 6: Buat Permintaan API Menggunakan access_token
Gunakan `access_token` yang disimpan dengan selamat untuk membuat panggilan API Plaid lain, seperti `/accounts/get`, untuk mendapatkan maklumat akaun dan baki pengguna.
Soalan Lazim
Apakah itu Plaid Quickstart?
Plaid Quickstart ialah aplikasi contoh yang disediakan oleh Plaid untuk membantu pembangun memulakan integrasi dengan API Plaid. Ia menunjukkan aliran kerja asas untuk menyambung akaun bank pengguna.
Bagaimana saya mendapatkan kunci API Plaid?
Anda boleh mendapatkan kunci API Plaid, termasuk ID Klien dan Kunci Rahsia Sandbox, dengan mendaftar akaun di Dashboard Plaid.
Apakah itu 'Item' dalam konteks Plaid?
Item ialah istilah Plaid untuk sambungan log masuk yang berjaya ke institusi kewangan pengguna. Satu Item boleh mengaitkan berbilang akaun (cth. simpanan dan semasa) daripada satu log masuk.
Mengapa saya memerlukan `link_token` dan `access_token`?
`link_token` digunakan untuk menginisialisasi Plaid Link dan bersifat sementara. `access_token` diperoleh selepas menukar `public_token` (dari Plaid Link) dan digunakan untuk membuat panggilan API Plaid seterusnya untuk Item tersebut.
Bagaimana saya memastikan keselamatan data pengguna apabila menggunakan Plaid?
Plaid direka bentuk dengan keselamatan sebagai keutamaan. Anda mesti menyimpan `access_token` dan `item_id` dengan selamat di pelayan anda dan tidak pernah mendedahkannya di bahagian klien. Plaid menguruskan pengesahan dengan institusi kewangan.
Bolehkah saya menggunakan Plaid untuk aplikasi mudah alih?
Ya, Plaid menyediakan SDK untuk iOS dan Android, serta pustaka JavaScript untuk web. Proses asas untuk menyambung akaun adalah serupa di semua platform.