POST /verify (Base64)

Verify a bank slip using a Base64-encoded image.

Endpoint

POST /verify

Full URL: https://developer.easyslip.com/api/v1/verify

Authentication

Required. See Authentication Guide.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request

Parameters

Parameter	Type	Required	Description
data	string	Yes	Base64 encoded image (with or without data URI prefix)
checkDuplicate	boolean	No	Check for duplicate slip

Base64 Format

Both formats are accepted:

# With data URI prefix
data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAA...

# Without prefix
/9j/4AAQSkZJRgABAQAA...

Image Requirements

Requirement	Value
Maximum decoded size	4 MB
Supported formats	JPEG, PNG, GIF, WebP

Type Definitions

// Request
interface VerifyByBase64Request {
  data: string;             // Base64 encoded image
  checkDuplicate?: boolean;
}

// Response
interface VerifyResponse {
  status: 200;
  data: SlipData;
}

// See GET /verify for full SlipData type definition

// Error Response
interface ErrorResponse {
  status: number;
  message: string;
}

Examples

cURL

curl -X POST https://developer.easyslip.com/api/v1/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "data": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAA...",
    "checkDuplicate": true
  }'

JavaScript

const verifyByBase64 = async (base64, checkDuplicate = false) => {
  const response = await fetch('https://developer.easyslip.com/api/v1/verify', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ data: base64, checkDuplicate })
  });

  const result = await response.json();

  if (result.status !== 200) {
    throw new Error(result.message);
  }

  return result.data;
};

// Convert file to Base64
const fileToBase64 = (file) => {
  return new Promise((resolve, reject) => {
    const reader = new FileReader();
    reader.onload = () => resolve(reader.result);
    reader.onerror = reject;
    reader.readAsDataURL(file);
  });
};

// Usage
const file = document.getElementById('slipFile').files[0];
const base64 = await fileToBase64(file);
const slip = await verifyByBase64(base64, true);
console.log('Amount:', slip.amount.amount);

PHP

function verifyByBase64(string $base64, bool $checkDuplicate = false): array
{
    $apiKey = getenv('EASYSLIP_API_KEY');

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

    $response = curl_exec($ch);
    curl_close($ch);

    $result = json_decode($response, true);

    if ($result['status'] !== 200) {
        throw new Exception($result['message']);
    }

    return $result['data'];
}

// Usage with file
$imageData = file_get_contents('/path/to/slip.jpg');
$base64 = base64_encode($imageData);

$slip = verifyByBase64($base64, true);
echo "Amount: " . $slip['amount']['amount'];

Python

import requests
import base64
import os

def verify_by_base64(base64_data: str, check_duplicate: bool = False) -> dict:
    response = requests.post(
        'https://developer.easyslip.com/api/v1/verify',
        headers={
            'Authorization': f'Bearer {os.environ["EASYSLIP_API_KEY"]}',
            'Content-Type': 'application/json'
        },
        json={'data': base64_data, 'checkDuplicate': check_duplicate}
    )

    result = response.json()

    if result['status'] != 200:
        raise Exception(result['message'])

    return result['data']

# Usage with file
with open('./slip.jpg', 'rb') as f:
    image_data = f.read()
    base64_data = base64.b64encode(image_data).decode('utf-8')

slip = verify_by_base64(base64_data, check_duplicate=True)
print(f"Amount: {slip['amount']['amount']}")

Response

Success (200)

{
  "status": 200,
  "data": {
    "payload": "00000000000000000000000000000000000000000000000",
    "transRef": "68370160657749I376388B35",
    "date": "2024-01-15T14:30:00+07:00",
    "amount": {
      "amount": 1500.00
    },
    "sender": {
      "bank": { "id": "004", "name": "กสิกรไทย", "short": "KBANK" },
      "account": { "name": { "th": "นาย ผู้โอน ทดสอบ" } }
    },
    "receiver": {
      "bank": { "id": "014", "name": "ไทยพาณิชย์", "short": "SCB" },
      "account": { "name": { "th": "นาย รับเงิน ทดสอบ" } }
    }
  }
}

Error Responses

Invalid Base64 (400)

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

Image Size Too Large (400)

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

Notes

• Compress images before encoding to reduce payload size
• Use JPEG quality 0.7-0.9 for sufficient quality
• Including the data URI prefix helps with MIME type detection