Menganotasi penilaian dengan peristiwa transaksi

Halaman ini menjelaskan cara menganotasi penilaian dengan peristiwa transaksi untuk meningkatkan kualitas model khusus situs Anda.

Untuk performa terbaik, Pencegahan Penipuan reCAPTCHA memerlukan visibilitas ke peristiwa siklus proses pembayaran untuk transaksi. Oleh karena itu, sebaiknya Anda mengirim anotasi untuk penilaian yang Anda buat dengan data transaksi. Misalnya, Anda dapat memberikan informasi transaksi ke Pencegahan Penipuan reCAPTCHA sebagai peristiwa transaksi dalam skenario berikut:

  • Penyedia pembayaran menerima atau menolak transaksi.

  • Penjual memberikan pengembalian dana.

  • Penerbit metode pembayaran mengajukan pengembalian dana.

Untuk mempelajari lebih lanjut cara mengirim anotasi, lihat Menambahkan anotasi pada penilaian.

Sebaiknya Anda membuat permintaan ini secara otomatis sebagai bagian dari logika yang sesuai di sistem Anda saat data tersedia, seperti saat status transaksi berubah.

Setelah Anda membuat penilaian dengan menyertakan data transaksi, reCAPTCHA Fraud Prevention akan menampilkan verdict dan nama penilaian. Anotasikan penilaian dengan peristiwa transaksi pada tahap penting berikut dalam siklus proses pembayaran saat peristiwa tersebut terjadi:

Jenis peristiwa Deskripsi Contoh alasan Contoh nilai
MERCHANT_APPROVE | MERCHANT_DENY Saat Anda memutuskan apakah transaksi boleh dilanjutkan. IN_HOUSE T/A
AUTHORIZATION | AUTHORIZATION_DECLINE Saat Anda mengirimkan transaksi untuk diproses, dan penerbit kartu memutuskan apakah akan mengizinkan transaksi dilanjutkan. 82 (kode alasan yang berarti CVV salah) T/A
CHARGEBACK Saat transaksi ditagih kembali. Card Reported Stolen 20 (mewakili penagihan balik sebagian sebesar 20 unit mata uang)

Bersama dengan jenis peristiwa CHARGEBACK, sertakan kode alasan penagihan balik yang diberikan oleh penerbit kartu menggunakan kolom reason. Selain itu, sertakan jumlah uang yang ditagih kembali di kolom value jika transaksi ditagih kembali sebagian.

Di kolom reason peristiwa transaksi, sertakan istilah yang menjelaskan untuk memberikan lebih banyak konteks tentang alasan peristiwa, atau berikan kode alasan yang diperoleh langsung dari jaringan pembayaran atau penerbit kartu. Istilah dan kode ini berbeda-beda, bergantung pada jenis peristiwa.

Tabel berikut menentukan daftar lengkap jenis peristiwa transaksi:

Alasan anotasi Deskripsi
MERCHANT_APPROVE Menunjukkan bahwa transaksi disetujui oleh penjual. Alasan yang menyertainya dapat mencakup istilah seperti IN_HOUSE, ACCERTIFY, CYBERSOURCE, atau MANUAL_REVIEW.
MERCHANT_DENY Menunjukkan bahwa transaksi ditolak dan diakhiri karena risiko yang terdeteksi oleh penjual. Alasan yang menyertainya dapat mencakup istilah seperti IN_HOUSE, ACCERTIFY, CYBERSOURCE, atau MANUAL_REVIEW.
MANUAL_REVIEW Menunjukkan bahwa transaksi sedang dievaluasi oleh manusia, karena kecurigaan atau risiko.
AUTHORIZATION Menunjukkan bahwa upaya otorisasi dengan penerbit kartu berhasil.
AUTHORIZATION_DECLINE Menunjukkan bahwa upaya otorisasi dengan penerbit kartu gagal. Alasan yang menyertainya dapat mencakup 54 Visa yang menunjukkan bahwa kartu telah habis masa berlakunya atau 82 yang menunjukkan bahwa CVV salah.
PAYMENT_CAPTURE Menunjukkan bahwa transaksi selesai karena dana telah diselesaikan.
PAYMENT_CAPTURE_DECLINE Menunjukkan bahwa transaksi tidak dapat diselesaikan karena dana tidak diselesaikan.
CANCEL Menunjukkan bahwa transaksi dibatalkan. Tentukan alasan pembatalan. Misalnya, INSUFFICIENT_INVENTORY.
CHARGEBACK_INQUIRY Menunjukkan bahwa penjual telah menerima permintaan penagihan balik karena penipuan untuk transaksi, yang meminta informasi tambahan sebelum penagihan balik penipuan dikeluarkan secara resmi dan notifikasi penagihan balik resmi dikirim.
CHARGEBACK_ALERT Menunjukkan bahwa penjual telah menerima pemberitahuan penagihan balik karena penipuan untuk transaksi. Proses penyelesaian sengketa tanpa melibatkan jaringan pembayaran dimulai.
FRAUD_NOTIFICATION Menunjukkan bahwa notifikasi penipuan dikeluarkan untuk transaksi, yang dikirim oleh bank penerbit instrumen pembayaran karena transaksi tersebut tampaknya bersifat menipu. Sebaiknya sertakan data TC40 atau SAFE di kolom reason untuk jenis peristiwa ini. Untuk penagihan balik sebagian, sebaiknya Anda menyertakan jumlah di kolom value.
CHARGEBACK Menunjukkan bahwa penjual diberi tahu oleh jaringan pembayaran bahwa transaksi telah memasuki proses penagihan balik karena penipuan. Contoh kode alasan mencakup 6005 dan 6041 Discover. Untuk penagihan balik sebagian, sebaiknya Anda menyertakan jumlah di kolom value.
CHARGEBACK_REPRESENTMENT Menunjukkan bahwa transaksi telah memasuki proses penagihan balik karena penipuan, dan bahwa penjual telah memilih untuk mengajukan permintaan pemulihan. Contoh alasan mencakup 6005 dan 6041 Discover. Untuk penagihan balik sebagian, sebaiknya Anda menyertakan jumlah di kolom value.
CHARGEBACK_REVERSE Menunjukkan bahwa transaksi telah mengalami penagihan balik penipuan yang tidak sah dan dibatalkan sebagai hasilnya. Untuk penagihan balik sebagian, sebaiknya Anda menyertakan jumlah di kolom value.
REFUND_REQUEST Menunjukkan bahwa penjual telah menerima pengembalian dana untuk transaksi yang telah selesai. Untuk pengembalian dana sebagian, sebaiknya sertakan jumlah di kolom value. Contoh alasan: FRAUD.
REFUND_DECLINE Menunjukkan bahwa penjual telah menerima permintaan pengembalian dana untuk transaksi ini, tetapi telah menolaknya. Untuk pengembalian dana sebagian, sebaiknya sertakan jumlah di kolom value. Contoh alasan: FRAUD.
REFUND Menunjukkan bahwa transaksi yang telah selesai dikembalikan dananya oleh penjual. Untuk pengembalian dana sebagian, sebaiknya sertakan jumlah di kolom value. Contoh alasan: PROACTIVE_FRAUD.
REFUND_REVERSE Menunjukkan bahwa transaksi yang telah selesai dikembalikan dananya oleh penjual, dan bahwa pengembalian dana ini dibatalkan. Untuk pengembalian dana sebagian, sebaiknya Anda menyertakan jumlah di kolom value.

Contoh berikut menunjukkan contoh payload anotasi yang berisi peristiwa transaksi. Untuk mengetahui detail selengkapnya, lihat Menambahkan anotasi pada penilaian.

POST https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate
{
  "transaction_event": {
    "event_type": "CHARGEBACK",
    "reason": "Card Reported Stolen",
    "value": 20
  }
}

Langkah selanjutnya