Disputes API
การใช้ Disputes API ช่วยให้คุณจัดการข้อพิพาทการชำระเงิน (chargebacks) ที่ลูกค้ายื่นกับธนาคารผู้ออกบัตรของพวกเขาได้ เมื่อลูกค้าโต้แย้งการชำระเงิน คุณสามารถส่งหลักฐานเพื่อตอบสนองต่อข้อพิพาทได้
ภาพรวม
ข้อพิพาทเกิดขึ้นเมื่อลูกค้าตั้งคำถามเกี่ยวกับการชำระเงินกับธนาคารหรือบริษัทบัตรเครดิตของพวกเขา เหตุผลทั่วไปมีดังนี้
- ธุรกรรมฉ้อโกง - ลูกค้าไม่ได้อนุมัติการชำระเงิน
- ไม่ได้รับสินค้า - ลูกค้าอ้างว่าไม่ได้รับสินค้าหรือบริกา ร
- สินค้าไม่เป็นที่ยอมรับ - สินค้าแตกต่างจากคำอธิบายอย่างมาก
- การเรียกเก็บเงินซ้ำ - ลูกค้าถูกเรียกเก็บเงินหลายครั้ง
- ไม่ได้ประมวลผลการคืนเงิน - สัญญาว่าจะคืนเงินแต่ยังไม่ได้รับ
วงจรชีวิตของข้อพิพาท
- เปิด - ลูกค้ายื่นข้อพิพาทและเงินถูกถอนจากยอดคงเหลือของคุณ
- รอดำเนินการ - ส่งหลักฐานแล้ว กำลังรอการตัดสินใจของธนาคาร
- ชนะ - ข้อพิพาทได้รับการแก้ไขในความโปรดปรานของคุณและคืนเงิน
- แพ้ - ข้อพิพาทได้รับการแก้ไขในความโปรดปรานของลูกค้าและสูญเสียเงินถาวร
- ปิด - ข้อพิพาทถูกปิด (รวมถึงสถานะชนะหรือแพ้)
แนวคิดหลัก
สถานะข้อพิพาท
open- กำลังรอการตอบสนองด้วยหลักฐานpending- ส่งหลักฐานแล้ว อยู่ระหว่างการพิจารณาโดยธนาคารผู้ออกบัตรwon- ชนะข้อพิพาทlost- แพ้ข้อพิพาท
กำหนดเวลาการตอบสนอง
- โดยปกติคุณจะมีระยะเวลา 14-21 วัน เพื่อส่งหลักฐาน
- หากพ้นกำหนดเวลาจะแพ้โดยอัตโนมัติ
- โปรดตรวจสอบวันที่
charge_dispute_atในออบเจ็กต์ข้อพิพาท
เอกสารหลักฐาน
หลักฐานช่วยเสริมสร้างความแข็งแกร่งให้กับกรณีของคุณ คุณสามารถอัปโหลดเอกสารต่างๆ ดังนี้
- หลักฐานการจัดส่ง (หมายเลขติดตาม, ใบเสร็จรับเงินที่มีลายเซ็น)
- การติดต่อสื่อสารกับลูกค้า (อีเมล, บันทึกการแชท)
- ข้อกำหนดและเงื่อนไข
- คำอธิบายและรูปภาพสินค้า
- นโยบายการคืนเงินและการยกเลิก
เอนด์พอยต์ที่มีให้ใช้งาน
- แสดงรายการข้อพิพาททั้งหมด - GET /disputes
- ดึงข้อมูลข้อพิพาท - GET /disputes/:id
- อัปเดตข้อพิพาท - PATCH /disputes/:id
- แสดงรายการข้อพิพาทที่ปิดแล้ว - GET /disputes/closed
- แสดงรายการข้อพิพาทที่เปิดอยู่ - GET /disputes/open
- แสดงรายการข้อพิพาทที่รอดำเนินการ - GET /disputes/pending
- อัปโหลดเอกสาร - POST /disputes/:id/documents
แนวทางปฏิบัติที่ดีที่สุด
✅ ข้อแนะนำ
- ตอบสนองอย่างรวดเร็ว - อย่ารอจนถึงกำหนดเวลา โปรดตอบสนองต่อข้อพิพาทโดยเร็ว
- ให้หลักฐาน ที่ครอบคลุม - ขอแนะนำให้ส่งเอกสารให้มากที่สุด
- เก็บบันทึกโดยละเอียด - บันทึกการสื่อสารกับลูกค้าและหลักฐานการจัดส่งทั้งหมด
- ตั้งค่า Webhook - เพื่อให้ได้รับการแจ้งเตือนทันทีที่มีข้อพิพาทเกิดขึ้น
- ใช้คำอธิบายที่ชัดเจน - ใส่คำอธิบายที่ชัดเจนในการชำระเงินเพื่อป้องกันความสับสน
- ให้บริการลูกค้าที่ยอดเยี่ยม - ลดโอกาสที่จะเกิดข้อพิพาท
❌ สิ่งที่ควรหลีกเลี่ยง
- อย่าเพิกเฉยต่อข้อพิพาท - การไม่ตอบสนองจะทำให้แพ้โดยอัตโนมัติ
- อย่าให้หลักฐานที่ไม่เกี่ยวข้อง - มุ่งเน้นที่การแก้ไขเหตุผลของข้อพิพาท
- อย่าคิดว่าจะชนะแน่นอน - ธนาคารมักจะให้ความสำคัญกับลูกค้าเป็นหลัก
- อย่ารอการแจ้งเตือนทางอีเมล - ใช้ Webhook เพื่อรับการแจ้งเตือนแบบเรียลไทม์
เหตุการณ์ Webhook
สมัครรับเหตุการณ์ต่อไปนี้เพื่อติดตามข้อพิพาท
charge.dispute.create- มีการยื่นข้อพิพาทใหม่charge.dispute.update- สถานะข้อพิพาทเปลี่ยนแปลงcharge.dispute.close- ข้อพิพาทถูกปิด (ชนะหรือแพ้)
ทรัพยากรที่เกี่ยวข้อง
ต้องการความช่วยเหลือหรือไม่? โปรดติดต่อ support@omise.co สำหรับการสนับสนุนเกี่ยวกับข้อพิพาท