ปิดข้อพิพาท

POSThttps://api.omise.co/disputes/:id/close

ปิดข้อพิพาทหลังจากการแก้ไข Endpoint นี้สรุปข้อพิพาทที่ได้รับการแก้ไข ไม่ว่าจะผ่านการป้องกันที่ประสบความสำเร็จหรือหลังจากกระบวนการตรวจสอบเสร็จสมบูรณ์

---

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

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

▼

`id`STRING(required)

ID ข้อพิพาทที่จะปิด (พารามิเตอร์ path) ข้อพิพาทต้องอยู่ในสถานะที่อนุญาตให้ปิดได้

Example:"dspt_test_5xuy4w91xqz7d1w9u0t"

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

▼

---

การตอบกลับ

200

ปิดข้อพิพาทแล้ว

ปิดข้อพิพาทสำเร็จ ข้อพิพาทได้รับการสรุปแล้วและไม่สามารถดำเนินการเพิ่มเติมได้

หลังการปิด:

• status - ตั้งเป็นสถานะสุดท้าย (won หรือ lost)
• closed_at - ตั้งเป็นประทับเวลาปัจจุบัน
• ถ้าชนะ: เงินที่พิพาทถูกเก็บไว้โดยร้านค้า
• ถ้าแพ้: เงินที่พิพาทถูกคืนให้ลูกค้า
• ไม่สามารถทำการอัปเดตเพิ่มเติมกับข้อพิพาทนี้ได้

400

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

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

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

• รูปแบบ ID ข้อพิพาทไม่ถูกต้อง
• ค่าสถานะไม่ถูกต้อง
• ไม่มี ID ข้อพิพาท

401

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

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

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

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

404

ไม่พบ

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

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

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

422

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

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

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

• ข้อพิพาทปิดแล้ว
• สถานะข้อพิพาทไม่อนุญาตให้ปิด
• ข้อพิพาทยังอยู่ระหว่างการตรวจสอบและไม่สามารถปิดด้วยตนเอง

5xx

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

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

วิธีจัดการ:

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

---

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

cURL

curl https://api.omise.co/disputes/dspt_test_5xuy4w91xqz7d1w9u0t/close \
  -X POST \
  -u skey_test_5xuy4w91xqz7d1w9u0t: \
  -d "status=won"

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

dispute = Omise::Dispute.close('dspt_test_5xuy4w91xqz7d1w9u0t', {
  status: 'won'
})

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

dispute = omise.Dispute.close('dspt_test_5xuy4w91xqz7d1w9u0t', status='won')

Node.js

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

const dispute = await omise.disputes.close('dspt_test_5xuy4w91xqz7d1w9u0t', {
  status: 'won'
});

PHP

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

$dispute = OmiseDispute::close('dspt_test_5xuy4w91xqz7d1w9u0t', [
    'status' => 'won'
]);

Java

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

Dispute dispute = client.disputes().close("dspt_test_5xuy4w91xqz7d1w9u0t")
    .status("won")
    .send();

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var dispute = await client.Disputes.Close("dspt_test_5xuy4w91xqz7d1w9u0t", new CloseDisputeRequest
{
    Status = "won"
});

Go

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

dispute, _ := client.CloseDispute("dspt_test_5xuy4w91xqz7d1w9u0t", &operations.CloseDispute{
    Status: "won",
})

---

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

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

รหัส	คำอธิบาย	วิธีแก้ไข
authentication_failure	API key ไม่ถูกต้อง	ตรวจสอบว่า secret key ถูกต้อง
not_found	ไม่พบข้อพิพาท	ตรวจสอบว่า ID ข้อพิพาทถูกต้อง
dispute_already_closed	ข้อพิพาทปิดแล้ว	ไม่สามารถปิดข้อพิพาทที่ปิดแล้ว
invalid_dispute_status	สถานะข้อพิพาทไม่ถูกต้อง	ข้อพิพาทต้องอยู่ในสถานะที่สามารถปิดได้

ค่าสถานะสุดท้าย

สถานะ	คำอธิบาย	ผลกระทบทางการเงิน
won	ร้านค้าชนะข้อพิพาท	เงินถูกเก็บไว้โดยร้านค้า
lost	ร้านค้าแพ้ข้อพิพาท	เงินคืนให้ลูกค้า

ไทม์ไลน์การแก้ไขข้อพิพาท

ขั้นตอน	คำอธิบาย
Open	ข้อพิพาทถูกสร้าง รอการตอบกลับจากร้านค้า
Pending	ส่งการตอบกลับแล้ว อยู่ระหว่างการตรวจสอบของธนาคาร
Closed (Won/Lost)	มีการตัดสินสุดท้าย

---

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

▼

ลองใช้งาน

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

▼

id(จำเป็น)

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

▼

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