API v2 Overview

API v2 is the latest version of the EasySlip Developer API, offering improved features, better error handling, and a standardized response format.

Base URL

https://api.easyslip.com/v2

Key Features

Standardized Response Format

All responses follow a consistent structure:

Success Response:

{
  "success": true,
  "data": { ... },
  "message": "Operation completed successfully"
}

Error Response:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message"
  }
}

Account Matching

Match slip receiver against your registered bank accounts:

{
  "payload": "QR_PAYLOAD",
  "matchAccount": true
}

Response includes matched account details:

{
  "matchedAccount": {
    "bank": {
      "nameTh": "กสิกรไทย",
      "nameEn": "KASIKORNBANK",
      "code": "004",
      "shortCode": "KBANK"
    },
    "nameTh": "บริษัท ตัวอย่าง จำกัด",
    "nameEn": "EXAMPLE CO., LTD.",
    "type": "JURISTIC",
    "bankNumber": "123-4-56789-0"
  }
}

Amount Validation

Verify that slip amount matches expected amount:

{
  "payload": "QR_PAYLOAD",
  "matchAmount": 1500.50
}

Response includes validation result:

{
  "amountInOrder": 1500.50,
  "amountInSlip": 1500.50,
  "isAmountMatched": true
}

Multi-Branch Support

Create multiple API branches with:

• Separate API keys per branch
• Per-branch quota tracking
• Different IP restrictions

Endpoints

Endpoint	Method	Description
/verify/bank	POST	Verify bank slip
/info	GET	Get application information
/health	GET	Health check

Authentication

All requests require a Bearer token:

Authorization: Bearer YOUR_API_KEY

See Authentication Guide for details.

Quick Examples

Verify Bank Slip

curl -X POST https://api.easyslip.com/v2/verify/bank \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payload": "YOUR_QR_PAYLOAD"}'

Get Application Info

curl -X GET https://api.easyslip.com/v2/info \
  -H "Authorization: Bearer YOUR_API_KEY"

Error Codes

Code	HTTP Status	Description
MISSING_API_KEY	401	Authorization header missing
INVALID_API_KEY	401	API key is invalid
BRANCH_INACTIVE	403	API branch is deactivated
SERVICE_BANNED	403	Service has been banned
IP_NOT_ALLOWED	403	Client IP not in whitelist
QUOTA_EXCEEDED	403	API quota exceeded
VALIDATION_ERROR	400	Request validation failed
SLIP_NOT_FOUND	404	Slip not found or invalid
API_SERVER_ERROR	500	External API error

See Error Codes Reference for full list.

Rate Limits

Requests are limited based on your subscription plan. Check your quota using the /info endpoint.

Next Steps

• Bank Slip Verification - Learn about slip verification
• Info Endpoint - Get application details
• Error Codes - Handle errors properly