ข้ามไปยังเนื้อหาหลัก
เวอร์ชัน: ล่าสุด

รับรายการข้อพิพาทที่ปิดแล้ว

ดึงรายการแบบแบ่งหน้าของข้อพิพาทที่ปิดแล้วทั้งหมด ข้อพิพาทที่ปิดแล้วประกอบด้วยทั้งข้อพิพาทที่ชนะ (คืนเงิน) และข้อพิพาทที่แพ้ (เงินถูกริบ)


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

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

Additional - 5 fieldsAdditional Parameters

การตอบกลับ

200

ดึงข้อมูลสำเร็จ

ส่งกลับอ็อบเจ็กต์รายการที่ประกอบด้วยอ็อบเจ็กต์ข้อพิพาทที่ปิดแล้วเท่านั้น ซึ่งมีสถานะ "won" หรือ "lost"

ลักษณะของข้อพิพาทที่ปิดแล้ว:
  • status - เป็น "won" (ผู้ค้าชนะ) หรือ "lost" (ผู้ค้าแพ้)
  • closed_at - ตราประทับเวลา ISO 8601 เมื่อข้อพิพาทได้รับการแก้ไข
  • message - ข้อความตอบกลับที่ให้ไว้ (หากมี)
  • documents - เอกสารหลักฐานที่ส่งไป
  • ข้อพิพาทที่ชนะ: เงินจะถูกคืนให้กับบัญชีผู้ค้า
  • ข้อพิพาทที่แพ้: เงินจะถูกริบให้กับลูกค้าอย่างถาวร

400

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

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

สาเหตุที่พบบ่อย:
  • รูปแบบวันที่ไม่ถูกต้อง (ต้องเป็น ISO 8601)
  • limit เกินค่าสูงสุด (100)
  • พารามิเตอร์ order ไม่ถูกต้อง
  • ค่า offset หรือ limit เป็นลบ

401

ไม่ได้รับการยืนยันตัวตน

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

สาเหตุที่พบบ่อย:
  • ไม่มี Authorization header
  • secret key ไม่ถูกต้อง
  • ใช้ public key แทน secret key
  • รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

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

curl https://api.omise.co/disputes/closed \
-u skey_test_5xuy4w91xqz7d1w9u0t: \
-d "limit=20" \
-d "offset=0"

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

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

CodeDescriptionResolution
bad_requestพารามิเตอร์ไม่ถูกต้องตรวจสอบรูปแบบวันที่และค่าพารามิเตอร์
authentication_failureAPI key ไม่ถูกต้องตรวจสอบว่า secret key ของคุณถูกต้อง
invalid_date_formatวันที่ไม่อยู่ในรูปแบบ ISO 8601ใช้รูปแบบ YYYY-MM-DDTHH:MM:SSZ

ค่าสถานะของข้อพิพาทที่ปิดแล้ว

StatusDescriptionFinancial Impact
wonผู้ค้าชนะข้อพิพาทเงินถูกคืนให้กับบัญชีผู้ค้า
lostผู้ค้าแพ้ข้อพิพาทเงินถูกริบให้กับลูกค้าอย่างถาวร

ทดลองใช้งาน

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