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

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

ภาพรวม

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

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

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

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

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: Base URL ของ API

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

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

ใช้ cURL

# ดูคู่มือ Authentication สำหรับวิธีสร้าง HMAC signature
curl -X POST https://api.easyslip.com/v2/verify/bank \
  -H "X-API-Key: YOUR_BRANCH_UUID" \
  -H "X-Timestamp: ${TIMESTAMP}" \
  -H "X-Nonce: ${NONCE}" \
  -H "X-Signature: ${SIGNATURE}" \
  -H "Content-Type: application/json" \
  -d '{"payload": "YOUR_QR_PAYLOAD"}'

ใช้ JavaScript

import crypto from 'crypto'

// ดูคู่มือ Authentication สำหรับ signRequest() implementation
const body = { payload: 'YOUR_QR_PAYLOAD' }
const headers = signRequest({
    method: 'POST',
    path: '/verify/bank',
    body,
    apiKey: 'YOUR_BRANCH_UUID',
    secretKey: 'YOUR_SECRET_KEY',
})

const response = await fetch('https://api.easyslip.com/v2/verify/bank', {
    method: 'POST',
    headers,
    body: JSON.stringify(body),
})

const result = await response.json()

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

ใช้ PHP

<?php
// ดูคู่มือ Authentication สำหรับ signRequest() implementation
$body = ['payload' => 'YOUR_QR_PAYLOAD'];
$headers = signRequest('POST', '/verify/bank', $body, 'YOUR_BRANCH_UUID', 'YOUR_SECRET_KEY');

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.easyslip.com/v2/verify/bank',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => array_merge(
        array_map(fn($k, $v) => "$k: $v", array_keys($headers), array_values($headers)),
        ['Content-Type: application/json']
    ),
    CURLOPT_POSTFIELDS => json_encode($body)
]);

$response = curl_exec($ch);
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
• รหัสข้อผิดพลาด - จัดการ Error อย่างถูกต้อง