สร้างลิงก์ชำระเงิน

POSThttps://linksplus-api.omise.co/external/links

สร้างลิงก์ชำระเงินใหม่จากเทมเพลต

---

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

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

▼

`template_id`INTEGER(required)

ID ของเทมเพลตที่จะใช้สร้างลิงก์ ดึงจาก endpoint รายการเทมเพลต

Example:"123"

`team_id`INTEGER(required)

ID ทีมของคุณ ค้นหาได้ในการตั้งค่าแดชบอร์ด Omise

Example:"456"

`name`STRING(required)

ชื่อ/หัวข้อของลิงก์ชำระเงินที่แสดงให้ลูกค้า

Example:"Premium Subscription"

`amount`INTEGER(required)

จำนวนเงินในหน่วยสกุลเงินที่เล็กที่สุด (เช่น สตางค์สำหรับ THB, เซนต์สำหรับ USD)

Example:"299900"

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

▼

`currency`STRING(optional)

รหัสสกุลเงิน ISO 3 ตัวอักษร ค่าเริ่มต้นคือสกุลเงินของเทมเพลต

Example:"thb"

Default:"ค่าเริ่มต้นของเทมเพลต"

`multiple_usage`BOOLEAN(optional)

อนุญาตให้ชำระเงินหลายครั้งบนลิงก์นี้

Default:"false"

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

▼

---

การตอบกลับ

200

สร้างสำเร็จ

ส่งคืนออบเจ็กต์ลิงก์ชำระเงินที่สร้างพร้อม URL ชำระเงิน

{
  "id": 789,
  "name": "Premium Subscription",
  "amount": 299900,
  "currency": "thb",
  "status": "active",
  "payment_url": "https://pay.omise.co/links/abc123",
  "multiple_usage": false,
  "created_at": "2026-02-14T10:30:00Z",
  "template_id": 123,
  "team_id": 456
}

400

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

พารามิเตอร์ไม่ถูกต้องหรือขาดฟิลด์ที่จำเป็น

401

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

API key ไม่ถูกต้องหรือไม่มี

---

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

cURL

curl -X POST https://linksplus-api.omise.co/external/links \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": 123,
    "team_id": 456,
    "name": "Premium Subscription",
    "amount": 299900,
    "currency": "thb"
  }'

Node.js

const response = await fetch('https://linksplus-api.omise.co/external/links', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    template_id: 123,
    team_id: 456,
    name: 'Premium Subscription',
    amount: 299900,
    currency: 'thb'
  })
});

const link = await response.json();
console.log('Payment URL:', link.payment_url);

Python

import requests

response = requests.post(
    'https://linksplus-api.omise.co/external/links',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'template_id': 123,
        'team_id': 456,
        'name': 'Premium Subscription',
        'amount': 299900,
        'currency': 'thb'
    }
)

link = response.json()
print(f"Payment URL: {link['payment_url']}")

---

🔐Payment Links+ API Credentials

▼

ทดลองใช้

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

▼

template_id(จำเป็น)

team_id(จำเป็น)

name(จำเป็น)

amount(จำเป็น)

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

▼

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

▼

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