Documents API
Documents API ช่วยให้คุณสามารถสร้าง ดึงข้อมูล และลบไฟล์เอกสารเพื่อช่วยในการแก้ไขข้อพิพาท เอกสารเช่น ใบเสร็จที่สแกน ใบส่งสินค้า และการติดต่อกับลูกค้าจะถูกใช้เป็นหลักฐานในกระบวนการแก้ไขข้อพิพาท
ภาพรวม
เอกสารคือไฟล์ที่อัปโหลดเพื่อสนับสนุนกรณีของคุณในระหว่างข้อพิพาท เมื่อลูกค้ายื่นคำร้องขอคืนเงิน (chargeback) การให้หลักฐานเอกสารที่ชัดเจนจะเพิ่มโอกาสในการชนะข้อพิพาท
ประเภทไฟล์ที่รองรับ
| รูปแบบ | MIME Type | ขนาดสูงสุด |
|---|---|---|
| PNG | image/png | 10MB |
| JPG/JPEG | image/jpeg | 10MB |
| application/pdf | 10MB |
ประเภทเอกสาร
ใช้พารามิเตอร์ kind เพื่อจัดหมวดหมู่หลักฐานของคุณ:
| Kind | คำอธิบาย | ตัวอย่างเอกสาร |
|---|---|---|
cardholder_details | การยืนยันตัวตนลูกค้า | บัตรปร ะชาชน หลักฐานที่อยู่สำหรับเรียกเก็บเงิน |
details_of_purchase | รายละเอียดธุรกรรมและคำสั่งซื้อ | ใบแจ้งหนี้ การยืนยันคำสั่งซื้อ ใบเสร็จ |
proof_of_receipt | การยืนยันการจัดส่งหรือบริการ | ข้อมูลการติดตาม ใบรับสินค้าที่มีลายเซ็น |
proof_of_acceptance | การรับทราบจากลูกค้า | การติดต่อทางอีเมล การยอมรับเงื่อนไข |
Endpoints ที่ใช้งานได้
- อัปโหลดเอกสาร - POST /disputes/:id/documents
- ดึงข้อมูลเอกสาร - GET /disputes/:id/documents/:document_id
- แสดงรายการเอกสาร - GET /disputes/:id/documents
- ลบเอกสาร - DELETE /disputes/:id/documents/:document_id
Document Object
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
object | string | เป็น "document" เสมอ |
id | string | ตัวระบุเอกสาร (docu_*) |
livemode | boolean | ระบุว่าเป็นเอกสารโหมด live หรือ test |
location | string | เส้นทาง API สำหรับดึงข้อมูลเอกสาร |
deleted | boolean | ระบุว่าเอกสารถูกลบแล้วหรือไม่ |
filename | string | ชื่อไฟล์ต้นฉบับของเอกสารที่อัปโหลด |
kind | string | ประเภทเอกสาร (cardholder_details เป็นต้น) |
download_uri | string | URL ชั่วคราวสำหรับดาวน์โหลดเอกสาร |
created_at | string | วันที่อัปโหลดเอกสาร (ISO 8601) |
แนวทางปฏิบัติที่ดี
การอัปโหลดหลักฐาน
- ให้เอกสารที่ชัดเจนและอ่านได้ - ตรวจสอบให้แน่ใจว่าภาพมีคุณภาพสูงและข้อความอ่านได้
- ใช้ชื่อไฟล์ที่สื่อความหมาย - ช่วยจัดระเบียบและระบุเอกสาร
- จัดหมวดหมู่อย่างถูกต้อง - ใช้ค่า
kindที่เหมาะสม - อัปโหลดทันที - อย่ารอจนถึงกำหนดเส้นตาย
หลักฐานที่แนะนำตามประเภทข้อพิพาท
| เหตุผลข้อพิพาท | หลักฐานที่แนะนำ |
|---|---|
| ฉ้อโกง | ใบรับสินค้าที่มีลายเซ็น การยืน ยัน AVS/CVV การติดต่อกับลูกค้า |
| ไม่ได้รับสินค้า | หมายเลขติดตาม การยืนยันการจัดส่ง บันทึกของบริษัทขนส่ง |
| สินค้าไม่ตรงตามที่คาดหวัง | รายละเอียดสินค้า รูปภาพ นโยบายการคืนสินค้า การติดต่อกับลูกค้า |
| เรียกเก็บซ้ำ | บันทึกธุรกรรมที่แสดงการเรียกเก็บครั้งเดียว |
| ไม่ได้ดำเนินการคืนเงิน | การยืนยันการคืนเงิน เอกสารนโยบาย |
หมายเหตุสำคัญ
- สามารถอัปโหลดเอกสารได้เฉพาะข้อพิพาทที่มีสถานะ
openเท่านั้น - เมื่อข้อพิพาทเปลี่ยนเป็น
pendingจะไม่สามารถแก้ไขเอกสารได้ - URL สำหรับดาวน์โหลดเป็นแบบชั่วคราวและจะหมดอายุ
- ขนาดไฟล์สูงสุดคือ 10MB ต่อเอกสาร
แหล่งข้อมูลที่เกี่ยวข้อง
ต้องการความช่วยเหลือ? ติดต่อ support@omise.co สำหรับความช่วยเหลือเกี่ยวกับหลักฐานข้อพิพาท