Menganotasi penilaian dengan peristiwa transaksi

Dengan anotasi peristiwa transaksi di Fraud Defense, Anda dapat memberikan data siklus proses pembayaran pasca-penilaian, seperti penyelesaian, penagihan balik, dan pengembalian dana. Masukan ini membantu Anda menyempurnakan model khusus situs dan meningkatkan kualitas keputusan terkait penipuan di masa mendatang.

Untuk performa terbaik, Transaction Defense memerlukan visibilitas ke dalam 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 Transaction Defense sebagai peristiwa transaksi dalam skenario berikut:

  • Penyedia jasa pembayaran menerima atau menolak transaksi.

  • Penjual memberikan pengembalian dana.

  • Penerbit metode pembayaran mengajukan pengembalian dana.

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

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

Setelah Anda membuat penilaian dengan data transaksi yang disertakan, Transaction Defense akan menampilkan verdict dan nama penilaian. Beri anotasi pada penilaian dengan peristiwa transaksi pada tahap penting berikut dalam siklus proses pembayaran saat terjadi:

Jenis peristiwa Deskripsi Contoh alasan Contoh nilai
MERCHANT_APPROVE | MERCHANT_DENY Saat Anda memutuskan apakah transaksi harus diizinkan untuk 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 balik. 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 balik di kolom value jika transaksi ditagih balik sebagian.

Di kolom reason peristiwa transaksi, sertakan istilah klarifikasi untuk memberikan konteks lebih lanjut tentang alasan peristiwa, atau berikan kode alasan yang diperoleh langsung dari jaringan pembayaran atau penerbit kartu. Istilah dan kode ini berbeda 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 dihentikan 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 berakhir 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 belum diselesaikan.
CANCEL Menunjukkan bahwa transaksi dibatalkan. Tentukan alasan pembatalan. Misalnya, INSUFFICIENT_INVENTORY.
CHARGEBACK_INQUIRY Menunjukkan bahwa penjual telah menerima permintaan informasi penagihan balik karena penipuan untuk transaksi, yang meminta informasi tambahan sebelum penagihan balik penipuan dikeluarkan secara resmi dan notifikasi penagihan balik formal dikirim.
CHARGEBACK_ALERT Menunjukkan bahwa penjual telah menerima pemberitahuan penagihan balik karena penipuan untuk transaksi tersebut. 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 sertakan jumlah di kolom value.
CHARGEBACK_REPRESENTMENT Menunjukkan bahwa transaksi telah memasuki proses penagihan balik karena penipuan, dan bahwa penjual telah memilih untuk mengajukan representasi. Contoh alasannya mencakup 6005 dan 6041 Discover. Untuk penagihan balik sebagian, sebaiknya sertakan jumlah di kolom value.
CHARGEBACK_REVERSE Menunjukkan bahwa transaksi telah dikenai penagihan balik penipuan yang tidak sah dan akibatnya dibatalkan. Untuk penagihan balik sebagian, sebaiknya sertakan 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 mereka 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 sertakan jumlah di kolom value.

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

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

Langkah berikutnya