Verify Truemoney Wallet Slip By Image

Send a image for verification

คำอธิบาย: Endpoint นี้ใช้สำหรับตรวจสอบข้อมูลในสลิปจาก Truemoney Wallet โดยการส่งภาพ (Image)

• URL: /verify/truewallet
• Method: POST
• Headers:
  • Content-Type: multipart/form-data
  • Authorization: Bearer YOUR_ACCESS_TOKEN
• Form Data:
  • file (file, required): Slip or QR Code image from bank

Request Example (ตัวอย่างคำขอ)

curl --location 'https://developer.easyslip.com/api/v1/verify/truewallet' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--form 'file=@"slip.jpg"

Response Type (รูปแบบข้อมูลตอบกลับ)

type Data = {
    status: number
    data: {
        transactionId: string
        date: string
        amount: number
        sender: {
            name: string
        }
        receiver: {
            name: string
            phone: string
        }
    }
}

Response Example (ตัวอย่างข้อมูลตอบกลับ)

Success (HTTP 200)

{
  "status": 200,
  "data": {
    "transactionId": "00000000000000",
    "date": "2023-01-01T00:00:00+07:00",
    "amount": 1000,
    "sender": {
      "name": "อีซี่ สลิป"
    },
    "receiver": {
      "name": "อีซี่ สลิป",
      "phone": "098-***-4321"
    }
  }
}

Error (HTTP 400)

invalid_image

{
  "status": 400,
  "message": "invalid_image"
}

สาเหตุ

• ไฟล์ภาพไม่ถูกต้อง

วิธีแก้ไข

• ตรวจสอบว่าไฟล์เป็นภาพและไม่เสียหาย

image_size_too_large

{
  "status": 400,
  "message": "image_size_too_large"
}

สาเหตุ

• ขนาดไฟล์ภาพเกินกำหนด

วิธีแก้ไข

• ลดขนาดไฟล์ภาพแล้วลองใหม่

invalid_transaction_id

{
  "status": 400,
  "message": "invalid_transaction_id"
}

สาเหตุ

• หมายเลขรายการ (Transaction ID) ไม่ถูกต้อง

วิธีแก้ไข

• ตรวจสอบข้อมูลในภาพ

invalid_amount

{
  "status": 400,
  "message": "invalid_amount"
}

สาเหตุ

• จำนวนเงินไม่ถูกต้อง

วิธีแก้ไข

• ตรวจสอบความถูกต้องของจำนวนเงิน

invalid_sender_name

{
  "status": 400,
  "message": "invalid_sender_name"
}

สาเหตุ

• ชื่อผู้โอนไม่ตรงกับข้อมูลในระบบ

วิธีแก้ไข

• ตรวจสอบชื่อผู้โอนในภาพ

invalid_receiver_name

{
  "status": 400,
  "message": "invalid_receiver_name"
}

สาเหตุ

• ชื่อผู้รับไม่ตรงกับข้อมูลในระบบ

วิธีแก้ไข

• ตรวจสอบชื่อผู้รับในภาพ

invalid_receiver_phone

{
  "status": 400,
  "message": "invalid_receiver_phone"
}

สาเหตุ

• เบอร์โทรของผู้รับไม่ถูกต้อง

วิธีแก้ไข

• ตรวจสอบเบอร์โทรในภาพ

Error (HTTP 401)

unauthorized

{
  "status": 401,
  "message": "unauthorized"
}

สาเหตุ

• Access Token ไม่ถูกต้องหรือไม่ได้ใส่

วิธีแก้ไข

• ตรวจสอบใน Header และใส่ Access Token ให้ถูกต้อง

Error (HTTP 403)

access_denied

{
  "status": 403,
  "message": "access_denied"
}

สาเหตุ

• บัญชีของคุณไม่มีสิทธิ์ใช้งาน API นี้

วิธีแก้ไข

• ตรวจสอบสิทธิ์การใช้งานกับทีมสนับสนุน

account_not_verified

{
  "status": 403,
  "message": "account_not_verified"
}

สาเหตุ

• บัญชีผู้ใช้ไม่ได้ทำการยืนยัน KYC

วิธีแก้ไข

• ติดต่อทีมสนับสนุน

application_expired

{
  "status": 403,
  "message": "application_expired"
}

สาเหตุ

• ระยะเวลาการใช้งานหรือการสมัครสมาชิกของแอปพลิเคชันหมดอายุ

วิธีแก้ไข

• ตรวจสอบสถานะของแอปพลิเคชันเข้าสู่ระบบในพอร์ทัล EasySlip และตรวจสอบว่าสถานะของแอปพลิเคชันหมดอายุหรือไม่
• ดำเนินการต่ออายุการใช้งานหรือสมัครแพ็กเกจใหม่ให้เหมาะสมกับการใช้งาน
• ติดต่อฝ่ายสนับสนุน EasySlip หากแอปพลิเคชันยังอยู่ในช่วงเวลาที่ควรใช้งานได้ แต่พบปัญหา ให้ติดต่อฝ่ายสนับสนุนเพื่อตรวจสอบและแก้ไขสถานะ

application_deactivated

{
  "status": 403,
  "message": "application_deactivated"
}

สาเหตุ

• แอปพลิเคชันถูกปิดใช้งานโดยเจ้าของบัญชี หรือทีมสนับสนุนของ EasySlip
• มีการละเมิดข้อกำหนดและเงื่อนไขการใช้งาน ทำให้ระบบปิดใช้งานแอปพลิเคชันโดยอัตโนมัติ

วิธีแก้ไข

• ตรวจสอบสถานะของแอปพลิเคชันในระบบเข้าสู่ระบบในพอร์ทัล EasySlip และตรวจสอบว่าแอปพลิเคชันถูกปิดใช้งานหรือไม่หากคุณเป็นเจ้าของบัญชี ลองเปิดใช้งานแอปพลิเคชันใหม่ผ่านเมนูจัดการบัญชี
• ติดต่อฝ่ายสนับสนุน EasySlip หากแอปพลิเคชันถูกปิดใช้งานโดยไม่มีการแจ้งล่วงหน้า ให้ติดต่อทีมสนับสนุนเพื่อขอข้อมูลเพิ่มเติม

quota_exceeded

{
  "status": 403,
  "message": "quota_exceeded"
}

สาเหตุ

• คุณได้ใช้งาน API จนครบจำนวนครั้งที่โควต้าของบัญชีหรือแพ็กเกจกำหนด
• ไม่มีการเติมโควต้าหรืออัปเกรดแพ็กเกจเพื่อเพิ่มจำนวนครั้งที่สามารถใช้งานได้

วิธีแก้ไข

• ตรวจสอบสถานะโควต้าปัจจุบันเข้าสู่ระบบในพอร์ทัล EasySlip เพื่อดูจำนวนโควต้าที่เหลือหรือที่ใช้งานไปแล้ว
• เพิ่มหรือต่ออายุโควต้าดำเนินการซื้อแพ็กเกจเพิ่มเติมหรืออัปเกรดบัญชีเพื่อเพิ่มโควต้าการใช้งาน
• ติดต่อฝ่ายสนับสนุน EasySlip หากคุณเชื่อว่าข้อผิดพลาดเกิดจากระบบ หรือโควต้าควรมีเหลืออยู่ ให้ติดต่อฝ่ายสนับสนุนเพื่อตรวจสอบ

Error (HTTP 404)

slip_not_found

{
  "status": 404,
  "message": "slip_not_found"
}

สาเหตุ

• ข้อมูลสลิปที่ส่งมาไม่ถูกต้องหรือไม่ตรงกับฐานข้อมูล
• สลิปที่พยายามตรวจสอบไม่มีอยู่ในระบบ (อาจเกิดจากสลิปปลอม หรือข้อมูลที่ผิดพลาดจากธนาคารผุ้ออกสลิป)

วิธีแก้ไข

• ตรวจสอบข้อมูลที่ส่งมายืนยันว่าข้อมูล Payload, เลขอ้างอิง, หรือรายละเอียดสลิปถูกต้องครบถ้วนตรวจสอบรูปแบบของข้อมูลตามที่ระบบกำหนด
• ติดต่อฝ่ายสนับสนุน EasySlip หากมั่นใจว่าข้อมูลที่ส่งถูกต้อง แต่ยังเกิดปัญหา ให้ติดต่อทีมสนับสนุนเพื่อขอคำแนะนำเพิ่มเติม

qrcode_not_found

{
  "status": 404,
  "message": "qrcode_not_found"
}

สาเหตุ

• QR Code ที่ส่งมาอาจไม่ถูกต้อง หรือรูปแบบไม่เป็นไปตามที่ระบบรองรับ
• QR Code อาจหมดอายุ

วิธีแก้ไข

• ตรวจสอบ QR Code ที่ส่งมามีข้อมูลครบถ้วนและเป็นรูปแบบที่ถูกต้อง
• ติดต่อฝ่ายสนับสนุน EasySlip หาก QR Code ถูกต้อง แต่ยังเกิดปัญหา ให้ติดต่อทีมสนับสนุนเพื่อช่วยตรวจสอบ

Error (HTTP 500)

server_error

{
  "status": 500,
  "message": "server_error"
}

สาเหตุ

• มีข้อผิดพลาดภายในระบบเซิร์ฟเวอร์ของ Easyslip
• ปัญหาทางเทคนิค เช่น ระบบล่ม ฐานข้อมูลขัดข้อง หรือโค้ดที่ทำงานไม่ถูกต้อง
• การสื่อสารระหว่างเซิร์ฟเวอร์และบริการที่เกี่ยวข้องล้มเหลว

วิธีแก้ไข

• ลองทำคำขอใหม่ในภายหลังอาจเป็นปัญหาชั่วคราวของเซิร์ฟเวอร์ ให้รอและลองเรียกใช้ API อีกครั้ง
• ตรวจสอบคำขอยืนยันว่าคำขอที่คุณส่งถูกต้องตามเอกสาร API เช่น รูปแบบของ Payload หรือ Headers
• ติดต่อฝ่ายสนับสนุน EasySlip หากปัญหายังคงอยู่ ให้แจ้งทีมสนับสนุน พร้อมรายละเอียดคำขอ เช่น Endpoint, Request Body และเวลาที่ส่งคำขอ

api_server_error

{
  "status": 500,
  "message": "api_server_error"
}

สาเหตุ

• มีปัญหาเกี่ยวกับโครงสร้างหรือกระบวนการในระบบ API
• การเชื่อมต่อหรือกระบวนการภายในเซิร์ฟเวอร์ล้มเหลว
• มีการร้องขอที่เกินความสามารถของระบบ หรือข้อผิดพลาดทางเทคนิคที่ไม่คาดคิด

วิธีแก้ไข

• ลองทำคำขอใหม่ในภายหลังรอให้ระบบแก้ไขปัญหา และลองเรียกใช้งาน API อีกครั้ง
• ตรวจสอบคำขอที่ส่งยืนยันว่าข้อมูลในคำขอถูกต้อง เช่น URL, Header, หรือ Payload
• ติดต่อฝ่ายสนับสนุน EasySlipแจ้งรายละเอียดปัญหาให้ทีมสนับสนุนทราบ เช่น Endpoint ที่เรียกใช้ เวลาในการส่งคำขอ และ Response ที่ได้รับ