ข้ามไปยังเนื้อหาหลัก

ไลบรารี่เซิร์ฟเวอร์

Omise มีไลบรารี่เซิร์ฟเวอร์ที่เป็นทางการสำหรับหลายภาษาการเขียนโปรแกรม ทำให้สามารถรวมการประมวลผลการชำระเงินเข้ากับแอปพลิเคชันของคุณได้อย่างง่ายดาย ไลบรารี่ของเราจัดการการสื่อสาร API, การตรวจสอบสิทธิ์, การลงนาม, และการจัดการข้อผิดพลาด ช่วยให้คุณสามารถมุ่งเน้นไปที่การสร้างแอปพลิเคชันของคุณได้

ไลบรารี่ที่พร้อมใช้งาน​

Ruby​

ไลบรารี่ omise-ruby gem มอบอินเทอร์เฟสของ Ruby สำหรับ Omise API พร้อมการรวมกับ Rails และการจัดการข้อผิดพลาดที่ครอบคลุม

Python​

ไลบรารี่ omise-python เสนออินเทอร์เฟสแบบ Python พร้อมคำใบ้ประเภทและการสนับสนุนแบบ async

PHP​

ไลบรารี่ omise-php มอบโค้ดที่เป็นไปตามมาตรฐาน PSR พร้อมการสนับสนุน Composer

Node.js​

ไลบรารี่ omise-node รองรับทั้งรูปแบบ Promise และ async/await พร้อมนิยาม TypeScript

.NET​

ไลบรารี่ Omise.Net มอบการใช้ C# สมัยใหม่พร้อมการสนับสนุน LINQ และรูปแบบ async/await

Java​

ไลบรารี่ omise-java เสนอการสนับสนุน Java 8+ พร้อม Optional และ Stream API

Go​

ไลบรารี่ omise-go มอบโค้ดแบบ Go ที่มีการสนับสนุน Goroutine

Elixir​

ไลบรารี่ omise-elixir ใช้ประโยชน์จากการจับคู่รูปแบบและคุณสมบัติ OTP ของ Elixir

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

ไลบรารี่เซิร์ฟเวอร์ Omise ทั้งหมดมอบ:

  • การตรวจสอบสิทธิ์ที่ปลอดภัย: การจัดการคีย์ API และการลงนามคำขอ
  • การครอบคลุม API อย่างครอบคลุม: การเข้าถึงจุดสิ้นสุด Omise API ทั้งหมด
  • ความปลอดภัยของประเภท: การพิมพ์ที่แข็งแกร่งและการตรวจสอบที่รองรับ
  • การจัดการข้อผิดพลาด: การจัดการข้อผิดพลาดที่มีโครงสร้างพร้อมข้อความข้อผิดพลาดโดยละเอียด
  • อัตราการลบซ้ำ: การสนับสนุนคำขอแบบอัตราการลบซ้ำเพื่อป้องกันค่าธรรมเนียมที่ซ้ำกัน
  • การสนับสนุนการทดสอบ: การกำหนดค่าโหมดทดสอบสำหรับการพัฒนา
  • การยืนยันเว็บฮุก: เครื่องมือสำหรับการตรวจสอบลายเซ็นของเว็บฮุก
  • เอกสาร: เอกสารแบบอินไลน์และตัวอย่างโค้ด

การดำเนินการทั่วไป​

การสร้างค่าธรรมเนียม​

ไลบรารี่ทั้งหมดรองรับการสร้างค่าธรรมเนียมด้วยโทเคนหรือต้นทาง:

# Ruby
charge = Omise::Charge.create(amount: 100_000, currency: 'THB', card: 'tokn_test_123')
# Python
charge = omise.Charge.create(amount=100000, currency='THB', card='tokn_test_123')
// PHP
$charge = OmiseCharge::create(['amount' => 100000, 'currency' => 'THB', 'card' => 'tokn_test_123']);
// Node.js
const charge = await omise.charges.create({ amount: 100000, currency: 'THB', card: 'tokn_test_123' });

การจัดการลูกค้า​

สร้างและจัดการลูกค้าสำหรับการชำระเงินซ้ำ:

// C#
var customer = await client.Customers.CreateAsync(new CreateCustomerRequest {
    Email = "customer@example.com",
    Description = "John Doe"
});
// Java
Customer customer = client.customers().create(new CustomerRequest()
    .email("customer@example.com")
    .description("John Doe"));
// Go
customer, err := client.Customers.Create(&omise.CreateCustomerRequest{
    Email:       "customer@example.com",
    Description: "John Doe",
})
# Elixir
{:ok, customer} = Omise.Customer.create(%{
  email: "customer@example.com",
  description: "John Doe"
})

การเลือกไลบรารี่​

เมื่อเลือกไลบรารี่เซิร์ฟเวอร์ ให้พิจารณา:

  1. ระบบนิเวศภาษา: เลือกไลบรารี่ที่ตรงกับภาษาแบ็กเอนด์ของคุณ
  2. การรวมเฟรมเวิร์ก: ไลบรารี่บางตัวมีการรวมเฟรมเวิร์กเฉพาะ (Rails, Django, Laravel ฯลฯ)
  3. การสนับสนุนแบบ Async: หากแอปพลิเคชันของคุณต้องการความสามารถในการทำงานพร้อมกันสูง ให้เลือกไลบรารี่ที่มีการสนับสนุนแบบ async
  4. ความปลอดภัยของประเภท: สำหรับแอปพลิเคชันขนาดใหญ่ ให้พิจารณาภาษาที่มีระบบประเภทที่แข็งแกร่ง (Java, C#, Go, TypeScript)
  5. ชุมชน: ไลบรารี่ทั้งหมดได้รับการบำรุงรักษาอย่างแข็งขันโดย Omise โดยมีส่วนสนับสนุนของชุมชน

เริ่มต้นใช้งาน​

ในการเริ่มต้นใช้ไลบรารี่เฉพาะ:

  1. เลือกไลบรารี่ที่ตรงกับภาษาการเขียนโปรแกรมของคุณ
  2. ทำตามคำแนะนำการติดตั้งสำหรับตัวจัดการแพ็คเจจของคุณ
  3. กำหนดค่า API keys (secret key สำหรับการดำเนินการเซิร์ฟเวอร์)
  4. ตรวจสอบคำแนะนำการเริ่มต้นอย่างรวดเร็วสำหรับการดำเนินการพื้นฐาน
  5. สำรวจคุณสมบัติขั้นสูงและแนวทางปฏิบัติที่ดีที่สุด

การตรวจสอบสิทธิ์​

ไลบรารี่เซิร์ฟเวอร์ทั้งหมดต้องใช้ API keys ของ Omise:

  • Secret Key: ใช้สำหรับการดำเนินการเซิร์ฟเวอร์ (อย่าเปิดเผยต่อไคลเอนต์)
  • Public Key: ใช้สำหรับการดำเนินการฝั่งไคลเอนต์ (เฉพาะการสร้างโทเคน)
# Test keys (สำหรับการพัฒนา)
export OMISE_SECRET_KEY="skey_test_123456789"
export OMISE_PUBLIC_KEY="pkey_test_123456789"

# Live keys (สำหรับผลิตภาพ)
export OMISE_SECRET_KEY="skey_live_123456789"
export OMISE_PUBLIC_KEY="pkey_live_123456789"
แนวทางปฏิบัติที่ดีที่สุดด้านความปลอดภัย

อย่าส่งคีย์ API ไปยังการควบคุมเวอร์ชัน ใช้ตัวแปรสภาพแวดล้อมหรือระบบการจัดการคีย์ที่ปลอดภัย

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

ไลบรารี่ทั้งหมดมอบการจัดการข้อผิดพลาดที่มีโครงสร้าง:

  • ข้อผิดพลาดของเครือข่าย: หมดเวลาการเชื่อมต่อ ความล้มเหลวของ DNS
  • ข้อผิดพลาด API: พารามิเตอร์ที่ไม่ถูกต้อง ความล้มเหลวในการตรวจสอบสิทธิ์
  • ข้อผิดพลาดของตรรกะทางธุรกิจ: เงินไม่เพียงพอ บัตรถูกปฏิเสธ

ไลบรารี่แต่ละตัวใช้รูปแบบที่เฉพาะเจาะจงตามภาษา (ข้อยกเว้น, ตัวอักษรข้อผิดพลาด, ประเภท Result เป็นต้น) เพื่อดำเนินการจัดการข้อผิดพลาด

การทดสอบ​

ไลบรารี่ทั้งหมดรองรับโหมดทดสอบสำหรับการพัฒนา:

  1. ใช้คีย์ API ทดสอบ (คำนำหน้า: skey_test_ และ pkey_test_)
  2. ใช้หมายเลขบัตรทดสอบสำหรับธุรกรรมที่สำเร็จและล้มเหลว
  3. ทดสอบเว็บฮุกโดยใช้จุดสิ้นสุดทดสอบ
  4. ไม่มีการเรียกเก็บเงินจริงในโหมดทดสอบ

การสนับสนุนและทรัพยากร​

การปฏิบัติตามกฎ และ ความปลอดภัย​

ไลบรารี่ Omise ทั้งหมดได้รับการออกแบบโดยคำนึงถึงความปลอดภัย:

  • PCI DSS: ไลบรารี่ช่วยการปฏิบัติตามกฎ PCI โดยไม่เคยจัดการข้อมูลบัตรดิบ
  • TLS 1.2+: การสื่อสาร API ทั้งหมดใช้การเข้ารหัสแบบสมัยใหม่
  • การจัดการคีย์: การจัดการคีย์ API ที่ปลอดภัย
  • การตรวจสอบการป้อนข้อมูล: การตรวจสอบพารามิเตอร์เพื่อป้องกันการโจมตีแบบฉีด

การสนับสนุนเวอร์ชัน​

Omise รักษาความเข้ากันได้กับ:

  • Ruby: 2.6+ (รวม Ruby 3.x)
  • Python: 3.6+ (รวม Python 3.11+)
  • PHP: 7.2+ (รวม PHP 8.x)
  • Node.js: 12+ (ขอแนะนำ Node.js 16+ เนื่องจาก 12.x ถึง EOL)
  • .NET: .NET Core 3.1+, .NET 5+, .NET 6+
  • Java: Java 8+ (รวม Java 17+)
  • Go: Go 1.16+ (รวม Go 1.20+)
  • Elixir: Elixir 1.10+ (รวม Elixir 1.14+)

ขั้นตอนถัดไป​

เลือกภาษาการเขียนโปรแกรมของคุณเพื่อเริ่มต้น:

การมีส่วนสนับสนุน​

ไลบรารี่ Omise ทั้งหมดเป็นแบบเปิดและต้อนรับการมีส่วนสนับสนุน:

  1. ทำการ Fork ที่เก็บข้อมูลบน GitHub
  2. สร้างสาขาคุณสมบัติ
  3. เขียนการทดสอบสำหรับการเปลี่ยนแปลงของคุณ
  4. ส่งคำขอ Pull

ดูที่เก็บข้อมูลไลบรารี่แต่ละแห่งสำหรับแนวทางการมีส่วนสนับสนุน