README

PHP SDK สำหรับเรียกใช้ Check AccName API — ตรวจสอบชื่อเจ้าของบัญชีธนาคารจากเลขบัญชี · รองรับทุกธนาคารในไทย

Use cases: ระบบประมูล · ระบบ Affiliate · ระบบถอนเงิน · ป้องกันสมัครซ้ำ · KYC

Features

• ✅ ตรวจสอบชื่อเจ้าของบัญชี (PromptPay + ORFT) ทุกธนาคารในไทย
• ✅ แยกคำนำหน้า / ชื่อ / นามสกุลอัตโนมัติ + รองรับนิติบุคคล
• ✅ Type-safe DTO (typed properties)
• ✅ Exception hierarchy แยกประเภท Auth / RateLimit / Inquiry / Network
• ✅ Zero deps · ใช้แค่ ext-curl + ext-json
• ✅ MIT License

Requirements

• PHP 8.0+
• ext-curl, ext-json
• Bearer token (ขอฟรีที่ https://check.gudevindy.com — login ด้วย LINE)

Install

composer require gudevindy/checkaccname

Quick Start

<?php
require 'vendor/autoload.php';

use GuDevIndy\CheckAccName\Client;

$client = new Client('YOUR-BEARER-TOKEN');

$result = $client->inquiry(bankCode: '004', accountNo: '1234567890');

echo $result->beneficiaryName;     // "นาย สมชาย ใจดี"
echo $result->title;               // "นาย"
echo $result->firstName;           // "สมชาย"
echo $result->lastName;            // "ใจดี"

Get a Token

1. ไปที่ https://check.gudevindy.com
2. กด Login with LINE
3. หน้า Dashboard → คัดลอก API Token
4. แผน Free 20 ครั้ง/วัน · Starter 50/วัน · Enterprise 2,000/วัน

API

new Client(string $token, array $options = [])

inquiry(string $bankCode, string $accountNo): InquiryResult

ตรวจสอบชื่อเจ้าของบัญชี · ค่า return เป็น InquiryResult (readonly DTO)

$r = $client->inquiry('004', '1234567890');

$r->beneficiaryName;        // "นาย สมชาย ใจดี"
$r->beneficiaryNoMasking;   // "xxx-x-x7890-x"
$r->title;                  // "นาย"
$r->firstName;              // "สมชาย"   (null ถ้า isCompany)
$r->lastName;               // "ใจดี"   (null ถ้า isCompany)
$r->isCompany;              // false
$r->companyName;            // null     (มีค่าเมื่อ isCompany=true)
$r->bankCode;               // "004"
$r->bankAbv;                // "KBANK"
$r->blacklisted;            // bool — ถูกรายงานเกิน threshold
$r->reportCount;            // int  — จำนวน reports approved
$r->lookupsLast24h;         // int  — จำนวน user ค้นหาบัญชีนี้ใน 24 ชม.
$r->suspicious;             // bool — lookupsLast24h ≥ threshold
$r->cached;                 // bool — server ตอบจาก cache หรือไม่

// ถ้าอยากเป็น array
$r->toArray();

Error Handling

use GuDevIndy\CheckAccName\Client;
use GuDevIndy\CheckAccName\Exception\{
    AuthException,
    RateLimitException,
    InquiryException,
    NetworkException,
    CheckAccNameException,
};

$client = new Client(getenv('TOKEN'));

try {
    $r = $client->inquiry('004', '1234567890');
    echo $r->beneficiaryName;
} catch (AuthException $e) {
    // 401/403 — token ไม่ถูกต้อง / หมดอายุ / ถูก revoke
} catch (RateLimitException $e) {
    // 429 — เกินโควต้ารายวัน
} catch (InquiryException $e) {
    // 400/422 — บัญชีไม่พบ, รูปแบบผิด
    echo "Error code: {$e->errorCode}";
} catch (NetworkException $e) {
    // cURL fail / 5xx
} catch (CheckAccNameException $e) {
    // catch-all (parent ของทั้งหมดข้างบน)
}

ทุก exception มี:

• $e->getMessage() — ข้อความ error
• $e->httpStatus — HTTP status code (int)
• $e->responseBody — raw decoded JSON response (debug)

รหัสธนาคารที่ใช้บ่อย

ดูรายการเต็ม → https://check.gudevindy.com/banklist

Example

export CHECKACCNAME_TOKEN="your-token"
php examples/inquiry.php

Demo

ลองตัวอย่างระบบสมัครสมาชิกที่ใช้ SDK ตัวนี้: 👉 https://demo.gudevindy.com

Security

• Token = Bearer JWT — เก็บใน .env หรือ secret manager เท่านั้น อย่า commit ลง repo
• เรียก API จาก backend (ไม่ส่ง token ไป browser)
• Validate bankCode + accountNo ก่อนเรียก API
• ใช้ HTTPS เสมอ (sslVerify=true default)

Links

• 🌐 Service: https://check.gudevindy.com
• 📖 API Docs: https://check.gudevindy.com/docs
• 🧪 Demo (PHP): https://demo.gudevindy.com
• 🐛 Issues: https://github.com/gudevindy/checkaccname-php/issues

License

MIT — see LICENSE