Gunakan API untuk menanggapi sengketa

Anda dapat secara terprogram mengelola sengketa menggunakan API. Dengan API, Anda dapat mengunggah bukti, merespons sengketa, dan menerima peristiwa sengketa menggunakan webhook.

Jika Anda ingin mengelola sengketa menggunakan Dashboard, sebagai ganti menggunakan API, lihat Menanggapi sengketa.

Ambil sengketa

Untuk detail tentang sengketa, ambil objek Sengketa:

curl https://api.stripe.com/v1/disputes/
{{DISPUTE_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

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 Sengketa dan meneruskan bukti terstuktur dengan parameter bukti.

curl https://api.stripe.com/v1/disputes/
{{DISPUTE_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode "evidence[customer_email_address]"="email@example.com" \
  -d "evidence[shipping_date]"=2024-02-01 \
  -d "evidence[shipping_documentation]"=
"{{FILE_ID}}"

Untuk melihat semua bidang yang tersedia bagi parameter bukti, lihat Bukti sengketa. Ada dua tipe bukti yang dapat Anda berikan, bergantung pada bidang yang sedang diperbarui:

• Bukti berbasis teks, seperti customer_email dan service_date. Tipe bukti ini memerlukan string teks.
• Bukti berbasis file, seperti service_documentation dan client_communication. Ini menggunakan identifikasi objek file_upload.

Anda dapat menyediakan dokumen atau gambar (misalnya, kontrak atau cuplikan 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.

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 dari apakah mereka terkait dengan satu pembayaran. Ketika mendaftarkan sengketa, Anda dapat memfilter hasil untuk menunjukkan hanya sengketa untuk pembayaran tertentu dengan menentukan id dari objek PaymentIntent atau Charge dan menyertakan filter payment_intent atau charge.

curl -G https://api.stripe.com/v1/disputes \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d payment_intent={{PAYMENT_INTENT_ID}}

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.