ข้ามไปยังเนื้อหาหลัก
เวอร์ชัน: ล่าสุด

Payment Links+ API

Payment Links กับ Payment Links+

Omise มีผลิตภัณฑ์ Payment Links 2 แบบ:

ฟีเจอร์Payment LinksPayment Links+
API Serverhttps://api.omise.co/linkshttps://linksplus-api.omise.co
เทมเพลตไม่มีมี - สร้างเทมเพลตที่ใช้ซ้ำได้
Custom Webhookระดับบัญชีเท่านั้นกำหนด Custom Webhook ต่อลิงก์
การจัดการทีมไม่มีมี - ใช้ team_id
เอกสารPayment Links APIหน้านี้

หากคุณใช้ Omise API มาตรฐานที่ api.omise.co โปรดดู Payment Links API แทน

สร้างและจัดการ Payment Links+ ผ่านโปรแกรมโดยใช้ Links+ API เฉพาะ API นี้ให้การสร้างลิงก์จากเทมเพลต Custom Webhook และฟีเจอร์ขั้นสูง

Base URL​

https://linksplus-api.omise.co

การยืนยันตัวตน​

คำขอทั้งหมดต้องมีการยืนยันตัวตนโดยใช้ Secret Key ผ่าน HTTP Basic Auth หรือ Bearer token

# ใช้ Basic Auth
curl https://linksplus-api.omise.co/external/links \
  -u skey_test_xxx:

# ใช้ Bearer Token
curl https://linksplus-api.omise.co/external/links \
  -H "Authorization: Bearer skey_test_xxx"

API Endpoints​

ลิงก์​

MethodEndpointคำอธิบาย
POST/external/linksสร้างลิงก์ชำระเงิน
GET/external/links/:link_idดึงข้อมูลลิงก์ชำระเงิน
GET/external/:team_id/linksรายการลิงก์ชำระเงินทั้งหมด

เทมเพลต​

MethodEndpointคำอธิบาย
GET/external/templates/:template_idดึงข้อมูลเทมเพลต
GET/external/:team_id/templatesรายการเทมเพลตทั้งหมด

Webhook​

Payment Links+ รองรับ Webhook endpoint สูงสุด 3 รายการต่อการชำระเงิน:

  1. System webhook - กำหนดค่าที่ระดับบัญชี
  2. Dashboard webhook - กำหนดค่าในแดชบอร์ด Omise
  3. Custom webhook - ระบุต่อลิงก์ผ่านพารามิเตอร์ custom_webhook

Webhook Payload​

เมื่อการชำระเงินเสร็จสมบูรณ์ Webhook ที่กำหนดค่าทั้งหมดจะได้รับเหตุการณ์การชำระเงิน:

{
  "event": "payment.completed",
  "link_id": 789,
  "payment": {
    "id": "chrg_test_xxx",
    "amount": 100000,
    "currency": "thb",
    "status": "successful"
  },
  "timestamp": "2026-02-14T10:35:00Z"
}
ต้องใช้ HTTPS

URL Custom Webhook ต้องใช้ HTTPS URL HTTP จะถูกปฏิเสธ

รหัสการตอบกลับ​

รหัสคำอธิบาย
200 OKคำขอสำเร็จ
400 Bad Requestพารามิเตอร์ไม่ถูกต้องหรือขาดฟิลด์ที่จำเป็น
401 UnauthorizedAPI key ไม่ถูกต้องหรือไม่มี
404 Not Foundไม่พบทรัพยากร
500 Internal Server Errorข้อผิดพลาดเซิร์ฟเวอร์ ลองใหม่ภายหลัง

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