POST /verify (URL)

Verify a bank slip by providing a URL to the 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
url	string	Yes	URL to slip image (1-255 characters)
checkDuplicate	boolean	No	Check for duplicate slip

URL Requirements

Requirement	Value
Protocol	HTTP or HTTPS only
Maximum length	255 characters
Content type	Must return a valid image
Maximum size	4 MB
IP restrictions	No private/internal IP addresses

Type Definitions

// Request
interface VerifyByUrlRequest {
  url: string;              // 1-255 chars
  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 '{
    "url": "https://example.com/slips/slip-12345.jpg",
    "checkDuplicate": true
  }'

JavaScript

const verifyByUrl = async (url, 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({ url, checkDuplicate })
  });

  const result = await response.json();

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

  return result.data;
};

// Usage
const slip = await verifyByUrl('https://example.com/slips/slip-12345.jpg', true);
console.log('Amount:', slip.amount.amount);

PHP

function verifyByUrl(string $url, 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([
            'url' => $url,
            '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
$slip = verifyByUrl('https://example.com/slips/slip-12345.jpg', true);
echo "Amount: " . $slip['amount']['amount'];

Python

import requests
import os

def verify_by_url(url: 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={'url': url, 'checkDuplicate': check_duplicate}
    )

    result = response.json()

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

    return result['data']

# Usage
slip = verify_by_url('https://example.com/slips/slip-12345.jpg', 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 URL (400)

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

URL Unreachable (400)

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

Image Too Large (400)

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

Notes

• Use HTTPS URLs for security
• URL must be publicly accessible
• Server should return correct Content-Type header
• API has a timeout for URL fetching