Disputes API
Disputes API ช่วยให้คุณจัดการข้อพิพาทการชำระเงิน (chargebacks) ที่ลูกค้ายื่นต่อธนาคารผู้ออกบัตร เมื่อลูกค้าโต้แย้งการเรียกเก็บเงิน คุณสามารถตอบกลับพร้อมหลักฐานเพื่อโต้แย้งข้อพิพาทได้
ภาพรวม
ข้อพิพาทเกิดขึ้นเมื่อลูกค้าตั้งคำถามเกี่ยวกับการชำระเงินกับธนาคารหรือบริษัทบัตรเครดิต สาเหตุทั่วไปรวมถึง:
- ธุรกรรมฉ้อโกง - ลูกค้าไม่ได้อนุญาตการชำระเงิน
- ไม่ได้รับสินค้า - ลูกค้าอ้างว่าไม่เคยได ้รับสินค้า/บริการ
- สินค้าไม่เป็นที่ยอมรับ - สินค้าแตกต่างจากคำอธิบายอย่างมาก
- เรียกเก็บซ้ำ - ลูกค้าถูกเรียกเก็บเงินหลายครั้ง
- ไม่ได้รับเครดิตคืน - สัญญาคืนเงินแต่ไม่ได้รับ
วงจรชีวิตของข้อพิพาท
- Open - ลูกค้ายื่นข้อพิพาท เงินถูกหักจากยอดคงเหลือของคุณ
- Pending - คุณส่งหลักฐานแล้ว รอการตัดสินจากธนาคาร
- Won - ข้อพิพาทได้รับการแก้ไขในความโปรดปรานของคุณ เงินคืนกลับมา
- Lost - ข้อพิพาทได้รับการแก้ไขในความโปรดปรานของลูกค้า เงินสูญเสียถาวร
- Closed - ข้อพิพาทปิดแล้ว (รวมสถานะ won/lost)
แนวคิดหล ัก
สถานะข้อพิพาท
open- รอการตอบกลับพร้อมหลักฐานจากคุณpending- ส่งหลักฐานแล้ว อยู่ระหว่างการตรวจสอบโดยธนาคารผู้ออกบัตรwon- คุณชนะข้อพิพาทlost- คุณแพ้ข้อพิพาท
กำหนดเวลาตอบกลับ
- โดยทั่วไปคุณมีเวลา 14-21 วัน ในการตอบกลับพร้อมหลักฐาน
- พลาดกำหนดเวลาจะส่งผลให้แพ้โดยอัตโนมัติ
- ตรวจสอบวันที่
charge_dispute_atบนอ็อบเจกต์ข้อพิพาท
เอกสารหลักฐาน
หลักฐานเสริมความแข็งแกร่งให้กับกรณีของคุณ อัปโหลดเอกสารเช่น:
- หลักฐานการจัดส่ง (หมายเลขติดตาม, ใบเสร็จที่มีลายเซ็น)
- การติดต่อกับลูกค้า (อีเมล, บันทึกแชท)
- ข้อกำหนดและเงื่อนไข
- คำอธิบาย/รูปภาพสินค้า
- นโยบายคืนเงิน/ยกเลิก
Endpoints ที่ใช้ได้
- แสดงรายการข้อพิพาททั้งหมด - GET /disputes
- ดึงข้อมูลข้อพิพาท - GET /disputes/:id
- อัปเดตข้อพิพาท - PATCH /disputes/:id
- ยอมรับข้อพิพาท - PATCH /disputes/:id/accept
- ปิดข้อพิพาท - PATCH /disputes/:id/close
- แสดงรายการข้อพิพาทที่ปิดแล้ว - GET /disputes/closed
- แสดงรายการข้อพิพาทที่เปิดอยู่ - GET /disputes/open
- แสดงรายการข้อพิพาทที่รอดำเนินการ - GET /disputes/pending
- ค้นหาข้อพิพาท - GET /search?scope=dispute
สำหรับการอัปโหลดเอกสารหลักฐาน ดู Documents API
แนวปฏิบัติที่ดี
ควรทำ
- ตอบกลับอย่างรวดเร็ว ต่อข้อพิพาท - อย่ารอจนถึงกำหนดเวลา
- ให้หลักฐานที่ครอบคลุม - เอกสารมากขึ้นดีกว่า
- เก็บบันทึกโดยละเอียด - บันทึกการติดต่อกับลูกค้าและหลักฐานการจัดส่งทั้งหมด
- ตั้งค่า webhooks เพื่อรับการแจ้งเตือนทันทีเมื่อเกิดข้อพิพาท
- ใช้คำอธิบายที่ชัดเจน ในการเรียกเก็บเงินเพื่อป้องกันความสับสน
- ให้บริการลูกค้าที่ดีเยี่ยม เพื่อลดโอกาสเกิดข้อพิพาท
ไม่ควรทำ
- อย่าเพิกเฉยข้อพิพาท - ไม่ตอบกลับจะส่งผลให้แพ้โดยอัตโนมัติ
- อย่าให้หลักฐานที่ไม่เกี่ยวข้อง - มุ่งเน้นที่การตอบเหตุผลของข้อพิพาท
- อย่าคิดว่าคุณจะชนะ - ธนาคารมักเข้าข้างลูกค้า
- อย่ารอการแจ้งเตือนทางอีเมล - ใช้ webhooks สำหรับการแจ้งเตือนแบบเรียลไท ม์
รหัสข้อผิดพลาดข้อพิพาท
เมื่อจัดการข้อพิพาท อาจได้รับรหัสข้อผิดพลาดเหล่านี้:
| รหัส | ข้อความ | คำอธิบาย |
|---|---|---|
invalid_dispute | "invalid dispute" | การแก้ไขข้อพิพาทนอกพารามิเตอร์ |
documents_locked | "documents list cannot be modified" | ข้อพิพาทไม่เปิดให้อัปโหลดไฟล์แล้ว |
invalid_file_type | "invalid content-type" | ประเภทไฟล์ที่อัปโหลดไม่รองรับ |
missing_file | "missing file or filename" | อัปโหลดไฟล์โดยไม่มีเนื้อหาไฟล์ |
dispute_closed | "dispute is closed" | ไม่สามารถแก้ไขข้อพิพาทที่ปิดแล้ว |
dispute_not_found | "dispute not found" | ไม่พบ ID ข้อพิพาท |
deadline_passed | "response deadline has passed" | ไม่สามารถส่งหลักฐานหลังกำหนดเวลา |
Webhook Events
สมัครรับ events เหล่านี้เพื่อติดตามข้อพิพาท:
charge.dispute.create- ยื่นข้อพิพาทใหม่charge.dispute.update- สถานะข้อพิพาทเปลี่ยนแปลงcharge.dispute.close- ข้อพิพาทปิดแล้ว (ชนะหรือแพ้)
แหล่งข้อมูลที่เกี่ยวข้อง
ต้องการความช่วยเหลือ? ติดต่อ support@omise.co สำหรับความช่วยเหลือเรื่องข้อพิพาท