สร้างข้อพิพาท

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

สร้างข้อพิพาทใหม่สำหรับการเรียกเก็บเงินที่ระบุ การดำเนินการนี้จะเริ่มกระบวนการ chargeback สำหรับธุรกรรมที่เกี่ยวข้อง

---

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

Required - 1 fieldพารามิเตอร์ที่จำเป็น

▼

`id`STRING(required)

Charge ID ที่จะสร้างข้อพิพาท (path parameter) การเรียกเก็บเงินต้องอยู่ในสถานะที่สามารถโต้แย้งได้ รูปแบบ: chrg_test_ หรือ chrg_live_ ตามด้วยสตริงตัวอักษรและตัวเลข

Example:"chrg_test_5xuy4w91xqz7d1w9u0t"

---

การตอบกลับ

200

สร้างสำเร็จ

ส่งคืนวัตถุข้อพิพาทที่สร้างใหม่พร้อมสถานะเริ่มต้นเป็น "open"

การตอบกลับประกอบด้วย:

• id - Dispute ID (คำนำหน้า dspt_test_ หรือ dspt_live_)
• object - "dispute"
• livemode - ว่าเป็นข้อพิพาทโหมด live หรือไม่
• status - สถานะเริ่มต้น (open)
• amount - จำนวนเงินที่โต้แย้งในหน่วยสกุลเงินที่เล็กที่สุด
• currency - รหัสสกุลเงิน ISO สามตัวอักษร
• reason_code - เหตุผลของข้อพิพาท
• reason_message - คำอธิบายเหตุผลที่อ่านได้
• charge - Charge ID ที่เกี่ยวข้อง
• message - ข้อความตอบกลับ (null ในตอนแรก)
• documents - รายการเอกสารหลักฐาน (ว่างในตอนแรก)
• created_at - เวลาที่สร้างข้อพิพาท
• closed_at - เวลาที่ปิดข้อพิพาท (null สำหรับข้อพิพาทที่เปิดอยู่)

400

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

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

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

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

401

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

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

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

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

404

ไม่พบ

ไม่พบการเรียกเก็บเงิน

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

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

422

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

ไม่สามารถสร้างข้อพิพาทสำหรับการเรียกเก็บเงินนี้ได้

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

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

5xx

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

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

วิธีจัดการ:

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

---

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

cURL

curl https://api.omise.co/charges/chrg_test_5xuy4w91xqz7d1w9u0t/disputes \
  -X POST \
  -u skey_test_5xuy4w91xqz7d1w9u0t:

Ruby

require 'omise'

Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'

charge = Omise::Charge.retrieve('chrg_test_5xuy4w91xqz7d1w9u0t')
dispute = charge.disputes.create

Python

import omise

omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'

charge = omise.Charge.retrieve('chrg_test_5xuy4w91xqz7d1w9u0t')
dispute = charge.disputes.create()

Node.js

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

const dispute = await omise.charges.createDispute('chrg_test_5xuy4w91xqz7d1w9u0t');

PHP

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

$charge = OmiseCharge::retrieve('chrg_test_5xuy4w91xqz7d1w9u0t');
$dispute = $charge->disputes()->create();

Java

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

Dispute dispute = client.charges().createDispute("chrg_test_5xuy4w91xqz7d1w9u0t");

C#

var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");

var dispute = await client.Charges.CreateDispute("chrg_test_5xuy4w91xqz7d1w9u0t");

Go

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

dispute, _ := client.CreateDispute("chrg_test_5xuy4w91xqz7d1w9u0t")

---

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

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

รหัส	คำอธิบาย	การแก้ไข
bad_request	พารามิเตอร์ไม่ถูกต้อง	ตรวจสอบรูปแบบ charge ID
authentication_failure	API key ไม่ถูกต้อง	ตรวจสอบว่า secret key ของคุณถูกต้อง
not_found	ไม่พบการเรียกเก็บเงิน	ตรวจสอบว่า charge ID ถูกต้อง
invalid_charge_id	รูปแบบ Charge ID ไม่ถูกต้อง	ใช้รูปแบบ chrg_ ที่ถูกต้อง
dispute_already_exists	การเรียกเก็บเงินมีข้อพิพาทอยู่แล้ว	ไม่สามารถสร้างข้อพิพาทซ้ำได้
charge_not_disputable	ไม่สามารถโต้แย้งการเรียกเก็บเงินได้	ตรวจสอบสถานะและอายุของการเรียกเก็บเงิน

ค่าสถานะข้อพิพาท

สถานะ	คำอธิบาย
open	เริ่มต้นใหม่ รอการตอบสนองของคุณ
pending	อยู่ระหว่างการตรวจสอบโดยส่งคำตอบของร้านค้าแล้ว
won	ร้านค้าชนะข้อพิพาท
lost	ร้านค้าแพ้ข้อพิพาท

รหัสเหตุผล

รหัส	คำอธิบาย
fraudulent	ลูกค้าอ้างว่าเป็นธุรกรรมที่ไม่ได้รับอนุญาต
unrecognized	ลูกค้าไม่รู้จักการเรียกเก็บเงิน
duplicate	ลูกค้าอ้างว่าเรียกเก็บเงินซ้ำ
goods_or_services_not_provided	ไม่ได้รับสินค้า/บริการ
not_as_described	สินค้าแตกต่างจากคำอธิบายอย่างมาก
credit_not_processed	สัญญาคืนเงินแต่ไม่ได้รับ
general	เหตุผลอื่นๆ

---

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

▼

ลองใช้งาน

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

▼

id(จำเป็น)

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