Gunakan API untuk menanggapi sengketa
Anda dapat menanggapi sengketa di Dashboard Stripe, di mana kami memandu Anda dengan mengirimkan bukti optimal untuk setiap alasan sengketa.
Anda juga dapat mengelola sengketa secara terprogram menggunakan API. Dengan API, Anda dapat mengunggah bukti, menanggapi sengketa, dan menerima kejadian sengketa menggunakan webhook.
Ambil sengketa
Untuk detail tentang sengketa, ambil objek Dispute
:
Tanggapan berisi informasi tentang sengketa dan setiap tanggapan atau bukti yang sudah diberikan.
{ object: "dispute" id: "{{DISPUTE_ID}}", charge: "ch_5Q4BjL06oPWwho", evidence: { customer_name: "Jane Austen", customer_purchase_ip: "127.0.0.1", product_description: "Widget ABC, color: red", shipping_tracking_number: "Z01234567890", uncategorized_text: "Additional notes and comments", }, evidence_details: { due_by: 1403047735, submission_count: 1 } ... }
Perbarui sengketa
Anda memperbarui objek Dispute
dan meneruskan bukti terstuktur dengan parameter evidence
.
Untuk melihat semua bidang yang tersedia untuk parameter bukti, lihat bukti Sengketa. Ada dua jenis bukti yang dapat Anda berikan, bergantung bidang yang sedang diperbarui:
- Bukti berbasis teks, seperti
customer_email
danservice_date
. Tipe bukti ini memerlukan string teks. - Bukti berbasis file, seperti
service_documentation
dancustomer_communication
. Ini menggunakan identifikasi objek file_upload.
Catatan
Gabungan jumlah karakter untuk bukti berbasis teks dibatasi hingga 150.000.
Anda dapat menyediakan dokumen atau gambar (misalnya, kontrak atau tangkapan layar) sebagai bagian dari bukti sengketa menggunakan File Upload API. Anda mengunggah dokumen terlebih dahulu dengan tujuan dispute_evidence
, yang menghasilkan objek File_upload
yang dapat digunakan ketika menyerahkan bukti. Pastikan file telah memenuhi rekomendasi Stripe sebelum mengunggahnya untuk penyerahan bukti.
Jika Anda hanya tertarik untuk mengirimkan satu file atau sejumlah besar teks biasa sebagai bukti, gunakan uncategorized_text
atau uncategorized_file
. Namun, isi kolom sebanyak mungkin sehingga Anda memiliki peluang terbaik untuk memenangkan sengkea.
Catatan
Anda harus menggunakan Dashboard untuk menyerahkan bukti bagi sengketa yang memenuhi syarat Visa Compelling Evidence 3.0, karena kami tidak mendukung penyediaan data transaksi sebelumnya melalui API.
Beberapa sengketa atas satu pembayaran
Hal ini tidak umum terjadi, tetapi mungkin saja bagi pelanggan untuk mempersengketakan pembayaran yang sama lebih dari sekali. Misalnya, pelanggan dapat mempersengketakan sebagian pembayaran untuk salah satu item dalam pesanan jika kondisinya rusak saat pengiriman, kemudian menyampaikan sengketa kedua terhadap item yang berbeda dalam pesanan yang sama karena item tersebut tidak berfungsi dengan baik.
Stripe membedakan semua sengketa dengan pengidentifikasi unik, terlepas apakah sengketa tersebut terkait dengan satu pembayaran. Saat mencantumkan sengketa, Anda dapat memfilter hasil untuk menampilkan hanya sengketa bagi pembayaran tertentu dengan menentukan id
dari objek PaymentIntent
atau Charge
dan menyertakan filter payment_intent atau filter charge.
Bila pembayaran memiliki beberapa sengketa, gunakan id
yang diberikan untuk setiap sengketa yang dikembalikan dalam daftar guna memastikan bahwa Anda menanggapi sengketa yang benar dengan menentukan id
miliknya saat Anda mengambil atau memperbarui sengketa.