อัปเดตข้อพิพาท

PATCHhttps://api.omise.co/disputes/:id

อัปเดตข้อพิพาทที่เปิดอยู่โดยการให้ข้อความตอบกลับและ metadata การส่งข้อความจะเปลี่ยนสถานะข้อพิพาทจาก open เป็น pending

---

พารามิเตอร์คำขอ

จำเป็น - 1 ฟิลด์พารามิเตอร์ที่จำเป็น

▼

`id`STRING(required)

ID ข้อพิพาทที่จะอัปเดต (พารามิเตอร์ path) ข้อพิพาทต้องมีสถานะ "open"

Example:"dspt_test_5xuy4w91xqz7d1w9u0t"

แนะนำ - 1 ฟิลด์พารามิเตอร์ที่แนะนำ

▼

เพิ่มเติม - 1 ฟิลด์พารามิเตอร์เพิ่มเติม

▼

---

การตอบกลับ

200

อัปเดตสำเร็จ

อัปเดตข้อพิพาทสำเร็จ ถ้าให้ข้อความ สถานะจะเปลี่ยนจาก "open" เป็น "pending"

หลังการอัปเดต:

• ถ้าให้ข้อความ: สถานะเปลี่ยนเป็น "pending" และข้อพิพาทเข้าสู่กระบวนการตรวจสอบ
• อัปโหลดเอกสารสนับสนุนโดยใช้ POST /disputes/:id/documents
• เมื่ออยู่ในสถานะ pending ไม่สามารถทำการอัปเดตเพิ่มเติมได้
• การแก้ไขโดยทั่วไปใช้เวลา 60-90 วัน

400

คำขอไม่ถูกต้อง

การตรวจสอบคำขอล้มเหลว ตรวจสอบข้อความข้อผิดพลาดสำหรับรายละเอียด

สาเหตุทั่วไป:

• รูปแบบ metadata ไม่ถูกต้อง
• Metadata เกิน 15,000 ตัวอักษร
• ข้อความยาวเกินไป

401

ไม่ได้รับอนุญาต

การยืนยันตัวตนล้มเหลว API key ไม่ถูกต้องหรือไม่มี

สาเหตุทั่วไป:

• ไม่มี Authorization header
• Secret key ไม่ถูกต้อง
• ใช้ public key แทน secret key
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

404

ไม่พบ

ไม่พบข้อพิพาท

สาเหตุทั่วไป:

• ID ข้อพิพาทไม่ถูกต้อง
• ข้อพิพาทเป็นของบัญชีอื่น
• พิมพ์ ID ผิดหรือรูปแบบผิด

422

ไม่สามารถประมวลผลได้

ไม่สามารถอัปเดตข้อพิพาทได้

สาเหตุทั่วไป:

• สถานะข้อพิพาทไม่ใช่ "open" (เป็น pending, won หรือ lost แล้ว)
• ข้อพิพาทปิดแล้วและไม่สามารถแก้ไขได้
• หมดกำหนดเวลาอัปเดตแล้ว

5xx

ข้อผิดพลาดเซิร์ฟเวอร์

เกิดข้อผิดพลาดฝั่งเซิร์ฟเวอร์ เหตุการณ์เหล่านี้เกิดขึ้นไม่บ่อยแต่ควรจัดการอย่างเหมาะสม

วิธีจัดการ:

• ลองส่งคำขอใหม่ด้วย exponential backoff
• ตรวจสอบ status.omise.co สำหรับเหตุการณ์บริการ
• ดู การจัดการข้อผิดพลาด สำหรับคำแนะนำโดยละเอียด

---

ตัวอย่างโค้ด

cURL

curl https://api.omise.co/disputes/dspt_test_5xuy4w91xqz7d1w9u0t \
  -X PATCH \
  -u skey_test_5xuy4w91xqz7d1w9u0t: \
  -d "message=Customer received product on 2025-02-01. Tracking shows delivery confirmation." \
  -d "metadata[case_id]=CASE-12345"

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

dispute = Omise::Dispute.update('dspt_test_5xuy4w91xqz7d1w9u0t', {
  message: 'Customer received product on 2025-02-01...',
  metadata: {
    case_id: 'CASE-12345'
  }
})

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

dispute = omise.Dispute.update('dspt_test_5xuy4w91xqz7d1w9u0t', {
    'message': 'Customer received product on 2025-02-01...',
    'metadata': {
        'case_id': 'CASE-12345'
    }
})

Node.js

const omise = require('omise')({
  secretKey: 'skey_test_5xuy4w91xqz7d1w9u0t'
});

const dispute = await omise.disputes.update('dspt_test_5xuy4w91xqz7d1w9u0t', {
  message: 'Customer received product on 2025-02-01...',
  metadata: {
    case_id: 'CASE-12345'
  }
});

PHP

<?php
define('OMISE_SECRET_KEY', 'skey_test_5xuy4w91xqz7d1w9u0t');

$dispute = OmiseDispute::update('dspt_test_5xuy4w91xqz7d1w9u0t', [
    'message' => 'Customer received product on 2025-02-01...',
    'metadata' => [
        'case_id' => 'CASE-12345'
    ]
]);

Java

Client client = new Client.Builder()
    .secretKey("skey_test_5xuy4w91xqz7d1w9u0t")
    .build();

Dispute dispute = client.disputes().update("dspt_test_5xuy4w91xqz7d1w9u0t")
    .message("Customer received product on 2025-02-01...")
    .metadata("case_id", "CASE-12345")
    .send();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var dispute = await client.Disputes.Update("dspt_test_5xuy4w91xqz7d1w9u0t", new UpdateDisputeRequest
{
    Message = "Customer received product on 2025-02-01...",
    Metadata = new Dictionary<string, object>
    {
        { "case_id", "CASE-12345" }
    }
});

Go

client, _ := omise.NewClient(
    "pkey_test_5xuy4w91xqz7d1w9u0t",
    "skey_test_5xuy4w91xqz7d1w9u0t",
)

dispute, _ := client.UpdateDispute("dspt_test_5xuy4w91xqz7d1w9u0t", &operations.UpdateDispute{
    Message: "Customer received product on 2025-02-01...",
    Metadata: map[string]interface{}{
        "case_id": "CASE-12345",
    },
})

---

รหัสข้อผิดพลาดและผลลัพธ์

รหัสข้อผิดพลาดทั่วไป

รหัส	คำอธิบาย	วิธีแก้ไข
bad_request	พารามิเตอร์ไม่ถูกต้อง	ตรวจสอบรูปแบบ message และ metadata
authentication_failure	API key ไม่ถูกต้อง	ตรวจสอบว่า secret key ถูกต้อง
not_found	ไม่พบข้อพิพาท	ตรวจสอบว่า ID ข้อพิพาทถูกต้อง
dispute_not_open	ข้อพิพาทไม่ได้เปิดอยู่	สามารถอัปเดตได้เฉพาะข้อพิพาทที่มีสถานะ "open"
dispute_closed	ข้อพิพาทปิดแล้ว	ไม่สามารถแก้ไขข้อพิพาทที่ปิดแล้ว

การเปลี่ยนสถานะ

ก่อน	หลัง	เงื่อนไข
open	pending	ให้ข้อความในการอัปเดต
open	open	อัปเดตเฉพาะ metadata ไม่มีข้อความ

---

🔑ข้อมูลยืนยันตัวตน API

▼

ลองใช้งาน

จำเป็น - 1 ฟิลด์

▼

id(จำเป็น)

แนะนำ - 1 ฟิลด์

▼

เพิ่มเติม - 1 ฟิลด์

▼

IP ของคุณ: ...กำลังโหลด...