Request

Request

Body fields

Body fields

Code samples

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

# Encode the slip image to base64 first
B64=$(base64 -i slip.jpg | tr -d '\n')

BODY=$(jq -nc \
  --arg mid   "AA12345678" \
  --arg tok   "YOUR_TOKEN" \
  --argjson t $(date +%s) \
  --arg pid   "ABCP20260508abc123XYZ456" \
  --arg img   "$B64" \
  '{merchant_id:$mid, token:$tok, time:$t, platform_order_id:$pid, image_base64:$img}')

SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "YOUR_SECRET" | awk '{print $2}')

curl -X POST https://<your-api-domain>/slip/upload \
  -H "Content-Type: application/json" \
  -H "X-SIGNATURE: $SIG" \
  -d "$BODY"

import crypto from 'node:crypto';
import fs from 'node:fs';

const SECRET = 'YOUR_SECRET';
const imageB64 = fs.readFileSync('./slip.jpg').toString('base64');

const body = JSON.stringify({
  merchant_id:       'AA12345678',
  token:             'YOUR_TOKEN',
  time:             Math.floor(Date.now() / 1000),
  platform_order_id: 'ABCP20260508abc123XYZ456',
  image_base64:      imageB64,
});
const sig = crypto.createHmac('sha256', SECRET).update(body).digest('hex');

const r = await fetch('https://<your-api-domain>/slip/upload', {
  method:  'POST',
  headers: { 'Content-Type': 'application/json', 'X-SIGNATURE': sig },
  body
});
console.log(await r.json());

<?php
$secret = 'YOUR_SECRET';
$imageB64 = base64_encode(file_get_contents('slip.jpg'));

$body = json_encode([
    'merchant_id'       => 'AA12345678',
    'token'             => 'YOUR_TOKEN',
    'time'              => time(),
    'platform_order_id' => 'ABCP20260508abc123XYZ456',
    'image_base64'      => $imageB64,
], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

$sig = hash_hmac('sha256', $body, $secret);

$ch = curl_init('https://<your-api-domain>/slip/upload');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $body,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        "X-SIGNATURE: $sig",
    ],
]);
echo curl_exec($ch);

Response

Response

Success — HTTP 200

สำเร็จ — HTTP 200

{
  "code":    200,
  "message": "Success",
  "data":    {
    "msg":              "slip upload successful.",
    "verification_msg": "amount ok, destination ok, transfer in time."
  },
  "success": true
}

Response fields

Response fields

Sample verification_msg values

ตัวอย่างค่าของ verification_msg

The string is composed from comma-separated check results. Common combinations:

ข้อความถูกประกอบจากผลตรวจหลายอย่าง คั่นด้วย comma — combinations ที่พบบ่อย:

Errors

Errors

/slip/upload uses the same error format as every other endpoint: HTTP 4xx with {"code", "error", "success": false, "message"}. See Error Codes for the full reference.

/slip/upload ใช้รูปแบบ error เหมือน endpoint อื่นทุกตัว — HTTP 4xx พร้อม {"code", "error", "success": false, "message"} — ดู Error Codes เพิ่มเติม

Auth errors (signature-error, authentication-failed, etc.) are handled by the auth middleware. See Authentication errors.

Auth error (signature-error, authentication-failed ฯลฯ) จัดการโดย auth middleware — ดู Authentication errors

Example error response

ตัวอย่าง error response

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json

{
  "code":    422,
  "error":   "invalid-inputs",
  "success": false,
  "message": "image too large (max 2,000,000 bytes)"
}

Behavior & notes

พฤติกรรม & หมายเหตุ

• Order must be in open status. Uploading a slip for an order that has already moved to success or failed returns "order status must be 'pending'".
• Order ต้องสถานะ open — ถ้า order ขยับเป็น success หรือ failed ไปแล้ว จะส่งกลับ error "order status must be 'pending'"
• The order itself must be no older than 30 days. If you call /slip/upload on an order whose order_datetime is more than 30 days ago, the response is "slip upload expired.".
• Order ต้องสร้างมาไม่เกิน 30 วัน — ถ้าเรียกบน order ที่ order_datetime เกิน 30 วัน จะได้ error "slip upload expired."
• Minimum wait time after order creation. Some accounts have a minimum delay (slip_upload_wait_time, in seconds) between order creation and the first slip upload. Calling too early returns "please wait N seconds and try uploading again.". Ask your payment gateway admin for the value.
• ต้องรอ N วินาทีหลังสร้าง order
  อาจมีการตั้ง delay ขั้นต่ำสำหรับบัญชีคุณ (slip_upload_wait_time, หน่วยวินาที) ระหว่างสร้าง order กับการอัปโหลดสลิปครั้งแรก
  ถ้าเรียกเร็วเกินจะได้ "please wait N seconds and try uploading again."
  ทั้งนี้ติดต่อ Payment gateway admin เพื่อรับค่า
• Rate limit: 1 upload per order per 5 minutes. Re-uploading within the same 5-minute window returns "please wait 5 minutes before upload again.".
• Rate limit: 1 ครั้งต่อ order ใน 5 นาที — อัปโหลดซ้ำในช่วง 5 นาทีจะได้ "please wait 5 minutes before upload again."
• Image format. PNG and JPG only, verified via magic bytes. Maximum 2,000,000 bytes after base64 decoding.
• รูปแบบไฟล์ — PNG หรือ JPG เท่านั้น (ตรวจจาก magic bytes) — สูงสุด 2,000,000 bytes หลัง decode base64
• What happens on a successful upload. The slip image is stored on S3, attached to the order, and the order is flagged as awaiting admin review (regardless of whether QR validation passed). Operations then reviews and either marks the order success or leaves it for further investigation. The validation result reflected in verification_msg is informational — final settlement decisions go through human review.
• เมื่ออัปโหลดสำเร็จ
  รูปสลิปถูกเก็บที่ S3 และผูกกับ order
  order จะถูก flag ว่ารอ admin รีวิว (ไม่ว่าผลตรวจ QR จะผ่านหรือไม่)
  operations จะรีวิวและตัดสินว่าจะ mark success หรือเก็บไว้ตรวจสอบเพิ่ม
  verification_msg เป็น informational
  ทั้งนี้การตัดสินใจสุดท้ายผ่านการรีวิวของคน