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

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

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

Ruby

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

• การติดตั้ง: gem install omise
• ที่เก็บข้อมูล: github.com/omise/omise-ruby
• เอกสาร: Ruby Library Guide

Python

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

• การติดตั้ง: pip install omise
• ที่เก็บข้อมูล: github.com/omise/omise-python
• เอกสาร: Python Library Guide

PHP

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

• การติดตั้ง: composer require omise/omise-php
• ที่เก็บข้อมูล: github.com/omise/omise-php
• เอกสาร: PHP Library Guide

Node.js

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

• การติดตั้ง: npm install omise
• ที่เก็บข้อมูล: github.com/omise/omise-node
• เอกสาร: Node.js Library Guide

.NET

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

• การติดตั้ง: dotnet add package Omise.Net
• ที่เก็บข้อมูล: github.com/omise/omise-dotnet
• เอกสาร: .NET Library Guide

Java

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

• การติดตั้ง: Maven หรือ Gradle
• ที่เก็บข้อมูล: github.com/omise/omise-java
• เอกสาร: Java Library Guide

Go

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

• การติดตั้ง: go get github.com/omise/omise-go
• ที่เก็บข้อมูล: github.com/omise/omise-go
• เอกสาร: Go Library Guide

Elixir

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

• การติดตั้ง: เพิ่มเข้า mix.exs
• ที่เก็บข้อมูล: github.com/omise/omise-elixir
• เอกสาร: Elixir Library Guide

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

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

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

ข้อกำหนดเวอร์ชันขั้นต่ำ

จำเป็นต้องอัปเดตความปลอดภัย

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

ไลบรารี่	เวอร์ชันขั้นต่ำ	วันที่เผยแพร่
Ruby	0.8.0	4 พ.ย. 2562
Python	0.9.0	3 ก.ย. 2563
PHP	2.12.0	31 ก.ค. 2563
Node.js	1.0.0	-
Java	3.1.1	6 ส.ค. 2562
Go	1.0.5	31 ก.ค. 2563
.NET	3.0.0	-
Elixir	0.8.0	-

อัปเดต root certificates ของเซิร์ฟเวอร์ (DigiCert G2) ผ่านการอัปเดต OS หากคุณพบข้อผิดพลาด SSL/TLS

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

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

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

# 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 API Documentation
• ข้อมูลอ้างอิง API: API Endpoint Reference
• การสนับสนุน: support@omise.co
• ชุมชน: GitHub Discussions

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

ไลบรารี่ 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+)

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

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

• Ruby Library Guide
• Python Library Guide
• PHP Library Guide
• Node.js Library Guide
• .NET Library Guide
• Java Library Guide
• Go Library Guide
• Elixir Library Guide

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

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

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

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