เริ่มต้นใช้งาน

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

ภาพรวม

EasySlip API มีความสามารถ:

• ตรวจสอบสลิปธนาคาร - ตรวจสอบสลิปโอนเงินจากธนาคารไทย 18+ แห่ง
• ตรวจสอบ TrueMoney Wallet - ตรวจสอบการโอนเงิน TrueMoney Wallet (v1 เท่านั้น)
• สร้าง QR Code - สร้าง QR Code พร้อมเพย์และร้านค้า (v1 เท่านั้น)
• ตรวจจับสลิปซ้ำ - ป้องกันการใช้สลิปซ้ำ

สิ่งที่ต้องเตรียม

ก่อนเริ่มต้น คุณต้องมี:

1. บัญชี EasySlip Developer
2. API Key จาก Developer Portal
3. ความรู้พื้นฐานเกี่ยวกับ REST API

ขั้นตอนที่ 1: สร้างบัญชี

1. เข้าไปที่ developer.easyslip.com
2. คลิก สมัครสมาชิก และกรอกข้อมูลการลงทะเบียน
3. ยืนยันอีเมลของคุณ
4. ทำ KYC ให้เรียบร้อย (จำเป็นสำหรับการใช้งานจริง)

ขั้นตอนที่ 2: รับ API Key

1. เข้าสู่ระบบที่ Developer Portal
2. ไปที่ แอปพลิเคชัน > สร้างแอปพลิเคชันใหม่
3. ตั้งชื่อแอปพลิเคชันและเลือกแพ็กเกจ
4. คัดลอก API Key จากหน้า Dashboard

เก็บ API Key ให้ปลอดภัย

อย่าเปิดเผย API Key ในโค้ด Client-side หรือ Repository สาธารณะ ใช้ Environment Variables หรือระบบจัดการ Key ที่ปลอดภัย

ขั้นตอนที่ 3: เลือกเวอร์ชัน API

EasySlip มี 2 เวอร์ชัน:

API v2 (แนะนำ)

• Base URL: https://api.easyslip.com/v2
• รูปแบบ Response ที่ทันสมัยและสม่ำเสมอ
• จับคู่บัญชี & ตรวจสอบจำนวนเงิน
• รองรับหลาย Branch
• Error Handling ที่ดีขึ้น

API v1 (Legacy)

• Base URL: https://developer.easyslip.com/api/v1
• ตรวจสอบ TrueMoney Wallet
• สร้าง QR Code
• เสถียรและผ่านการทดสอบอย่างดี

TIP

สำหรับโปรเจกต์ใหม่ เราแนะนำ API v2 เพราะมีฟีเจอร์ที่ดีกว่าและมีความสม่ำเสมอมากกว่า

ขั้นตอนที่ 4: ทำ API Call แรก

ใช้ cURL

curl -X POST https://api.easyslip.com/v2/verify/bank \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payload": "YOUR_QR_PAYLOAD"}'

ใช้ JavaScript

const response = await fetch('https://api.easyslip.com/v2/verify/bank', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    payload: 'YOUR_QR_PAYLOAD'
  })
});

const result = await response.json();

if (result.success) {
  console.log('ตรวจสอบสำเร็จ:', result.data);
} else {
  console.error('ตรวจสอบล้มเหลว:', result.error);
}

ใช้ PHP

<?php
$apiKey = 'YOUR_API_KEY';
$payload = 'YOUR_QR_PAYLOAD';

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.easyslip.com/v2/verify/bank',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode(['payload' => $payload])
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$result = json_decode($response, true);

if ($result['success']) {
    echo "ตรวจสอบสำเร็จ!";
    print_r($result['data']);
} else {
    echo "Error: " . $result['error']['message'];
}

ขั้นตอนที่ 5: จัดการ Response

Response สำเร็จ

{
  "success": true,
  "data": {
    "rawSlip": {
      "payload": "00000000...",
      "transRef": "68370160657749I376388B35",
      "date": "2024-01-15T14:30:00+07:00",
      "countryCode": "TH",
      "amount": {
        "amount": 1000,
        "local": {
          "amount": 1000,
          "currency": "THB"
        }
      },
      "sender": {
        "bank": {
          "id": "004",
          "name": "กสิกรไทย",
          "short": "KBANK"
        },
        "account": {
          "name": {
            "th": "นาย ทดสอบ ระบบ",
            "en": "MR. TEST SYSTEM"
          }
        }
      },
      "receiver": {
        "bank": {
          "id": "014",
          "name": "ไทยพาณิชย์",
          "short": "SCB"
        },
        "account": {
          "name": {
            "th": "นาย รับเงิน ทดสอบ"
          }
        }
      }
    }
  },
  "message": "Bank slip verified successfully"
}

Response Error

{
  "success": false,
  "error": {
    "code": "SLIP_NOT_FOUND",
    "message": "The slip could not be found or is invalid"
  }
}

ขั้นตอนถัดไป

• การยืนยันตัวตน - เรียนรู้เกี่ยวกับการยืนยันตัวตน API
• API v2 Reference - สำรวจ Endpoints ของ v2
• API v1 Reference - สำรวจ Endpoints ของ v1
• รหัสข้อผิดพลาด - จัดการ Error อย่างถูกต้อง