สร้าง Source

POSThttps://api.omise.co/sources

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

---

พารามิเตอร์ของคำขอ

จำเป็น - 3 ฟิลด์พารามิเตอร์ที่จำเป็น

▼

`amount`INTEGER(required)

จำนวนเงินในหน่วยสกุลเงินที่เล็กที่สุด (สตางค์สำหรับ THB, cents สำหรับ USD, yen สำหรับ JPY) ตัวอย่างเช่น 100000 สตางค์ = 1,000 บาท

Example:100000

Constraints:ขั้นต่ำ: แตกต่างตามวิธีการชำระเงิน, PromptPay ขั้นต่ำ: 20 บาท (2000 สตางค์)

`currency`STRING(required)

รหัสสกุลเงินสามตัวอักษรตามมาตรฐาน ISO 4217 เป็นตัวพิมพ์เล็ก ต้องตรงกับประเภทวิธีการชำระเงิน

Example:"thb"

Values:thb, jpy, sgd, myr

`type`STRING(required)

ประเภทวิธีการชำระเงิน ประเภทที่แตกต่างกันรองรับสกุลเงินที่แตกต่างกัน

Example:"promptpay"

Values:promptpay, paynow, alipay, alipay_cn, alipay_hk, dana, gcash, kakaopay, touch_n_go, boost, shopeepay, shopeepay_jumpapp, maybankqrpay, duitnow_qr, promptpay_credit, wechat_pay, rabbit_linepay, truemoney, fpx, mobile_banking_scb, mobile_banking_kbank, mobile_banking_bbl, mobile_banking_bay, mobile_banking_ktb, internet_banking_scb, internet_banking_bbl, internet_banking_bay, installment_bay, installment_first_choice, installment_bbl, installment_kbank, installment_ktc, installment_scb, installment_ttb, installment_uob, installment_mbb, installment_krungsri, econtext, payeasy, netbanking, paypay, atome

แนะนำ - 2 ฟิลด์พารามิเตอร์ที่แนะนำ

▼

เพิ่มเติม - 15 ฟิลด์พารามิเตอร์เพิ่มเติม

▼

---

การตอบกลับ

200

ธุรกรรมสำเร็จ

สร้าง source สำเร็จ การตอบกลับประกอบด้วยข้อมูลเฉพาะการชำระเงิน เช่น QR codes หรือ redirect URLs

ฟิลด์การตอบกลับทั่วไป:

• id - Source ID (src_*) ที่ใช้เมื่อสร้าง charge
• type - ประเภทวิธีการชำระเงิน
• flow - ขั้นตอนการชำระเงิน: offline (QR code), redirect (เว็บ) หรือ app_redirect (แอปมือถือ)
• amount - จำนวนเงินของ source ในหน่วยสกุลเงินที่เล็กที่สุด
• currency - รหัสสกุลเงิน
• scannable_code - ข้อมูล QR code สำหรับการชำระเงินแบบ QR
• charge_status - สถานะของ charge ที่สร้างด้วย source นี้
• created_at - Timestamp การสร้าง source (ISO 8601)

400

คำขอไม่ถูกต้อง

การตรวจสอบคำขอล้มเหลว ตรวจสอบข้อความแสดงข้อผิดพลาดสำหรับรายละเอียด

สาเหตุที่พบบ่อย:

• ฟิลด์ที่จำเป็นขาดหายไป (amount, currency, type)
• สกุลเงินไม่ถูกต้องสำหรับประเภทการชำระเงิน (เช่น SGD สำหรับ PromptPay)
• ฟิลด์ที่จำเป็นเฉพาะประเภทขาดหายไป (เช่น installment_term สำหรับการผ่อนชำระ)
• ประเภทการชำระเงินไม่ถูกต้อง

401

ไม่ได้รับอนุญาต

การยืนยันตัวตนล้มเหลว API key ไม่ถูกต้องหรือขาดหายไป

สาเหตุที่พบบ่อย:

• ไม่มี Authorization header
• Public key ไม่ถูกต้อง
• ใช้ secret key แทน public key
• รูปแบบ HTTP Basic Auth ไม่ถูกต้อง

422

ไม่สามารถประมวลผลได้

การตรวจสอบคำขอล้มเหลวเนื่องจากข้อจำกัดทางธุรกิจ

สาเหตุที่พบบ่อย:

• จำนวนเงินต่ำกว่าขั้นต่ำสำหรับประเภทการชำระเงิน
• จำนวนเงินเกินสูงสุดสำหรับประเภทการชำระเงิน
• ประเภทการชำระเงินไม่ได้เปิดใช้งานสำหรับบัญชีของคุณ
• จำนวนงวดผ่อนชำระไม่ถูกต้องสำหรับธนาคารที่เลือก

5xx

ข้อผิดพลาดเซิร์ฟเวอร์

เกิดข้อผิดพลาดฝั่งเซิร์ฟเวอร์ กรณีเหล่านี้เกิดขึ้นไม่บ่อยแต่ควรจัดการอย่างเหมาะสม

วิธีจัดการ:

• ลองส่งคำขออีกครั้งด้วย exponential backoff
• ตรวจสอบ status.omise.co สำหรับเหตุการณ์บริการ
• ดู การจัดการข้อผิดพลาด สำหรับคำแนะนำโดยละเอียด

---

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

cURL

curl https://api.omise.co/sources \
  -u pkey_test_5xuy4w91xqz7d1w9u0t: \
  -d "amount=100000" \
  -d "currency=thb" \
  -d "type=promptpay"

Ruby

require 'omise'

Omise.api_key = 'pkey_test_5xuy4w91xqz7d1w9u0t'

source = Omise::Source.create({
  amount: 100000,
  currency: 'thb',
  type: 'promptpay'
})

Python

import omise

omise.api_public = 'pkey_test_5xuy4w91xqz7d1w9u0t'

source = omise.Source.create(
    amount=100000,
    currency='thb',
    type='promptpay'
)

Node.js

const omise = require('omise')({
  publicKey: 'pkey_test_5xuy4w91xqz7d1w9u0t'
});

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

PHP

<?php
define('OMISE_PUBLIC_KEY', 'pkey_test_5xuy4w91xqz7d1w9u0t');

$source = OmiseSource::create([
    'amount' => 100000,
    'currency' => 'thb',
    'type' => 'promptpay'
]);

Java

Client client = new Client.Builder()
    .publicKey("pkey_test_5xuy4w91xqz7d1w9u0t")
    .build();

Source source = client.sources().create()
    .amount(100000L)
    .currency("thb")
    .type("promptpay")
    .send();

C#

var client = new Client("pkey_test_5xuy4w91xqz7d1w9u0t");

var source = await client.Sources.Create(new CreateSourceRequest
{
    Amount = 100000,
    Currency = "thb",
    Type = "promptpay"
});

Go

client, _ := omise.NewClient(
    "pkey_test_5xuy4w91xqz7d1w9u0t",
    "",
)

source, _ := client.Sources().Create(&operations.CreateSource{
    Amount:   100000,
    Currency: "thb",
    Type:     "promptpay",
})

---

รหัสข้อผิดพลาดและผลลัพธ์

รหัสข้อผิดพลาดทั่วไป

รหัส	คำอธิบาย	วิธีแก้ไข
bad_request	พารามิเตอร์ขาดหายไปหรือไม่ถูกต้อง	ตรวจสอบว่าฟิลด์ที่จำเป็นทั้งหมดถูกระบุ
authentication_failure	API key ไม่ถูกต้อง	ตรวจสอบว่า public key ของคุณถูกต้อง
currency_not_supported	สกุลเงินไม่รองรับสำหรับประเภทการชำระเงิน	ตรวจสอบว่าประเภทการชำระเงินรองรับสกุลเงินของคุณ
amount_too_low	จำนวนเงินต่ำกว่าขั้นต่ำ	ตรวจสอบจำนวนเงินขั้นต่ำสำหรับประเภทการชำระเงิน
amount_too_high	จำนวนเงินเกินสูงสุด	ตรวจสอบจำนวนเงินสูงสุดสำหรับประเภทการชำระเงิน
payment_method_not_allowed	ประเภทการชำระเงินไม่ได้เปิดใช้งาน	ติดต่อ Omise เพื่อเปิดใช้งานวิธีการชำระเงิน

ประเภทขั้นตอนของ Source

ขั้นตอน	คำอธิบาย
offline	ลูกค้าสแกน QR code (PromptPay, Alipay)
redirect	ลูกค้าถูก redirect ไปยังหน้าเว็บ (Internet Banking)
app_redirect	ลูกค้าถูก redirect ไปยังแอปมือถือ (Mobile Banking)

---

🔑ข้อมูลยืนยันตัวตน API

▼

ทดลองใช้

จำเป็น - 3 ฟิลด์

▼

amount(จำเป็น)

currency(จำเป็น)

type(จำเป็น)

แนะนำ - 2 ฟิลด์

▼

เพิ่มเติม - 15 ฟิลด์

▼

IP ของคุณ: ...กำลังโหลด...