เวอร์ชัน: ล่าสุด

Sources API

ภาพรวม

Sources API ช่วยให้คุณสามารถรับวิธีการชำระเงินทางเลือกนอกเหนือจากบัตรเครดิต Sources แทนช่องทางการชำระเงิน เช่น PromptPay QR codes, mobile banking, internet banking, แผนผ่อนชำระ และอื่น ๆ

Sources คืออะไร?

Sources คือ payment method objects ที่แทน:

PromptPay QR codes - การชำระเงินแบบ QR แบบเรียลไทม์
Mobile banking - การ redirect การชำระเงินในแอป (SCB Easy, Krungthai Next ฯลฯ)
Internet banking - การโอนเงินผ่านธนาคารออนไลน์
Convenience stores - การชำระเงินด้วยเงินสดที่ 7-Eleven, FamilyMart ฯลฯ
Installment plans - ตัวเลือกการผ่อนชำระ
E-wallets - TrueMoney, Rabbit LINE Pay ฯลฯ

คุณสมบัติหลัก

รองรับวิธีการชำระเงินหลากหลาย

การชำระเงินผ่าน QR - PromptPay, Alipay, WeChat Pay
การโอนเงินผ่านธนาคาร - Mobile และ internet banking
ผ่อนชำระ - แผนผ่อนชำระดอกเบี้ย 0%
การชำระเงินด้วยเงินสด - การชำระเงินที่ร้านสะดวกซื้อ
E-wallets - การเชื่อมต่อกระเป๋าเงินดิจิทัล

ขั้นตอนการทำงานที่ยืดหยุ่น

แบบ Redirect - ลูกค้า redirect เพื่อทำการชำระเงินให้เสร็จสมบูรณ์
แสดง QR code - แสดง QR code ให้ลูกค้าสแกน
การแจ้งเตือนผ่าน Webhook - การอัปเดตสถานะการชำระเงินแบบเรียลไทม์
การประมวลผลแบบ Asynchronous - การชำระเงินเสร็จสมบูรณ์นอกเว็บไซต์ของคุณ

การรองรับภูมิภาค

ประเทศไทย - PromptPay, SCB, Krungthai, BAY, BBL ฯลฯ
มาเลเซีย - FPX, Boost, GrabPay, Touch 'n Go
สิงคโปร์ - PayNow, GrabPay
ระหว่างประเทศ - Alipay, WeChat Pay

Sources ทำงานอย่างไร

ขั้นตอนมาตรฐาน

┌─────────┐         ┌─────────┐         ┌─────────┐         ┌─────────┐
│ เซิร์ฟเวอร์ │         │ Omise   │         │ ผู้ให้บริการ │         │ ลูกค้า  │
│ ของคุณ   │         │ API     │         │ การชำระเงิน │         │         │
└────┬────┘         └────┬────┘         └────┬────┘         └────┬────┘
     │                   │                   │                   │
     │ 1. สร้าง source   │                   │                   │
     ├──────────────────>│                   │                   │
     │                   │                   │                   │
     │ 2. ส่งกลับ source │                   │                   │
     │    (พร้อม QR/URL) │                   │                   │
     │<──────────────────┤                   │                   │
     │                   │                   │                   │
     │ 3. สร้าง charge   │                   │                   │
     ├──────────────────>│                   │                   │
     │                   │                   │                   │
     │ 4. ส่งกลับ charge │                   │                   │
     │    (status:pending)                   │                   │
     │<──────────────────┤                   │                   │
     │                   │                   │                   │
     │ 5. แสดง QR        │                   │                   │
     │    หรือ redirect  │                   │                   │
     ├──────────────────────────────────────────────────────────>│
     │                   │                   │                   │
     │                   │                   │ 6. ลูกค้าชำระเงิน │
     │                   │                   │<──────────────────┤
     │                   │                   │                   │
     │                   │ 7. แจ้งเตือน Webhook │                   │
     │<──────────────────┤                   │                   │
     │                   │                   │                   │
     │ 8. แสดงผลสำเร็จ   │                   │                   │
     ├──────────────────────────────────────────────────────────>│
     │                   │                   │                   │

ขั้นตอนการดำเนินการ

สร้าง source - ระบุประเภทวิธีการชำระเงินและจำนวนเงิน
สร้าง charge - ใช้ source ID เพื่อสร้าง charge (status: pending)
แสดง UI การชำระเงิน - แสดง QR code หรือ redirect ลูกค้า
รอ webhook - ลูกค้าทำการชำระเงินเสร็จสมบูรณ์แบบ asynchronous
ตรวจสอบสถานะ - ตรวจสอบสถานะ charge ผ่าน webhook หรือ API
ดำเนินการคำสั่งซื้อ - ประมวลผลคำสั่งซื้อหลังจากการชำระเงินสำเร็จ

ประเภท Source

การชำระเงินแบบ QR

ประเภท	คำอธิบาย	ภูมิภาค
promptpay	การชำระเงินผ่าน QR แห่งชาติของไทย	ไทย
alipay	E-wallet ชั้นนำของจีน	ระหว่างประเทศ
wechat_pay	WeChat Pay QR	ระหว่างประเทศ
paynow	การชำระเงินผ่าน QR ของสิงคโปร์	สิงคโปร์

Mobile Banking

ประเภท	คำอธิบาย	ภูมิภาค
mobile_banking_scb	แอป SCB Easy	ไทย
mobile_banking_kbank	แอป K PLUS	ไทย
mobile_banking_bbl	Bangkok Bank Mobile	ไทย
mobile_banking_bay	Krungsri Mobile	ไทย
mobile_banking_ktb	แอป Krungthai NEXT	ไทย

Internet Banking

ประเภท	คำอธิบาย	ภูมิภาค
internet_banking_scb	SCB online banking	ไทย
internet_banking_bbl	Bangkok Bank online	ไทย
internet_banking_bay	Krungsri online	ไทย
fpx	Online banking ของมาเลเซีย	มาเลเซีย

วิธีการชำระเงินอื่น ๆ

ประเภท	คำอธิบาย	ภูมิภาค
truemoney	TrueMoney Wallet	ไทย
rabbit_linepay	Rabbit LINE Pay	ไทย
installment_bay	ผ่อนชำระกรุงศรี	ไทย
installment_kbank	ผ่อนชำระกสิกรไทย	ไทย
econtext	การชำระเงินที่ร้านสะดวกซื้อ	ญี่ปุ่น

วงจรชีวิตของ Source

สถานะ

สถานะ	คำอธิบาย	สถานะ Charge
pending	สร้าง source แล้ว รอการชำระเงิน	pending
successful	การชำระเงินเสร็จสมบูรณ์	successful
failed	การชำระเงินล้มเหลวหรือถูกปฏิเสธ	failed
expired	หมดเวลาการชำระเงิน	expired

กฎการหมดอายุ

วิธีการชำระเงินที่แตกต่างกันมีเวลาหมดอายุเริ่มต้นที่แตกต่างกัน:

การตรวจสอบเวลาหมดอายุ

เวลาหมดอายุที่ระบุด้านล่างอ้างอิงจากเอกสารที่มีอยู่และอาจแตกต่างกัน สำหรับเวลาหมดอายุที่แม่นยำและเป็นปัจจุบันที่สุดสำหรับวิธีการชำระเงินเฉพาะของคุณ โปรดดูเอกสารวิธีการชำระเงินแต่ละรายการหรือติดต่อฝ่ายสนับสนุน Omise

วิธีการชำระเงิน	การหมดอายุเริ่มต้น	การหมดอายุกำหนดเอง
PromptPay	24 ชั่วโมง	กำหนดเองได้ผ่าน `expires_in`
Mobile Banking (SCB/KBANK/BBL/BAY/KTB)	15-30 นาที*	กำหนดเองได้ผ่าน `expires_in`
Internet Banking (SCB/BBL/BAY)	15-30 นาที*	กำหนดเองได้ผ่าน `expires_in`
FPX (มาเลเซีย)	30 นาที*	กำหนดเองได้ผ่าน `expires_in`
PayNow (สิงคโปร์)	15-30 นาที*	กำหนดเองได้ผ่าน `expires_in`
Alipay	15-30 นาที*	กำหนดเองได้ผ่าน `expires_in`
WeChat Pay	15-30 นาที*	กำหนดเองได้ผ่าน `expires_in`
TrueMoney Wallet	15-30 นาที*	กำหนดเองได้ผ่าน `expires_in`
Rabbit LINE Pay	15-30 นาที*	กำหนดเองได้ผ่าน `expires_in`
GrabPay	15-30 นาที*	กำหนดเองได้ผ่าน `expires_in`
Boost	15-30 นาที*	กำหนดเองได้ผ่าน `expires_in`
Touch 'n Go	15-30 นาที*	กำหนดเองได้ผ่าน `expires_in`
แผนผ่อนชำระ (BAY/KBANK)	24-48 ชั่วโมง*	กำหนดเองได้ผ่าน `expires_in`
ร้านสะดวกซื้อ (ญี่ปุ่น)	7 วัน*	กำหนดเองได้ผ่าน `expires_in`

*ตรวจสอบกับเอกสารวิธีการชำระเงินเฉพาะหรือฝ่ายสนับสนุน Omise สำหรับค่าที่แน่นอน

การตั้งค่าการหมดอายุกำหนดเอง:

const source = await omise.sources.create({
  type: 'promptpay',
  amount: 100000,
  currency: 'thb',
  expires_in: 1800  // 30 นาที (เป็นวินาที)
});

แนวทางปฏิบัติที่ดีที่สุด:

ตรวจสอบเอกสารวิธีการชำระเงินแต่ละรายการสำหรับเวลาหมดอายุที่แนะนำ
การหมดอายุที่สั้นกว่า (5-15 นาที) สำหรับการชำระเงินผ่าน QR เพื่อป้องกัน QR codes ที่หมดอายุ
การหมดอายุที่ยาวกว่า (24-48 ชั่วโมง) สำหรับการโอนเงินผ่านธนาคารเพื่อให้มีเวลาประมวลผล
จัดการ webhook events source.expired เสมอเพื่ออัปเดตสถานะคำสั่งซื้อ

API Endpoints

เมธอด	Endpoint	คำอธิบาย
POST	`/sources`	สร้าง source ใหม่
GET	`/sources/:id`	ดึงข้อมูล source

เริ่มต้นอย่างรวดเร็ว

ตัวอย่างการชำระเงินผ่าน PromptPay QR

// 1. สร้าง PromptPay source
const source = await omise.sources.create({
  type: 'promptpay',
  amount: 100000,
  currency: 'thb'
});

// 2. สร้าง charge ด้วย source
const charge = await omise.charges.create({
  amount: 100000,
  currency: 'thb',
  source: source.id,
  return_uri: 'https://example.com/payment/complete'
});

// 3. แสดง QR code ให้ลูกค้า
const qrCodeUrl = charge.source.scannable_code.image.download_uri;
console.log('แสดง QR code:', qrCodeUrl);

// 4. รอการแจ้งเตือน webhook
// Webhook event: charge.complete
// ตรวจสอบว่าสถานะ charge เปลี่ยนเป็น "successful"

ตัวอย่าง Mobile Banking

// 1. สร้าง mobile banking source
const source = await omise.sources.create({
  type: 'mobile_banking_scb',
  amount: 50000,
  currency: 'thb'
});

// 2. สร้าง charge
const charge = await omise.charges.create({
  amount: 50000,
  currency: 'thb',
  source: source.id,
  return_uri: 'https://example.com/payment/complete'
});

// 3. Redirect ลูกค้าไปยัง authorize_uri
const redirectUrl = charge.authorize_uri;
// Redirect ลูกค้าไปยัง URL นี้
window.location.href = redirectUrl;

// 4. ลูกค้าทำการชำระเงินในแอปธนาคาร
// 5. ลูกค้าถูก redirect กลับไปยัง return_uri
// 6. Webhook ถูกส่งเมื่อการชำระเงินเสร็จสมบูรณ์

ขั้นตอนการชำระเงิน

ขั้นตอน QR Code (PromptPay, Alipay, WeChat Pay)

สร้าง source -> สร้าง charge
แสดง QR code ให้ลูกค้า
ลูกค้าสแกนด้วยแอปมือถือ
ลูกค้ายืนยันการชำระเงินในแอป
การแจ้งเตือน webhook ถูกส่ง
อัปเดตสถานะคำสั่งซื้อ

ขั้นตอน Redirect (Mobile Banking, Internet Banking)

สร้าง source -> สร้าง charge
Redirect ลูกค้าไปยัง authorize_uri
ลูกค้าทำการชำระเงินให้เสร็จสมบูรณ์
ลูกค้าถูก redirect ไปยัง return_uri
การแจ้งเตือน webhook ถูกส่ง
ตรวจสอบสถานะการชำระเงิน

ขั้นตอน Offline (ร้านสะดวกซื้อ)

สร้าง source -> สร้าง charge
แสดงรหัสการชำระเงินให้ลูกค้า
ลูกค้าชำระเงินที่ร้านสะดวกซื้อ
การแจ้งเตือน webhook ถูกส่ง (ชั่วโมง/วันหลังจากนั้น)
ดำเนินการคำสั่งซื้อ

กรณีการใช้งานทั่วไป

การชำระเงินครั้งเดียว

const source = await omise.sources.create({ type: 'promptpay', amount: 100000, currency: 'thb' });
const charge = await omise.charges.create({ amount: 100000, currency: 'thb', source: source.id });

การชำระเงินแบบผ่อนชำระ

const source = await omise.sources.create({
  type: 'installment_kbank',
  amount: 300000,
  currency: 'thb',
  installment_term: 6  // 6 เดือน
});
const charge = await omise.charges.create({ amount: 300000, currency: 'thb', source: source.id });

การชำระเงินที่ร้านสะดวกซื้อ

const source = await omise.sources.create({
  type: 'econtext',
  amount: 50000,
  currency: 'jpy',
  name: 'TARO YAMADA',
  email: 'taro@example.com',
  phone_number: '+81312345678'
});
const charge = await omise.charges.create({ amount: 50000, currency: 'jpy', source: source.id });

แนวทางปฏิบัติที่ดีที่สุด

ควรทำ

ตั้งค่า return_uri สำหรับการชำระเงินแบบ redirect
ใช้งาน webhooks สำหรับการแจ้งเตือนแบบ asynchronous
แสดงคำแนะนำที่ชัดเจน สำหรับแต่ละวิธีการชำระเงิน
ตั้งค่าการหมดอายุที่เหมาะสม ตามประเภทการชำระเงิน
ตรวจสอบสถานะการชำระเงิน ผ่าน webhooks ไม่ใช่ polling
จัดการ timeouts อย่างเหมาะสม (ลูกค้าไม่ทำการชำระเงินให้เสร็จ)
ทดสอบแต่ละวิธีการชำระเงิน ก่อนใช้งานจริง
เก็บ source IDs ไว้สำหรับการติดตามและการสนับสนุน

ไม่ควรทำ

อย่า poll ตลอดเวลา (ใช้ webhooks)
อย่าคิดว่าการชำระเงินจะสำเร็จทันที (เป็นแบบ async)
อย่าข้าม return_uri (ลูกค้าต้องกลับมา)
อย่าละเลยการหมดอายุ (sources หมดอายุ)
อย่าผสมวิธีการชำระเงิน (หนึ่ง source = หนึ่งประเภทการชำระเงิน)
อย่าใช้ sources กับสกุลเงินที่ผิด (เฉพาะประเภท)

ข้อควรพิจารณาด้านความปลอดภัย

การตรวจสอบ Webhook

ตรวจสอบ webhook signatures เสมอเพื่อยืนยันความถูกต้อง:

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const hmac = crypto.createHmac('sha256', secret);
  hmac.update(payload);
  const expectedSignature = hmac.digest('hex');
  return signature === expectedSignature;
}

การตรวจสอบสถานะ

อย่าเชื่อ return_uri parameters เพียงอย่างเดียว ตรวจสอบสถานะ charge เสมอ:

// ลูกค้ากลับมาจากการชำระเงิน
app.get('/payment/complete', async (req, res) => {
  const chargeId = req.query.charge_id;

  // ตรวจสอบสถานะ charge จริง
  const charge = await omise.charges.retrieve(chargeId);

  if (charge.status === 'successful') {
    // ยืนยันการชำระเงินแล้ว ดำเนินการคำสั่งซื้อ
  } else {
    // การชำระเงินยังไม่เสร็จสมบูรณ์ แสดงข้อผิดพลาด
  }
});

การทดสอบ

โหมดทดสอบ

ประเภท source ทั้งหมดทำงานในโหมดทดสอบด้วย test secret key ของคุณ

การจำลองการชำระเงิน

ในโหมดทดสอบ คุณสามารถ:

สร้าง sources และ charges
รับ webhooks
ทดสอบขั้นตอน redirect
สร้าง test QR codes

ทดสอบ Webhooks

ใช้เครื่องมือทดสอบ webhook หรือ ngrok สำหรับการพัฒนาในเครื่อง:

ngrok http 3000
# ตั้งค่า webhook URL ใน Omise Dashboard

การจัดการข้อผิดพลาด

ข้อผิดพลาด source ที่พบบ่อย:

รหัสข้อผิดพลาด	คำอธิบาย	วิธีแก้ไข
`invalid_source_type`	วิธีการชำระเงินไม่รองรับ	ตรวจสอบประเภทที่มีสำหรับสกุลเงินของคุณ
`amount_too_low`	จำนวนเงินต่ำกว่าขั้นต่ำ	ตรวจสอบจำนวนเงินขั้นต่ำสำหรับประเภทการชำระเงิน
`currency_not_supported`	สกุลเงินผิด	ตรวจสอบว่าประเภทการชำระเงินรองรับสกุลเงิน
`expired_source`	Source หมดอายุ	สร้าง source ใหม่

API Reference

สร้าง Source - POST /sources
ดึงข้อมูล Source - GET /sources/:id

แหล่งข้อมูลที่เกี่ยวข้อง

คู่มือวิธีการชำระเงิน

ต้องการความช่วยเหลือ? ดู คู่มือวิธีการชำระเงิน หรือติดต่อ support@omise.co

ภาพรวม​

Sources คืออะไร?​

คุณสมบัติหลัก​

รองรับวิธีการชำระเงินหลากหลาย​

ขั้นตอนการทำงานที่ยืดหยุ่น​

การรองรับภูมิภาค​

Sources ทำงานอย่างไร​

ขั้นตอนมาตรฐาน​

ขั้นตอนการดำเนินการ​

ประเภท Source​

การชำระเงินแบบ QR​

Mobile Banking​

Internet Banking​

วิธีการชำระเงินอื่น ๆ​

วงจรชีวิตของ Source​

สถานะ​

กฎการหมดอายุ​

API Endpoints​

เริ่มต้นอย่างรวดเร็ว​

ตัวอย่างการชำระเงินผ่าน PromptPay QR​

ตัวอย่าง Mobile Banking​

ขั้นตอนการชำระเงิน​

ขั้นตอน QR Code (PromptPay, Alipay, WeChat Pay)​

ขั้นตอน Redirect (Mobile Banking, Internet Banking)​

ขั้นตอน Offline (ร้านสะดวกซื้อ)​

กรณีการใช้งานทั่วไป​

การชำระเงินครั้งเดียว​

การชำระเงินแบบผ่อนชำระ​

การชำระเงินที่ร้านสะดวกซื้อ​

แนวทางปฏิบัติที่ดีที่สุด​

ควรทำ​

ไม่ควรทำ​

ข้อควรพิจารณาด้านความปลอดภัย​

การตรวจสอบ Webhook​

การตรวจสอบสถานะ​

การทดสอบ​

โหมดทดสอบ​

การจำลองการชำระเงิน​

ทดสอบ Webhooks​

การจัดการข้อผิดพลาด​

API Reference​

แหล่งข้อมูลที่เกี่ยวข้อง​

คู่มือวิธีการชำระเงิน​