Gunakan API untuk menanggapi sengketa

Anda dapat menanggapi sengketa di Dashboard Stripe, tempat kami memandu Anda melalui penyerahan 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:

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

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 customer_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 apakah sengketa tersebut terkait dengan satu pembayaran. Saat mencantumkan sengketa, Anda dapat memfilter hasil untuk memperlihatkan hanya sengketa bagi pembayaran tertentu dengan menentukan id dari objek PaymentIntent atau Charge dan menyertakan filter payment_intent atau filter 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.