MaxMind minFraud Factors: kode alasan, harga, dan penggunaan
Anda membuka antrean peninjauan pagi dan membandingkan dua transaksi. Skor keduanya sekitar 1, masih jelas berada dalam batas penerimaan Anda. Keduanya masuk ke antrean karena terpilih oleh aturan sampling. Data pelanggan terlihat biasa, dan nilai pembayarannya hampir sama. Skornya tidak banyak membantu membedakan keduanya, sehingga pada pemeriksaan awal, keputusan untuk kedua transaksi tampak hampir sama. Namun, saat Anda melihat alasan di balik tiap hasil, terlihat bahwa kedua transaksi mencapai skor tersebut melalui kombinasi sinyal yang berbeda. Jika angkanya hampir sama, apa yang bisa Anda harapkan dari bukti yang mendasarinya?
Respons dan harga Factors
Factors mengembalikan semua data dari Insights, ditambah alasan di balik skor. Setiap alasan memiliki kode. MaxMind menyertakan kalimat penjelasan dan multiplier dari 0.01 hingga 100. Multiplier di atas 1 menaikkan skor, sedangkan yang di bawah 1 menurunkannya.
Biaya per kueri meningkat dari Score ke Insights, lalu ke Factors. Factors adalah yang paling mahal di antara ketiganya. Lihat halaman harga MaxMind untuk mengetahui harga terbaru.
Alasan skor menggantikan subskor yang digunakan sebelumnya. MaxMind menghentikan penggunaan subskor tersebut pada Oktober 2024 dan mengumumkan bahwa subskor akan dihapus pada Maret 2025 melalui catatan rilis.
Membandingkan skor minFraud
Dalam pengujian pada 5 Oktober 2026, satu pesanan diproses melalui Score, Insights, dan Factors dalam tiga putaran. Urutan pemanggilannya berbeda di setiap putaran, tetapi kesembilan pemanggilan menghasilkan skor 0.93. Factors mengembalikan alasan yang sama setiap kali.
Pemanggilan yang dilakukan beberapa menit sebelumnya menghasilkan skor berbeda. Riwayat jaringan berubah di antara pemanggilan tersebut. Dalam pengujian kami, saat ketiga layanan dipanggil bersamaan, harga Factors yang lebih tinggi memberikan alasan tambahan dengan skor yang sama.
Meninjau alasan skor
Pesanan dengan IP server cloud Frankfurt mendapat skor 3.08 dari Factors. Berdasarkan contoh ambang penerimaan MaxMind, yaitu 5.00 atau lebih rendah, skor ini berada di sisi yang diterima. Factors menyebut ANONYMOUS_IP ×12.5. Pesanan dengan alamat penagihan di New York mendapat skor 0.16 dan mencantumkan ISSUER_ID_NUMBER_COUNTRY_MISMATCH ×4, meskipun tidak ada detail kartu yang dikirim.
Pada grafik, pesanan Prague dengan data konsisten dan pesanan yang dikirim ke luar negeri memiliki alasan yang sama terkait alamat email baru. Untuk pesanan Prague, tiga alasan yang menurunkan skor menghasilkan skor akhir 0.80. Peninjau dapat melihat faktor yang menekan skor rendah, bukan hanya yang menaikkannya.
Daftar kode alasan
Berikut kode yang dikembalikan dalam pengujian kami, beserta penjelasan dari MaxMind:
| Kode | Alasan |
|---|---|
| ANONYMOUS_IP | Alamat IP anonim menaikkan skor risiko keseluruhan |
| EMAIL_ACTIVITY | Aktivitas alamat email di jaringan minFraud menaikkan skor risiko keseluruhan |
| EMAIL_DOMAIN | Domain email menaikkan atau menurunkan skor risiko keseluruhan |
| EMAIL_FIRST_SEEN | Alamat email yang baru pertama kali terlihat di jaringan minFraud menaikkan skor risiko keseluruhan |
| IP_ACTIVITY | Aktivitas alamat IP di jaringan minFraud menaikkan skor risiko keseluruhan |
| ISSUER_ID_NUMBER_COUNTRY_MISMATCH | Ketidakcocokan negara IP, alamat penagihan, alamat pengiriman, dan negara IIN menaikkan skor risiko keseluruhan |
| ORG_DISTANCE_RISK | Risiko ISP dan jarak antara alamat penagihan dengan lokasi alamat IP menurunkan skor risiko keseluruhan |
| SHIP_ACTIVITY | Aktivitas alamat pengiriman di jaringan minFraud menaikkan atau menurunkan skor risiko keseluruhan |
Dampak suatu kode dapat berbeda untuk setiap pesanan. EMAIL_DOMAIN menaikkan skor untuk alamat email sementara, tetapi menurunkannya untuk alamat email bisnis dalam pemanggilan lain. MaxMind menyatakan bahwa daftar kode terbaru dapat diberikan atas permintaan. Karena itu, aturan yang membaca kode perlu menangani kode yang belum dikenal.
Menggunakan alasan dalam keputusan
- Lakukan pemeriksaan Anda sendiri sebelum memanggil Factors.
- Tampilkan alasan bersama skor agar dapat ditinjau.
- Gunakan kode sebagai kondisi aturan jika kode itu memang menjadi dasar keputusan, seperti ANONYMOUS_IP.
- Pastikan setiap aturan yang membaca kode menangani kode yang belum dikenal.
- Anggap multiplier sebagai bobot pada skor, bukan sebagai probabilitas tersendiri.
- Tentukan respons aturan Anda jika pemanggilan gagal. Sumber yang gagal mengembalikan nilai kosong dengan penanda kesalahan. Sumber hanya dicoba ulang jika ditandai dapat diulang.
- Laporkan hasil transaksi melalui Report Transactions API dari MaxMind.
Contoh penggunaan
Pembuatan akun
Dalam proses pembuatan akun, alasan dapat memberi konteks kepada peninjau saat skor saja belum menunjukkan faktor yang menaikkannya. MaxMind menerima pembuatan akun sebagai jenis event.
Checkout dan pembayaran
Saat checkout, kode seperti ANONYMOUS_IP dapat langsung digunakan dalam aturan. Jika pesanan dikirim untuk ditinjau, peninjau juga dapat melihat alasan di samping skor.
Pemberian pinjaman
Dalam pengajuan kredit, alasan dapat menjadi bahan pertimbangan saat Anda melakukan peninjauan. Jika proses Anda mengharuskan adanya penjelasan kepada pemohon, jelaskan keputusan Anda sendiri. Alasan MaxMind menjelaskan dasar skornya.
Pertanyaan yang sering diajukan
Apakah daftar kode alasan selalu sama?
MaxMind hanya memberikan daftar kode terbaru atas permintaan. Karena itu, aturan yang membaca kode perlu menangani kode yang belum pernah ditemui.
Bisakah alasan ditampilkan kepada pelanggan?
Alasan tersebut menjelaskan menurut MaxMind faktor yang menaikkan atau menurunkan skornya. Anda dapat menampilkannya sebagai penjelasan dari MaxMind, tetapi pisahkan keputusan Anda sendiri beserta penjelasannya.
Mengapa alasan menyebut kartu padahal kami tidak mengirimkan detail kartu?
Dalam pengujian kami, pesanan dengan alamat penagihan di New York menghasilkan ISSUER_ID_NUMBER_COUNTRY_MISMATCH ×4, meskipun permintaan tersebut tidak menyertakan detail kartu. Responsnya tidak menjelaskan mengapa alasan itu muncul dalam kasus tersebut.
Apa arti kesalahan API?
Status 429 berarti permintaan terkena pembatasan laju dan tidak diproses. Status 402 berarti kredit akun telah habis.
| Status | Kode | Arti |
|---|---|---|
| 400 | JSON_INVALID, REQUEST_INVALID | Isi permintaan bukan JSON atau tidak memiliki input yang valid |
| 401 | AUTHORIZATION_INVALID | ID akun atau kunci lisensi salah |
| 402 | INSUFFICIENT_FUNDS | Kredit akun telah habis |
| 403 | PERMISSION_REQUIRED | Akun tidak memiliki izin untuk menggunakan layanan ini |
| 429 | none | Permintaan terkena pembatasan laju dan tidak diproses |
| 500 | SERVER_ERROR | Terjadi kesalahan saat memproses permintaan |
Untuk menyiapkan koneksi, gunakan ID akun MaxMind dan kunci lisensi sebagai satu kredensial HTTP Basic. Simpan sebagai kredensial, lalu minta asisten mengatur sumber data berdasarkan dokumentasi permintaan MaxMind.