👤🪪 การยืนยันตัวตนด้วยใบหน้าและบัตรประชาชนสำหรับ KYC

1 ICต่อคำขอ

v1.0 Active POST /v3/store/ekyc/face-and-id-card-verification

ลองเดโม

เยี่ยมชม API Portal ของเราเพื่อทดสอบ API การยืนยันตัวตนด้วยใบหน้าและบัตรประชาชนสำหรับ KYC ด้วยรูปภาพของคุณเอง

ลองเดโม!

รูปภาพเซลฟี่ตัวอย่าง (คลิกเพื่อลอง)

รูปภาพบัตรประชาชนตัวอย่าง (คลิกเพื่อลอง)

API Key

Log in to use your API keys or Create an account

Endpoint URL

cURL Command

อัปโหลดเซลฟี่

อัปโหลดบัตรประชาชน

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

การยืนยันตัวตนด้วยใบหน้าและบัตรประชาชนสำหรับ KYC เป็นบริการที่ขับเคลื่อนด้วย AI ซึ่งเปรียบเทียบรูปเซลฟี่กับรูปบัตรประชาชนเพื่อยืนยันตัวตนสำหรับวัตถุประสงค์ KYC (Know Your Customer)

ตัวอย่าง

บริการนี้รับข้อมูลเข้าสองประเภท:

1. รูปบัตรประชาชน (รูปขนาดใหญ่)
2. รูปเซลฟี่ของผู้ถือบัตรประชาชน (รูปขนาดเล็ก)

จากนั้นจะวิเคราะห์และยืนยันว่ารูปภาพทั้งสองแสดงบุคคลเดียวกันหรือไม่

คุณสมบัติและความสามารถ

คุณสมบัติหลัก

• การจับคู่ใบหน้าระหว่างเซลฟี่และรูปบัตรประชาชน
• การยืนยันความถูกต้องสูง
• การประมวลผลที่รวดเร็วภายใน 0.1 วินาที
• ไม่มีการเก็บข้อมูลหลังการประมวลผล (เป็นไปตาม GDPR)

เขตข้อมูลที่รองรับ

• รูปแบบไฟล์รูปภาพ: JPG, JPEG, PNG, GIF
• ขนาดรูปภาพ: กว้าง 600px x สูง 400px
• ขนาดไฟล์สูงสุด: 10MB ต่อรูปภาพ

ตัวอย่าง

คำขอสำหรับการยืนยันตัวตนด้วยใบหน้าและบัตรประชาชนสำหรับ KYC

ตัวอย่างรูปภาพ

    curl --location 'https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification' \
        --header 'apikey: {{{YOUR API KEY}}}' \
        --form 'file0=@"image1.png"' \
        --form 'file1=@"image2.png"'

การตอบกลับสำหรับการยืนยันตัวตนด้วยใบหน้าและบัตรประชาชนสำหรับ KYC

{
    "idcard": { "confidence": 66.872, "isSamePerson": "true" },
    "selfie": { "confidence": 86.04, "isSamePerson": "true" },
    "time_process": 0.824,
    "total": { "confidence": 76.456, "isSamePerson": "true" }
}

API Endpoints

Endpoint	Method	คำอธิบาย	ค่าใช้จ่าย
POST /v3/internal/ekyc/face-and-id-card-verification/v2 Legacy: /api/v2/ekyc	POST	การยืนยันใบหน้า + บัตรประชาชน	1 IC ต่อคำขอ
POST /v3/store/ekyc/face-and-id-card-verification Legacy: /face-verify-id2	POST	การยืนยันใบหน้า + บัตรประชาชน	1 IC ต่อคำขอ
POST /v3/store/ekyc/face-and-id-card-verification/front Legacy: /thai-national-id-card/v3/front/kyc	POST	การยืนยันใบหน้าและบัตรประชาชนสำหรับ KYC (ด้านหน้า)	1 IC ต่อหน้า
POST /v3/store/ekyc/face-and-id-card-verification/back Legacy: /thai-national-id-card/v3/back/kyc	POST	การยืนยันใบหน้าและบัตรประชาชนสำหรับ KYC (ด้านหลัง)	1 IC ต่อหน้า

การอ้างอิง API

Endpoint การยืนยันใบหน้าและบัตรประชาชน

1. การยืนยันใบหน้า + บัตรประชาชน (API V2)

POST /v3/store/ekyc/face-and-id-card-verification/v2

ยืนยันว่ารูปเซลฟี่ตรงกับรูปบัตรประชาชนหรือไม่ โดยใช้ Endpoint API V2

---

2. การยืนยันใบหน้า + บัตรประชาชน

POST /v3/store/ekyc/face-and-id-card-verification

ยืนยันว่ารูปเซลฟี่ตรงกับรูปบัตรประชาชนหรือไม่

---

3. การยืนยันใบหน้าและบัตรประชาชนสำหรับ KYC (ด้านหน้า)

POST /v3/store/ekyc/face-and-id-card-verification/kyc-front

ประมวลผลด้านหน้าของบัตรประชาชนไทยสำหรับการยืนยัน KYC

---

4. การยืนยันใบหน้าและบัตรประชาชนสำหรับ KYC (ด้านหลัง)

POST /v3/store/ekyc/face-and-id-card-verification/kyc-back

ประมวลผลด้านหลังของบัตรประชาชนไทยสำหรับการยืนยัน KYC

---

พารามิเตอร์คำขอ

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
apikey	String	header	ใช่	คีย์การยืนยันตัวตน API
file0	File	body	ใช่	ไฟล์รูปภาพบัตรประชาชน
file1	File	body	ใช่	ไฟล์รูปภาพเซลฟี่

การตอบกลับ

สถานะ	คำอธิบาย
200	การตอบกลับการยืนยันสำเร็จ

ข้อความแสดงข้อผิดพลาด API

ข้อความแสดงข้อผิดพลาดทั่วไป

รหัสสถานะ	ข้อความสถานะ	คำอธิบาย
404	no route matched with those values.	ไม่มีเส้นทางที่ตรงกับ URL นี้ โปรดตรวจสอบอีกครั้ง
405	the method is not allowed for the requested URL.	วิธีการนี้ไม่ได้รับอนุญาตสำหรับ URL ที่ร้องขอ
413	file is too large, more than 10 MB.	ขนาดไฟล์ใหญ่เกินไป มากกว่า 10 MB
415	file extension is not allowed.	นามสกุลไฟล์นี้ไม่ได้รับอนุญาตสำหรับ URL นี้

ข้อความแสดงข้อผิดพลาดเฉพาะของไคลเอ็นต์

รหัสสถานะ	ข้อความสถานะ	คำอธิบาย
420	parameter not found in request. [file0, file1]	ไม่พบพารามิเตอร์ในคำขอนี้ โปรดใส่พารามิเตอร์ในคำขอ
421	(face, id card, face on id card) not found in image. [file0, file1]	ไม่พบใบหน้า, บัตรประชาชน, หรือใบหน้าบนบัตรประชาชนในรูปภาพสำหรับ API นี้
422	face on (id card, selfie) not found in image. [file0, file1]	ไม่พบใบหน้าบนบัตรประชาชน หรือใบหน้าบนเซลฟี่ในรูปภาพ
441	too many images.	มีรูปภาพมากเกินไปในพารามิเตอร์
442	image error, unsupported format.	รูปแบบไฟล์รูปภาพไม่ได้รับอนุญาต
461	no file attached.	ไม่มีการแนบไฟล์

ตัวอย่างโค้ด

Python

import requests

url = "https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification"

payload = {}
files=[
  ('file0',('{IMAGE FILE 1}',open('{IMAGE FILE PATH 1}','rb'),'image/png')),
  ('file1',('{IMAGE FILE 2}',open('{IMAGE FILE PATH 2}','rb'),'image/png'))
]
headers = {
  'apikey': '{YOUR API KEY}'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

JavaScript

const axios = require("axios")
const FormData = require("form-data")
const fs = require("fs")
let data = new FormData()
data.append("file0", fs.createReadStream("{IMAGE FILE PATH 1}"))
data.append("file1", fs.createReadStream("{IMAGE FILE PATH 2}"))

let config = {
    method: "post",
    maxBodyLength: Infinity,
    url: "https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification",
    headers: {
        apikey: "{YOUR API KEY}",
        ...data.getHeaders(),
    },
    data: data,
}

axios
    .request(config)
    .then((response) => {
        console.log(JSON.stringify(response.data))
    })
    .catch((error) => {
        console.log(error)
    })

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('file0'=> new CURLFILE('{IMAGE FILE PATH 1}'),'file1'=> new CURLFILE('{IMAGE FILE PATH 2}')),
  CURLOPT_HTTPHEADER => array(
    'apikey: {YOUR API KEY}'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Swift

let parameters = [
  [
    "key": "file0",
    "src": "{IMAGE FILE PATH 1}",
    "type": "file"
  ],
  [
    "key": "file1",
    "src": "{IMAGE FILE PATH 2}",
    "type": "file"
  ]] as [[String: Any]]

let boundary = "Boundary-\(UUID().uuidString)"
var body = Data()
var error: Error? = nil
for param in parameters {
  if param["disabled"] != nil { continue }
  let paramName = param["key"]!
  body += Data("--\(boundary)\r\n".utf8)
  body += Data("Content-Disposition:form-data; name=\"\(paramName)\"".utf8)
  if param["contentType"] != nil {
    body += Data("\r\nContent-Type: \(param["contentType"] as! String)".utf8)
  }
  let paramType = param["type"] as! String
  if paramType == "text" {
    let paramValue = param["value"] as! String
    body += Data("\r\n\r\n\(paramValue)\r\n".utf8)
  } else {
    let paramSrc = param["src"] as! String
    let fileURL = URL(fileURLWithPath: paramSrc)
    if let fileContent = try? Data(contentsOf: fileURL) {
      body += Data("; filename=\"\(paramSrc)\"\r\n".utf8)
      body += Data("Content-Type: \"content-type header\"\r\n".utf8)
      body += Data("\r\n".utf8)
      body += fileContent
      body += Data("\r\n".utf8)
    }
  }
}
body += Data("--\(boundary)--\r\n".utf8);
let postData = body


var request = URLRequest(url: URL(string: "https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification")!,timeoutInterval: Double.infinity)
request.addValue("{YOUR API KEY}", forHTTPHeaderField: "apikey")
request.addValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

request.httpMethod = "POST"
request.httpBody = postData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

Kotlin

val client = OkHttpClient()
val mediaType = "text/plain".toMediaType()
val body = MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("file0","{IMAGE FILE 1}",
    File("{IMAGE FILE PATH 1}").asRequestBody("application/octet-stream".toMediaType()))
  .addFormDataPart("file1","{IMAGE FILE 2}",
    File("{IMAGE FILE PATH 2}").asRequestBody("application/octet-stream".toMediaType()))
  .build()
val request = Request.Builder()
  .url("https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification")
  .post(body)
  .addHeader("apikey", "{YOUR API KEY}")
  .build()
val response = client.newCall(request).execute()

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("file0","{IMAGE FILE 1}",
    RequestBody.create(MediaType.parse("application/octet-stream"),
    new File("{IMAGE FILE PATH 1}")))
  .addFormDataPart("file1","{IMAGE FILE 2}",
    RequestBody.create(MediaType.parse("application/octet-stream"),
    new File("{IMAGE FILE PATH 2}")))
  .build();
Request request = new Request.Builder()
  .url("https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification")
  .method("POST", body)
  .addHeader("apikey", "{YOUR API KEY}")
  .build();
Response response = client.newCall(request).execute();

Dart

var headers = {
  'apikey': '{YOUR API KEY}'
};
var request = http.MultipartRequest('POST', Uri.parse('https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification'));
request.files.add(await http.MultipartFile.fromPath('file0', '{IMAGE FILE PATH 1}'));
request.files.add(await http.MultipartFile.fromPath('file1', '{IMAGE FILE PATH 2}'));
request.headers.addAll(headers);

http.StreamedResponse response = await request.send();

if (response.statusCode == 200) {
  print(await response.stream.bytesToString());
}
else {
  print(response.reasonPhrase);
}

ความแม่นยำและประสิทธิภาพ

• อัตราการปฏิเสธผิดพลาด (FRR < 3%)
• อัตราการยอมรับผิดพลาด (FAR < 0.1%)

ตัวอย่างโค้ด

Curl

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification \
    -H "apikey: YOUR_API_KEY" \
    -F "file=@/path/to/face.jpg"

Python

import requests

url = "https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification"
files = {"file": ("("/path/to/face.jpg", "rb"))}
headers = {"apikey": "YOUR_API_KEY"}

response = requests.post(url, headers=headers, files=files)
print(response.json())

JavaScript

const axios = require("axios");
const FormData = require("form-data");
const fs = require("fs");

let data = new FormData();
data.append("file", fs.createReadStream("/path/to/face.jpg"));

let config = {
    method: "post",
    url: "https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification",
    headers: {
        apikey: "YOUR_API_KEY",
        ...data.getHeaders(),
    },
    data: data,
};

axios(config)
    .then((response) => console.log(response.data))
    .catch((error) => console.log(error));

PHP

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => array(
        'file'=> new CURLFILE('/path/to/face.jpg')
    ),
    CURLOPT_HTTPHEADER => array(
        'apikey: YOUR_API_KEY'
    ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Swift

import Foundation

let url = URL(string: "https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.addValue("YOUR_API_KEY", forHTTPHeaderField: "apikey")

let boundary = "Boundary-\(UUID().uuidString)"
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

var body = Data()
body.append("--\(boundary)\r\n".data(using: .utf8)!)
body.append("Content-Disposition: form-data; name=\"file\"; filename=\"file.jpg\"\r\n".data(using: .utf8)!)
body.append("Content-Type: image/jpeg\r\n\r\n".data(using: .utf8)!)

if let fileData = try? Data(contentsOf: URL(fileURLWithPath: "/path/to/face.jpg")) {
    body.append(fileData)
}
body.append("\r\n--\(boundary)--\r\n".data(using: .utf8)!)

request.httpBody = body

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        print(String(data: data, encoding: .utf8)!)
    }
}
task.resume()

Kotlin

import okhttp3.*
import okhttp3.MediaType.Companion.toMediaTypeOrNull
import okhttp3.RequestBody.Companion.asRequestBody
import java.io.File

val client = OkHttpClient()

val file = File("/path/to/face.jpg")
val requestBody = MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", file.name, file.asRequestBody("image/jpeg".toMediaTypeOrNull()))
    .build()

val request = Request.Builder()
    .url("https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(requestBody)
    .build()

client.newCall(request).execute().use { response ->
    println(response.body?.string())
}

Java

import okhttp3.*;
import java.io.File;

OkHttpClient client = new OkHttpClient();

File file = new File("/path/to/face.jpg");

RequestBody requestBody = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", file.getName(),
        RequestBody.create(MediaType.parse("image/jpeg"), file))
    .build();

Request request = new Request.Builder()
    .url("https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(requestBody)
    .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
}

Dart

import 'package:http/http.dart' as http;

var request = http.MultipartRequest(
    'POST',
    Uri.parse('https://api.iapp.co.th/v3/store/ekyc/face-and-id-card-verification')
);

request.files.add(await http.MultipartFile.fromPath(
    'file',
    '/path/to/face.jpg'
));

request.headers.addAll({
    'apikey': 'YOUR_API_KEY'
});

var response = await request.send();
var responseBody = await response.stream.bytesToString();
print(responseBody);

ราคา

การดำเนินการ	Production Path	Legacy Path	ค่าใช้จ่าย IC	หน่วย	On-Premise
การยืนยันใบหน้า + บัตรประชาชน (API V2)	/v3/store/ekyc/face-and-id-card-verification/v2	/api/v2/ekyc	1 IC	ต่อ 1 คำขอ	ติดต่อเรา
การยืนยันใบหน้า + บัตรประชาชน	/v3/store/ekyc/face-and-id-card-verification	/face-verify-id2	1 IC	ต่อ 1 คำขอ
การยืนยันใบหน้าและบัตรประชาชนสำหรับ KYC (ด้านหน้า)	/v3/store/ekyc/face-and-id-card-verification/kyc-front	/thai-national-id-card/v3/front/kyc	1 IC	ต่อ 1 หน้า
การยืนยันใบหน้าและบัตรประชาชนสำหรับ KYC (ด้านหลัง)	/v3/store/ekyc/face-and-id-card-verification/kyc-back	/thai-national-id-card/v3/back/kyc	1 IC	ต่อ 1 หน้า