Verifikasi Akses

Untuk memastikan bahwa hanya bisnis dengan kasus penggunaan yang sah dapat mengakses data bisnis lain, beberapa endpoint API melakukan pemeriksaan verifikasi ketika dihubungi oleh aplikasi yang telah dibuat atau diklaim oleh bisnis, atau oleh aplikasi bisnis yang belum terhubung dengan sebuah bisnis. Jika bisnis yang membuat, mengeklaim, atau terhubung ke aplikasi telah terverifikasi sebagai Penyedia Layanan Teknologi, endpoint akan memproses permintaan secara normal. Jika bisnis belum terverifikasi sebagai Penyedia Layanan Teknologi, endpoint akan menolak panggilan dan menampilkan kesalahan.

Verifikasi akses adalah proses yang kami gunakan untuk menentukan apakah bisnis beroperasi sebagai Penyedia Layanan Teknologi.

Bisnis mana yang membutuhkan verifikasi akses?

Bisnis apa pun yang telah membuat atau mengeklaim aplikasi yang akan digunakan oleh bisnis lain dan memerlukan izin apa pun yang tercantum di bawah harus diverifikasi sebagai Penyedia Layanan Teknologi sebelum bisnis lain dapat menggunakan aplikasi tersebut.

Perhatikan bahwa verifikasi akses independen dari Tinjauan Aplikasi dan izin level akses.

Izin

Pemeriksaan Verifikasi

Ketika sebuah aplikasi yang diklaim oleh bisnis memanggil endpoint yang membutuhkan izin yang tercantum di atas, endpoint pertama-tama akan memeriksa apakah orang yang memberikan izin memiliki peran pada aplikasi itu sendiri. Jika orang tersebut memang memiliki peran di aplikasi, endpoint menerima panggilan dan terus memproses permintaan.

Jika orang tersebut tidak memiliki peran pada aplikasi, namun, endpoint memeriksa apakah bisnis pengeklaim aplikasi telah terverifikasi sebagai Penyedia Layanan Teknologi. Jika bisnis belum terverifikasi sebagai Penyedia Layanan Teknologi, endpoint memproses permintaan secara normal, jika tidak, endpoint akan menolak panggilan dan menampilkan kesalahan berikut:

• Kode kesalahan: 100
• Deskripsi: Unsupported get request. Object with ID {object-id} does not exist, cannot be loaded due to missing permissions, or does not support this operation.

Lihat dokumentasi Kode Kesalahan Marketing API untuk informasi selengkapnya tentang kode kesalahan.

Perhatikan bahwa pemeriksaan verifikasi dilakukan pada bisnis pengeklaim aplikasi tetapi hanya terpicu ketika aplikasi yang telah mengklaim memanggil endpoint yang telah menerapkan pemeriksaan verifikasi. Ini berarti bahwa setelah sebuah bisnis telah terverifikasi sebagai Penyedia Layanan Teknologi, setiap aplikasi yang diklaim akan lulus pemeriksaan verifikasi.

Cara menyelesaikan verifikasi akses

Admin bisnis dari bisnis Penyedia Layanan Teknologi yang tidak terverifikasi yang mengeklaim aplikasi baru akan mendapat notifikasi email tentang persyaratan verifikasi akses kapan saja administrator aplikasi meminta Akses Lanjutan untuk semua izin yang tercantum di atas.

Email itu akan menyertakan tautan ke formulir verifikasi, tetapi formulir tersebut juga dapat diakses dari Dasbor Aplikasi dengan membuka panel Dasar > Verifikasi > Verifikasi akses.

Untuk menyelesaikan verifikasi, setiap orang dengan akses Admin di bisnis harus mengategorikan dan menjelaskan bagaimana bisnis menggunakan data bisnis lain untuk menyediakan layanan bagi bisnis tersebut.

Setelah admin bisnis menyelesaikan prosesnya, keputusan akan diambil dalam waktu kurang lebih 5 hari.

Jika bisnis diverifikasi sebagai Penyedia Layanan Teknologi, admin bisnis akan menerima email konfirmasi dan admin aplikasi akan menerima pemberitahuan developer berisi konfirmasi. Bisnis terverifikasi tidak perlu memverifikasi lagi, namun, dalam kondisi tertentu, bisnis mungkin sementara kehilangan status terverifikasinya.

Jika bisnis ditolak verifikasinya sebagai Penyedia Layanan Teknologi, admin bisnis akan menerima email penolakan dan admin aplikasi akan menerima pemberitahuan developer berisi penolakan, dan semua panggilan ke endpoint yang membutuhkan izin di atas akan gagal jika pengguna aplikasi telah tidak memiliki peran pada aplikasi yang memanggil.

Jika kasus penggunaan bisnis yang ditolak berubah, seorang admin bisnis dapat menyelesaikan prosesnya lagi untuk dipertimbangkan kembali.

Prasyarat

Sebelum admin bisnis bisa memulai proses verifikasi akses:

• seorang admin bisnis harus menyelesaikan Verifikasi Bisnis
• harus tidak ada batasan pada akun bisnis

Bisnis yang Sudah Ada

Admin bisnis yang telah mengeklaim aplikasi yang digunakan oleh bisnis lain dan membutuhkan izin di atas secara otomatis akan dikirimi email tentang persyaratan verifikasi akses. Administrator aplikasi juga akan menerima pemberitahuan developer tentang persyaratan ini.

Setelah email terkirim, admin bisnis memiliki waktu 60 hari untuk menyelesaikan proses verifikasi. Jika proses tidak selesai dalam waktu 60 hari, semua panggilan ke endpoint yang memerlukan izin di atas secara bertahap akan dikenakan pemeriksaan verifikasi.

Kehilangan Status Terverifikasi

Bisnis yang telah diverifikasi sebagai Penyedia Layanan Teknologi akan dianggap belum terverifikasi dalam kondisi berikut:

Setelah kondisi ini dibalik, bisnis secara otomatis akan dianggap sebagai Penyedia Layanan Teknologi terverifikasi lagi.

Lihat Juga

• Penyedia Layanan Teknologi