# Gunakan API untuk menanggapi sengketa

Mempelajari cara mengelola sengketa secara terprogram.

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](https://docs.stripe.com/disputes/responding.md).

## Ambil sengketa

Untuk detail tentang sengketa, [ambil](https://docs.stripe.com/api/disputes/retrieve.md) objek `Dispute`:

```curl
curl https://api.stripe.com/v1/disputes/{{DISPUTE_ID}} \
  -u "<<YOUR_SECRET_KEY>>:"
```

Tanggapan berisi informasi tentang sengketa dan setiap tanggapan atau bukti yang sudah diberikan.

```json
{
  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](https://docs.stripe.com/api/disputes/update.md) objek `Dispute` dan meneruskan bukti terstuktur dengan parameter `evidence`.

```curl
curl https://api.stripe.com/v1/disputes/{{DISPUTE_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  --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 `evidence`, lihat [Bukti sengketa](https://docs.stripe.com/api/disputes/update.md#update_dispute-evidence). 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](https://docs.stripe.com/api/files/object.md#file_object-id).

> Gabungan jumlah karakter untuk bukti berbasis teks dibatasi hingga 150.000.

Anda dapat menyediakan dokumen atau gambar (misalnya, kontrak atau cuplikan layar) sebagai bagian dari bukti sengketa menggunakan [File Upload API](https://docs.stripe.com/file-upload.md). 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](https://docs.stripe.com/disputes/best-practices.md#file-upload-recommendations) 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](https://docs.stripe.com/api/disputes/list.md), Anda dapat memfilter hasil untuk menunjukkan hanya sengketa untuk pembayaran tertentu dengan menentukan `id` dari objek `PaymentIntent` atau `Charge` dan menyertakan filter [payment_intent](https://docs.stripe.com/api/disputes/list.md#list_disputes-payment_intent) atau [charge](https://docs.stripe.com/api/disputes/list.md#list_disputes-charge).

#### Dengan PaymentIntent

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

#### Dengan Charge

```curl
curl -G https://api.stripe.com/v1/disputes \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d charge={{CHARGE_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](https://docs.stripe.com/disputes/api.md#retrieve-a-dispute) atau [memperbarui sengketa](https://docs.stripe.com/disputes/api.md#update-a-dispute).

## See also

- [Kategori sengketa](https://docs.stripe.com/disputes/categories.md)
- [Mengukur sengketa](https://docs.stripe.com/disputes/measuring.md)
- [Mencegah sengketa dan penipuan](https://docs.stripe.com/disputes/prevention.md)