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

เชื่อมต่อระบบของคุณกับ Sendjai ใน 3 ขั้นตอน

Headers:
  X-App-Id: YOUR_APP_ID
  X-Timestamp: 1712345678
  X-Signature: a1b2c3d4e5f6...

curl -X POST https://api.sendjai.com/v2/couriers/check-price \
  -H "X-App-Id: YOUR_APP_ID" \
  -H "X-Timestamp: 1712345678" \
  -H "X-Signature: a1b2c3..." \
  -H "Content-Type: application/json" \
  -d '{"src_zipcode":"10230","dst_zipcode":"50200","weight":500}'

Authentication

ทุก API request ต้องมี 3 headers สำหรับยืนยันตัวตน

Required Headers

วิธีสร้าง Signature

Node.js / TypeScript

const crypto = require("crypto");

const appId = "YOUR_APP_ID";
const secretKey = "YOUR_SECRET_KEY";
const timestamp = Math.floor(Date.now() / 1000);
const body = JSON.stringify({
  src_zipcode: "10230",
  dst_zipcode: "50200",
  weight: 500
});

const signString = `${appId}${timestamp}${body}`;
const signature = crypto
  .createHmac("sha256", secretKey)
  .update(signString)
  .digest("hex");

const response = await fetch("https://api.sendjai.com/v2/couriers/check-price", {
  method: "POST",
  headers: {
    "X-App-Id": appId,
    "X-Timestamp": String(timestamp),
    "X-Signature": signature,
    "Content-Type": "application/json",
  },
  body,
});

Python

import hmac, hashlib, time, json, requests

app_id = "YOUR_APP_ID"
secret_key = "YOUR_SECRET_KEY"
timestamp = str(int(time.time()))
body = json.dumps({"src_zipcode": "10230", "dst_zipcode": "50200", "weight": 500})

sign_string = f"{app_id}{timestamp}{body}"
signature = hmac.new(
    secret_key.encode(), sign_string.encode(), hashlib.sha256
).hexdigest()

resp = requests.post(
    "https://api.sendjai.com/v2/couriers/check-price",
    headers={
        "X-App-Id": app_id,
        "X-Timestamp": timestamp,
        "X-Signature": signature,
        "Content-Type": "application/json",
    },
    data=body,
)
print(resp.json())

PHP

$appId = "YOUR_APP_ID";
$secretKey = "YOUR_SECRET_KEY";
$timestamp = time();
$body = json_encode(["src_zipcode" => "10230", "dst_zipcode" => "50200", "weight" => 500]);

$signString = $appId . $timestamp . $body;
$signature = hash_hmac("sha256", $signString, $secretKey);

$ch = curl_init("https://api.sendjai.com/v2/couriers/check-price");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-App-Id: $appId",
    "X-Timestamp: $timestamp",
    "X-Signature: $signature",
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

API Reference

เลือก endpoint จากเมนูด้านซ้าย

Create Shipment

สร้างพัสดุใหม่ ระบบจะเรียก API ขนส่งจริงและคืนเลข tracking

Request Parameters

Response

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "tracking_number": "TH01408JDBMR0B2",
    "sort_code": "16B-16461-01",
    "courier_name": "Flash Express",
    "sender_name": "สมชาย",
    "receiver_name": "บอส",
    "status": "pending",
    "cod_amount": 50000,
    "shipping_cost": 35.00,
    "weight": 500,
    "created_at": "2026-04-03T12:00:00.000Z"
  }
}

List Shipments

ดึงรายการพัสดุทั้งหมดของคุณ

Request Parameters

Response

{
  "data": [
    {
      "id": "uuid-xxx",
      "tracking_number": "TH01408JDBMR0B2",
      "courier_name": "Flash Express",
      "receiver_name": "สมชาย",
      "status": "in_transit",
      "cod_amount": 50000,
      "created_at": "2026-04-03T12:00:00Z"
    }
  ],
  "total": 150
}

Get Shipment Detail

Cancel Shipment

Check Price

เปรียบเทียบราคาค่าส่งจากทุกขนส่งที่รองรับ

Request Parameters

Response

{
  "data": [
    {
      "courier": "Flash Express",
      "code": "FlashExpressC",
      "price": 35.00,
      "est_days": "1-2 วัน",
      "cod_available": true
    },
    {
      "courier": "Kerry Express",
      "code": "KerryExpress",
      "price": 40.00,
      "est_days": "2-3 วัน",
      "cod_available": true
    }
  ]
}

List Couriers

ดูรายชื่อขนส่งทั้งหมดที่เปิดใช้งาน

ไม่ต้องส่ง request body

Track Shipment

ติดตามสถานะพัสดุแบบ real-time

Response

{
  "data": {
    "tracking_number": "TH01408JDBMR0B2",
    "status": "in_transit",
    "courier": "Flash Express",
    "timeline": [
      { "status": "pending", "timestamp": "2026-04-03T12:00:00Z", "note": "สร้างออเดอร์" },
      { "status": "picked_up", "timestamp": "2026-04-03T14:00:00Z", "note": "รับพัสดุแล้ว" },
      { "status": "in_transit", "timestamp": "2026-04-03T18:00:00Z", "note": "กำลังขนส่ง — ศูนย์คัดแยก กรุงเทพ" }
    ]
  }
}

Status Values

Top Up via PromptPay QR

สร้าง PromptPay QR Code สำหรับเติมเครดิต ลูกค้าสแกนจ่ายผ่านแอปธนาคาร — เงินเข้าอัตโนมัติผ่าน Stripe

Request Parameters

Response

{
  "code": "SUCCESS",
  "data": {
    "payment_intent_id": "pi_3abc123...",
    "qr_image_url": "https://stripe.com/qr/xxx.png",
    "qr_data": "00020101021...",
    "amount": 500,
    "currency": "THB",
    "expires_at": "2026-04-03T12:03:00Z"
  }
}

Top Up via Card

สร้าง Stripe Payment Intent สำหรับเติมเครดิตด้วยบัตรเครดิต/เดบิต

Request Parameters

Response

{
  "code": "SUCCESS",
  "data": {
    "payment_intent_id": "pi_3abc123...",
    "client_secret": "pi_3abc123_secret_xxx",
    "amount": 500,
    "fee": 27,
    "charge_amount": 527,
    "currency": "THB"
  }
}

การ Confirm Payment ฝั่ง Frontend

// ใช้ Stripe.js confirm ด้วย client_secret
const stripe = Stripe("pk_live_xxx");
const { error } = await stripe.confirmCardPayment(client_secret, {
  payment_method: {
    card: cardElement,
    billing_details: { name: "Customer Name" },
  },
});
if (!error) {
  // Payment succeeded — poll /v2/topup/status
}

Check Top Up Status

เช็คสถานะการเติมเงิน — ใช้ poll ทุก 3 วินาทีหลังสร้าง QR หรือ Payment Intent

Request Parameters

Response

{
  "code": "SUCCESS",
  "data": {
    "payment_intent_id": "pi_3abc123...",
    "status": "paid",
    "amount": 500,
    "currency": "THB",
    "method": "promptpay"
  }
}

Status Values

Top Up History

ดูประวัติเติมเงินทั้งหมด

Request Parameters

Response

{
  "code": "SUCCESS",
  "data": [
    {
      "id": 123,
      "type": "topup",
      "amount": 500.00,
      "balance_after": 1750.00,
      "note": "เติมเครดิต ฿500 ผ่าน PromptPay",
      "created_at": "2026-04-03T12:00:00Z"
    }
  ],
  "total": 25
}

Get Balance

เช็คยอดเครดิตคงเหลือ

ไม่ต้องส่ง request body

Response

{ "data": { "balance": 1250.50, "currency": "THB" } }

Error Codes

เมื่อเกิดข้อผิดพลาด API จะคืน JSON ดังนี้:

{
  "error": "เครดิตไม่เพียงพอ — คงเหลือ ฿50.00 ต้องการ ฿35.00",
  "code": "INSUFFICIENT_BALANCE",
  "balance": 50.00
}

Error Code Reference

Rate Limits

Changelog

v2.0 — 3 เมษายน 2026

• เปิด Open Platform open.sendjai.com
• API v2 endpoints พร้อมใช้งาน
• รองรับ HMAC-SHA256 authentication
• เพิ่ม Check Price, Tracking, Balance APIs