Side-by-side comparison

ตารางเปรียบเทียบ

Request

Request

Body fields are identical to /payment/create — merchant_id, token, time, merchant_order_id, amount, bank, account_name, account_no, and optional notify_url. Same validation rules (alphanumeric merchant_order_id ≤ 40 chars, amount ≥ 20.00, valid bank code, account_no 10–15 digits). Only the path changes.

Body fields เหมือนกับ /payment/create ทุกประการ: merchant_id, token, time, merchant_order_id, amount, bank, account_name, account_no และ notify_url (ไม่บังคับ)
กติกา validation เดียวกัน (merchant_order_id เป็นตัวอักษร/ตัวเลข ≤ 40 ตัว, amount ≥ 20.00, bank ถูกต้อง, account_no 10–15 หลัก)
เปลี่ยนแค่ path เท่านั้น

Code samples

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

TIME=$(date +%s)
BODY="{\"merchant_id\":\"AA12345678\",\"token\":\"YOUR_TOKEN\",\"time\":$TIME,\"merchant_order_id\":\"ORDER-2026-001\",\"amount\":\"500.00\",\"bank\":\"KBANK\",\"account_name\":\"สมชาย ใจดี\",\"account_no\":\"1234567890\",\"notify_url\":\"https://<your-merchant-webhook-URL>/payment-callback\"}"
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "YOUR_SECRET" | awk '{print $2}')

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

import crypto from 'node:crypto';

const SECRET = 'YOUR_SECRET';
const body = JSON.stringify({
  merchant_id:       'AA12345678',
  token:             'YOUR_TOKEN',
  time:             Math.floor(Date.now() / 1000),
  merchant_order_id: 'ORDER-2026-001',
  amount:            '500.00',
  bank:              'KBANK',
  account_name:      'สมชาย ใจดี',
  account_no:        '1234567890',
  notify_url:        'https://<your-merchant-webhook-URL>/payment-callback',
});
const sig = crypto.createHmac('sha256', SECRET).update(body).digest('hex');

const r = await fetch('https://<your-api-domain>/payment/create-flex', {
  method:  'POST',
  headers: { 'Content-Type': 'application/json', 'X-SIGNATURE': sig },
  body
});
const { data } = await r.json();
// Redirect the customer to the hosted payment page:
// res.redirect(data.payment_url)
console.log(data.payment_url);

<?php
$secret = 'YOUR_SECRET';
$body = json_encode([
    'merchant_id'       => 'AA12345678',
    'token'             => 'YOUR_TOKEN',
    'time'              => time(),
    'merchant_order_id' => 'ORDER-2026-001',
    'amount'            => '500.00',
    'bank'              => 'KBANK',
    'account_name'      => 'สมชาย ใจดี',
    'account_no'        => '1234567890',
    'notify_url'        => 'https://<your-merchant-webhook-URL>/payment-callback',
], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);

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

$ch = curl_init('https://<your-api-domain>/payment/create-flex');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $body,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        "X-SIGNATURE: $sig",
    ],
]);
$res = json_decode(curl_exec($ch), true);
// header('Location: ' . $res['data']['payment_url']);  // redirect the customer
echo $res['data']['payment_url'];

Response

Response

Success — HTTP 200

สำเร็จ — HTTP 200

{
  "code":    200,
  "message": "Success",
  "data":    {
    "platform_order_id": "ABCP20260508abc123XYZ456",
    "merchant_order_id": "ORDER-2026-001",
    "uuid":              "0190b4a2-7c1d-7000-9f3a-2c8e5b1a4d6f",
    "order_datetime":    "2026-05-08 10:30:00",
    "expire_datetime":   "2026-05-08 10:45:00",
    "amount":            500.00,
    "payment_type":      "FLEX",
    "payment_url":       "https://<your-payment-page-domain>/p/0190b4a2-7c1d-7000-9f3a-2c8e5b1a4d6f"
  },
  "success": true
}

Response fields

Response fields

Errors

Errors

Same set as /payment/create, plus one flex-specific case:

ชุดเดียวกับ /payment/create เพิ่มกรณีเฉพาะของ flex อีกหนึ่ง:

Behavior & notes

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

• Server-side channel selection. Flex runs the platform's configured selection algorithm over one combined pool of all the platform's deposit accounts — the account's type doesn't matter — honouring the same per-account amount / daily / hourly limits and deposit-group rules as the dedicated endpoints. Which channel a given order uses depends on which account wins selection, so it varies per order.
• เลือก channel ฝั่ง server — flex ใช้อัลกอริทึมการเลือกที่แพลตฟอร์มตั้งไว้กับ pool รวมเดียวของบัญชีรับเงินทั้งหมดของแพลตฟอร์ม (ไม่สนใจว่าบัญชีเป็นประเภทไหน) โดยเคารพลิมิตต่อบัญชี (จำนวนเงิน/รายวัน/รายชั่วโมง) และกติกา deposit-group เดียวกับ endpoint เฉพาะทาง
  order ไหนใช้ channel ใดขึ้นกับว่าบัญชีไหนชนะการเลือก จึงต่างกันไปในแต่ละ order
• Automatic fallback. When the selected channel requires a network call to an external service, that call can momentarily fail; flex then drops that account and re-selects onto another available channel — so a single call still succeeds where possible.
• Fallback อัตโนมัติ — ช่องทางที่ต้องเรียกข้ามเครือข่ายไปบริการภายนอกอาจล้มชั่วขณะได้
  flex จะตัดบัญชีนั้นออกแล้วเลือก channel อื่นที่ว่างให้
  เรียกครั้งเดียวก็ยังสำเร็จเท่าที่เป็นไปได้
• You must redirect to payment_url. Don't try to render a QR or bank details from the flex response — they aren't there by design. If you need to render channel details in your own UI, use /payment/create or /payment/create-transfer instead.
• ต้อง redirect ไป payment_url — อย่าพยายาม render QR หรือเลขบัญชีจาก response ของ flex เพราะไม่มีมาให้โดยตั้งใจ
  ถ้าต้องการ render รายละเอียด channel ในหน้าของคุณเอง ให้ใช้ /payment/create หรือ /payment/create-transfer แทน
• The hosted page may forward the customer off-site. payment_url always points at the platform's own hosted page (on the payment_page_domain). For some channels, that page then redirects the customer onward to that channel's own payment page. That onward hop is part of paying — it is not a return/back-to-merchant link, and its target is never a URL you supply. Your customer returns to you through your normal flow only after the payment webhook to notify_url confirms the payment.
• หน้า payment page อาจพาลูกค้าออกไปเว็บภายนอก — payment_url ชี้ไปหน้า hosted page ของแพลตฟอร์มเองเสมอ (บน payment_page_domain)
  บางช่องทาง หน้าดังกล่าวจะ redirect ลูกค้า ต่อไปยังหน้าชำระของช่องทางนั้น
  การ redirect ต่อนี้เป็นส่วนหนึ่งของการจ่ายเงิน ไม่ใช่ ลิงก์ return/กลับมาหา merchant และปลายทางไม่ใช่ URL ที่คุณกำหนดเอง
  ลูกค้าจะกลับมาหาคุณผ่าน flow ปกติของคุณหลังจาก payment webhook ที่ยิงไป notify_url ยืนยันการจ่ายแล้วเท่านั้น
• Same order lifecycle. Idempotency by merchant_order_id (7 days), order TTL, fee handling, /payment/query, and the completion payment webhook to your notify_url all work exactly as for the other payment endpoints — matched by platform_order_id.
• วงจร order เหมือนกัน — Idempotency ด้วย merchant_order_id (7 วัน), order TTL, การคิดค่าธรรมเนียม, /payment/query และ payment webhook ตอนจ่ายสำเร็จที่ยิงไป notify_url ทำงานเหมือน endpoint การฝากอื่นทุกประการ
  จับคู่ด้วย platform_order_id
• Prerequisite. A payment_page_domain must be configured for your platform (your platform admin sets this). Without it, flex returns invalid-inputs before creating anything.
• เงื่อนไขก่อนใช้ — แพลตฟอร์มต้องตั้ง payment_page_domain ไว้ (admin ของแพลตฟอร์มเป็นผู้ตั้ง)
  ถ้าไม่มี flex จะตอบ invalid-inputs ก่อนสร้าง order ใด ๆ