Menganotasi penilaian dengan peristiwa transaksi

Halaman ini menjelaskan cara memberi anotasi pada penilaian dengan peristiwa transaksi untuk menyempurnakan model khusus situs Anda.

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

  • Penyedia pembayaran menerima atau menolak transaksi.

  • Penjual melakukan pengembalian dana.

  • Penerbit kartu mengajukan pengembalian dana.

Untuk mempelajari lebih lanjut cara mengirim anotasi, lihat Anotasi 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, Pertahanan transaksi akan menampilkan verdict dan nama penilaian. Anotasikan 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 transaksi tersebut akan diizinkan untuk dilanjutkan. 82 (kode alasan yang berarti CVV salah) T/A
CHARGEBACK Saat transaksi dibebankan kembali. Card Reported Stolen 20 (mewakili penarikan kembali sebagian sebesar 20 unit mata uang)

Bersama dengan jenis peristiwa CHARGEBACK, sertakan kode alasan penolakan yang diberikan oleh penerbit kartu menggunakan kolom reason. Selain itu, sertakan jumlah uang yang dibebankan kembali dalam kolom value jika transaksi dibebankan kembali sebagian.

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

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 petugas, 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 masa berlaku kartu telah habis atau 82 yang menunjukkan bahwa CVV salah.
PAYMENT_CAPTURE Menunjukkan bahwa transaksi telah 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 pertanyaan penagihan balik karena penipuan untuk transaksi tersebut, yang meminta informasi tambahan sebelum penagihan balik karena penipuan secara resmi diterbitkan dan notifikasi penagihan balik formal dikirim.
CHARGEBACK_ALERT Menunjukkan bahwa penjual telah menerima pemberitahuan penolakan kartu kredit 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 alat pembayaran karena transaksi tersebut tampaknya merupakan penipuan. 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 pengembalian dana sebagian, sebaiknya sertakan jumlah di kolom value.
CHARGEBACK_REPRESENTMENT Menunjukkan bahwa transaksi telah memasuki proses penagihan balik karena penipuan, dan penjual telah memilih untuk mengajukan permohonan banding. Contoh alasan mencakup 6005 dan 6041 Discover. Untuk pengembalian dana sebagian, sebaiknya sertakan jumlah di kolom value.
CHARGEBACK_REVERSE Menunjukkan bahwa transaksi telah mengalami penarikan kembali akibat penipuan yang tidak sah dan dibatalkan sebagai akibatnya. Untuk pengembalian dana 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 menolaknya. Untuk pengembalian dana sebagian, sebaiknya Anda menyertakan 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 payload anotasi sampel yang berisi peristiwa transaksi. Untuk mengetahui detail selengkapnya, lihat Anotasi penilaian.

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

Langkah berikutnya