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

ไลบรารี PHP (omise-php)

ไลบรารี omise-php ให้อินเทอร์เฟซ PHP ที่สอดคล้องกับ PSR สำหรับ Omise API พร้อมการผสานรวม Laravel และ Symfony ที่ยอดเยี่ยม คุณสมบัติ PHP สมัยใหม่ และการจัดการข้อผิดพลาดที่ครอบคลุม

การติดตั้ง​

การใช้ Composer (แนะนำ)​

composer require omise/omise-php

composer.json​

{
    "require": {
        "omise/omise-php": "^2.15"
    }
}

ข้อกำหนด​

  • PHP 7.2 หรือสูงกว่า (รวมถึง PHP 8.x)
  • ส่วนขยาย cURL
  • ส่วนขยาย JSON
  • Composer สำหรับการจัดการ dependency

เริ่มต้นอย่างรวดเร็ว​

การกำหนดค่าพื้นฐาน​

<?php
require_once 'vendor/autoload.php';

// กำหนดค่าด้วย API key ของคุณ
define('OMISE_SECRET_KEY', 'skey_test_123456789');
define('OMISE_PUBLIC_KEY', 'pkey_test_123456789');

// ตั้งค่าเวอร์ชัน API
define('OMISE_API_VERSION', '2019-05-29');

การกำหนดค่า Laravel​

เผยแพร่ไฟล์กำหนดค่า:

php artisan vendor:publish --provider="Omise\OmiseบริการProvider"

กำหนดค่าใน .env:

# config/services.php
OMISE_SECRET_KEY=skey_test_123456789
OMISE_PUBLIC_KEY=pkey_test_123456789
OMISE_API_VERSION=2019-05-29

กำหนดค่าเซอร์วิส:

<?php
// config/services.php

return [
    'omise' => [
        'secret_key' => env('OMISE_SECRET_KEY'),
        'public_key' => env('OMISE_PUBLIC_KEY'),
        'api_version' => env('OMISE_API_VERSION', '2019-05-29'),
    ],
];

การกำหนดค่า Symfony​

# config/packages/omise.yaml
omise:
    secret_key: '%env(OMISE_SECRET_KEY)%'
    public_key: '%env(OMISE_PUBLIC_KEY)%'
    api_version: '2019-05-29'

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

ไลบรารีใช้ secret key ของคุณสำหรับการดำเนินการ API ทั้งหมด:

<?php
require_once 'vendor/autoload.php';

// ตัวเลือกที่ 1: การกำหนดค่าแบบ Global
define('OMISE_SECRET_KEY', getenv('OMISE_SECRET_KEY'));
define('OMISE_PUBLIC_KEY', getenv('OMISE_PUBLIC_KEY'));

// ตัวเลือกที่ 2: การกำหนดค่าแบบ Per-request
$charge = OmiseCharge::retrieve('chrg_test_123', 'skey_test_alternate');

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

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

ด้วยโทเค็น​

<?php
require_once 'vendor/autoload.php';

define('OMISE_SECRET_KEY', getenv('OMISE_SECRET_KEY'));

try {
    $charge = OmiseCharge::create([
        'amount' => 100000,  // 1,000.00 THB (in smallest currency unit)
        'currency' => 'THB',
        'card' => 'tokn_test_123',
        'description' => 'Order #1234',
        'metadata' => [
            'order_id' => '1234',
            'customer_name' => 'John Doe'
        ]
    ]);
    
    if ($charge['paid']) {
        echo "Charge successful: " . $charge['id'];
    } else {
        echo "Charge failed: " . $charge['failure_message'];
    }
} catch (Exception $e) {
    echo "Error: " . $e->getMessage();
}

ด้วย Type Declarations (PHP 7.4+)​

<?php
declare(strict_types=1);

class Paymentบริการ
{
    public function createCharge(
        int $amount,
        string $currency,
        string $token,
        array $metadata = []
    ): array {
        return OmiseCharge::create([
            'amount' => $amount,
            'currency' => $currency,
            'card' => $token,
            'metadata' => $metadata
        ]);
    }
}

// การใช้
$service = new Paymentบริการ();
$charge = $service->createCharge(
    100000,
    'THB',
    'tokn_test_123',
    ['order_id' => '1234']
);

ด้วยลูกค้า​

<?php
// สร้างค่าธรรมเนียมสำหรับลูกค้าที่มีอยู่
$charge = OmiseCharge::create([
    'amount' => 50000,
    'currency' => 'THB',
    'customer' => 'cust_test_123',
    'description' => 'Subscription payment'
]);

ด้วย 3D Secure​

<?php
// สร้างค่าธรรมเนียมที่อาจต้องใช้ 3D Secure
$charge = OmiseCharge::create([
    'amount' => 100000,
    'currency' => 'THB',
    'card' => 'tokn_test_123',
    'return_uri' => 'https://example.com/payment/callback'
]);

if ($charge['authorized']) {
    if (isset($charge['authorize_uri'])) {
        // เปลี่ยนเส้นทางลูกค้าไปยัง authorize_uri สำหรับ 3D Secure
        header('Location: ' . $charge['authorize_uri']);
        exit;
    } else {
        // การเรียกเก็บเงินสำเร็จโดยไม่ต้องใช้ 3D Secure
        processSuccessfulPayment($charge);
    }
}

การดึงค่าธรรมเนียม​

<?php
// ดึงข้อมูลค่าธรรมเนียมโดยใช้ ID
$charge = OmiseCharge::retrieve('chrg_test_123');

echo "Amount: " . $charge['amount'] . PHP_EOL;
echo "Currency: " . $charge['currency'] . PHP_EOL;
echo "Status: " . $charge['status'] . PHP_EOL;
echo "Paid: " . ($charge['paid'] ? 'Yes' : 'No') . PHP_EOL;

การแสดงรายชื่อค่าธรรมเนียม​

<?php
// แสดงรายการค่าธรรมเนียมทั้งหมดพร้อม pagination
$charges = OmiseCharge::retrieve([
    'limit' => 20,
    'offset' => 0,
    'order' => 'reverse_chronological'
]);

foreach ($charges['data'] as $charge) {
    echo $charge['id'] . ": " . $charge['amount'] . " " . $charge['currency'] . PHP_EOL;
}

// แสดงรายการค่าธรรมเนียมพร้อมตัวกรอง
$weekAgo = (new DateTime('-7 days'))->format('Y-m-d');
$today = (new DateTime())->format('Y-m-d');

$recentCharges = OmiseCharge::retrieve([
    'from' => $weekAgo,
    'to' => $today
]);

การสร้างลูกค้า​

<?php
// สร้างลูกค้าโดยไม่มีบัตร
$customer = OmiseCustomer::create([
    'email' => 'customer@example.com',
    'description' => 'John Doe',
    'metadata' => [
        'user_id' => '12345',
        'account_type' => 'premium'
    ]
]);

echo "สร้างลูกค้าแล้ว: " . $customer['id'];

การบันทึกบัตรเข้าไปในลูกค้า​

<?php
// อัปเดตลูกค้าด้วยโทเค็นบัตร
$customer = OmiseCustomer::retrieve('cust_test_123');
$customer = OmiseCustomer::update('cust_test_123', [
    'card' => 'tokn_test_456'
]);

echo "บันทึกบัตรแล้ว: " . $customer['default_card'];

// หรือสร้างลูกค้าพร้อมบัตรในขั้นตอนเดียว
$customer = OmiseCustomer::create([
    'email' => 'customer@example.com',
    'description' => 'John Doe',
    'card' => 'tokn_test_123'
]);

การแสดงรายชื่อบัตรลูกค้า​

<?php
$customer = OmiseCustomer::retrieve('cust_test_123');

foreach ($customer['cards']['data'] as $card) {
    echo $card['brand'] . " ลงท้ายด้วย " . $card['last_digits'] . PHP_EOL;
    echo "หมดอายุ: " . $card['expiration_month'] . "/" . $card['expiration_year'] . PHP_EOL;
}

การสร้างการคืนเงิน​

<?php
// คืนเงินเต็มจำนวน
$refund = OmiseRefund::create('chrg_test_123', [
    'amount' => null  // null สำหรับการคืนเงินเต็มจำนวน
]);

// คืนเงินบางส่วน
$refund = OmiseRefund::create('chrg_test_123', [
    'amount' => 25000,  // 250.00 THB
    'metadata' => [
        'reason' => 'customer_request',
        'ticket_id' => 'TICKET-123'
    ]
]);

echo "คืนเงิน " . $refund['id'] . ": " . $refund['amount'] . " " . $refund['currency'];

การสร้างการโอน​

<?php
// สร้างการโอนไปยังบัญชีธนาคารของคุณ
$transfer = OmiseTransfer::create([
    'amount' => 500000,  // 5,000.00 THB
    'recipient' => 'recp_test_123',
    'metadata' => [
        'payout_id' => 'PAYOUT-456'
    ]
]);

echo "โอน " . $transfer['id'] . ": " . $transfer['amount'];

วิธีการชำระเงินแบบอื่น​

การสร้างแหล่งที่มา​

<?php
// QR PromptPay
$source = OmiseSource::create([
    'type' => 'promptpay',
    'amount' => 100000,
    'currency' => 'THB'
]);

// แสดง QR code ให้ลูกค้า
echo "URL QR Code: " . $source['scannable_code']['image']['download_uri'];

// สร้างค่าธรรมเนียมด้วย source
$charge = OmiseCharge::create([
    'amount' => 100000,
    'currency' => 'THB',
    'source' => $source['id'],
    'return_uri' => 'https://example.com/payment/callback'
]);

ธนาคารอินเทอร์เน็ต​

<?php
// ธนาคารอินเทอร์เน็ต
$source = OmiseSource::create([
    'type' => 'internet_banking_scb',
    'amount' => 100000,
    'currency' => 'THB'
]);

$charge = OmiseCharge::create([
    'amount' => 100000,
    'currency' => 'THB',
    'source' => $source['id'],
    'return_uri' => 'https://example.com/payment/callback'
]);

// เปลี่ยนเส้นทางลูกค้าไปยัง authorize_uri
header('Location: ' . $charge['authorize_uri']);
exit;

Mobile Banking​

<?php
// Mobile Banking (SCB Easy)
$source = OmiseSource::create([
    'type' => 'mobile_banking_scb',
    'amount' => 100000,
    'currency' => 'THB'
]);

$charge = OmiseCharge::create([
    'amount' => 100000,
    'currency' => 'THB',
    'source' => $source['id'],
    'return_uri' => 'https://example.com/payment/callback'
]);

การผ่อนชำระ​

<?php
// การชำระแบบผ่อน
$source = OmiseSource::create([
    'type' => 'installment_kbank',
    'amount' => 100000,
    'currency' => 'THB',
    'installment_term' => 6  // 6 เดือน
]);

$charge = OmiseCharge::create([
    'amount' => 100000,
    'currency' => 'THB',
    'source' => $source['id'],
    'return_uri' => 'https://example.com/payment/callback'
]);

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

ไลบรารีโยน exceptions สำหรับข้อผิดพลาดประเภทต่างๆ:

<?php
require_once 'vendor/autoload.php';

try {
    $charge = OmiseCharge::create([
        'amount' => 100000,
        'currency' => 'THB',
        'card' => 'tokn_test_123'
    ]);
} catch (OmiseException $e) {
    // รับรายละเอียดข้อผิดพลาด
    echo "ข้อผิดพลาด: " . $e->getMessage() . PHP_EOL;
    echo "สถานะ HTTP: " . $e->getHttpStatus() . PHP_EOL;
    echo "รหัสข้อผิดพลาด: " . $e->getOmiseCode() . PHP_EOL;

    // จัดการข้อผิดพลาดเฉพาะ
    if ($e->getOmiseCode() === 'authentication_failure') {
        echo "API key ไม่ถูกต้อง";
    } elseif ($e->getOmiseCode() === 'invalid_card') {
        echo "บัตรถูกปฏิเสธ";
    }
}

การจัดการข้อผิดพลาดบัตรเฉพาะ​

<?php
function handleCardError(OmiseException $e): string
{
    $errorMessages = [
        'insufficient_fund' => 'เงินในบัตรไม่เพียงพอ',
        'stolen_or_lost_card' => 'บัตรถูกรายงานว่าถูกขโมยหรือสูญหาย',
        'invalid_security_code' => 'รหัส CVV ไม่ถูกต้อง',
        'payment_cancelled' => 'การชำระเงินถูกยกเลิก'
    ];

    return $errorMessages[$e->getOmiseCode()] ?? "ข้อผิดพลาดบัตร: " . $e->getMessage();
}

try {
    $charge = OmiseCharge::create([
        'amount' => 100000,
        'currency' => 'THB',
        'card' => $token
    ]);
} catch (OmiseException $e) {
    $errorMessage = handleCardError($e);
    // แสดงข้อผิดพลาดให้ผู้ใช้
}

การผสานรวม Laravel​

ตัวอย่างตัวควบคุม​

<?php
namespace App\Http\ตัวควบคุมs;

use Illuminate\Http\Request;
use Illuminate\การสนับสนุน\Facades\Log;
use App\Models\Order;
use App\Models\Payment;

class Paymentตัวควบคุม extends ตัวควบคุม
{
    public function __construct()
    {
        define('OMISE_SECRET_KEY', config('services.omise.secret_key'));
        define('OMISE_PUBLIC_KEY', config('services.omise.public_key'));
    }
    
    public function create(Request $request, $orderId)
    {
        $order = Order::findOrFail($orderId);
        
        $request->validate([
            'omise_token' => 'required|string',
        ]);
        
        try {
            $charge = \OmiseCharge::create([
                'amount' => (int)($order->total * 100),
                'currency' => 'THB',
                'card' => $request->omise_token,
                'description' => "Order #{$order->id}",
                'metadata' => [
                    'order_id' => $order->id,
                    'customer_email' => $order->email
                ],
                'return_uri' => route('payment.callback')
            ]);
            
            // บันทึกข้อมูลการชำระเงิน
            Payment::create([
                'order_id' => $order->id,
                'charge_id' => $charge['id'],
                'amount' => $order->total,
                'status' => $charge['status'],
                'paid' => $charge['paid']
            ]);

            if ($charge['paid']) {
                $order->update(['payment_status' => 'paid']);
                return redirect()->route('orders.show', $order)
                    ->with('success', 'ชำระเงินสำเร็จ!');
            } elseif (isset($charge['authorize_uri'])) {
                // ต้องใช้ 3D Secure
                return redirect($charge['authorize_uri']);
            } else {
                return back()->with('error', $charge['failure_message']);
            }

        } catch (\OmiseException $e) {
            Log::error('Omise error: ' . $e->getMessage());
            return back()->with('error', 'การชำระเงินล้มเหลว กรุณาลองอีกครั้ง');
        }
    }
    
    public function callback(Request $request)
    {
        $chargeId = $request->query('id');
        
        try {
            $charge = \OmiseCharge::retrieve($chargeId);
            $payment = Payment::where('charge_id', $charge['id'])->firstOrFail();
            
            $payment->update([
                'status' => $charge['status'],
                'paid' => $charge['paid']
            ]);
            
            if ($charge['paid']) {
                $payment->order->update(['payment_status' => 'paid']);
                return redirect()->route('orders.show', $payment->order)
                    ->with('success', 'ชำระเงินสำเร็จ!');
            } else {
                return redirect()->route('payment.form', $payment->order)
                    ->with('error', $charge['failure_message']);
            }

        } catch (\Exception $e) {
            return redirect()->route('home')
                ->with('error', 'การตรวจสอบการชำระเงินล้มเหลว');
        }
    }
}

การผสานรวม Model​

<?php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Payment extends Model
{
    protected $fillable = [
        'order_id', 'charge_id', 'amount', 'currency', 'status',
        'paid', 'failure_code', 'failure_message', 'refund_id', 'refund_amount'
    ];
    
    protected $casts = [
        'amount' => 'decimal:2',
        'refund_amount' => 'decimal:2',
        'paid' => 'boolean'
    ];
    
    public function __construct()
    {
        parent::__construct();
        define('OMISE_SECRET_KEY', config('services.omise.secret_key'));
    }
    
    public function order()
    {
        return $this->belongsTo(Order::class);
    }
    
    public function charge(string $token): array
    {
        $charge = \OmiseCharge::create([
            'amount' => (int)($this->amount * 100),
            'currency' => $this->currency,
            'card' => $token,
            'description' => "Order #{$this->order->id}",
            'metadata' => $this->getChargeMetadata()
        ]);
        
        $this->update([
            'charge_id' => $charge['id'],
            'status' => $charge['status'],
            'paid' => $charge['paid']
        ]);
        
        return $charge;
    }
    
    public function refund(?float $refundAmount = null): array
    {
        if (!$this->charge_id) {
            throw new \Exception('ไม่สามารถคืนเงินได้หากไม่มี charge_id');
        }
        
        $refund = \OmiseRefund::create($this->charge_id, [
            'amount' => $refundAmount ? (int)($refundAmount * 100) : null
        ]);
        
        $this->update([
            'refund_id' => $refund['id'],
            'refund_amount' => $refund['amount'] / 100,
            'status' => 'refunded'
        ]);
        
        return $refund;
    }
    
    public function refreshStatus(): void
    {
        if (!$this->charge_id) {
            return;
        }
        
        $charge = \OmiseCharge::retrieve($this->charge_id);
        
        $this->update([
            'status' => $charge['status'],
            'paid' => $charge['paid'],
            'failure_code' => $charge['failure_code'] ?? null,
            'failure_message' => $charge['failure_message'] ?? null
        ]);
    }
    
    protected function getChargeMetadata(): array
    {
        return [
            'order_id' => $this->order->id,
            'customer_email' => $this->order->email,
            'customer_name' => $this->order->customer_name
        ];
    }
}

Queue Job สำหรับการประมวลผลแบบ Async​

<?php
namespace App\Jobs;

use App\Models\Payment;
use App\Mail\PaymentConfirmed;
use App\Mail\PaymentFailed;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
use Illuminate\การสนับสนุน\Facades\Mail;
use Illuminate\การสนับสนุน\Facades\Log;

class ProcessChargeJob implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
    
    public $tries = 3;
    public $backoff = [60, 120, 240];
    
    protected $paymentId;
    protected $token;
    
    public function __construct(int $paymentId, string $token)
    {
        $this->paymentId = $paymentId;
        $this->token = $token;
        
        define('OMISE_SECRET_KEY', config('services.omise.secret_key'));
    }
    
    public function handle()
    {
        $payment = Payment::findOrFail($this->paymentId);
        
        try {
            $charge = $payment->charge($this->token);
            
            if ($charge['paid']) {
                Mail::to($payment->order->email)
                    ->send(new PaymentConfirmed($payment));
            } else {
                Mail::to($payment->order->email)
                    ->send(new PaymentFailed($payment, $charge['failure_message']));
            }
            
        } catch (\OmiseException $e) {
            $payment->update([
                'status' => 'failed',
                'failure_message' => $e->getMessage()
            ]);
            
            Mail::to($payment->order->email)
                ->send(new PaymentFailed($payment, $e->getMessage()));
                
            Log::error('Charge processing failed', [
                'payment_id' => $this->paymentId,
                'error' => $e->getMessage()
            ]);
        }
    }
}

บริการ Provider​

<?php
namespace App\Providers;

use Illuminate\การสนับสนุน\บริการProvider;

class OmiseบริการProvider extends บริการProvider
{
    public function register()
    {
        $this->app->singleton('omise', function ($app) {
            return new \OmiseClient(
                config('services.omise.secret_key'),
                config('services.omise.public_key')
            );
        });
    }
    
    public function boot()
    {
        if ($this->app->runningInConsole()) {
            $this->publishes([
                __DIR__.'/../config/omise.php' => config_path('omise.php'),
            ], 'config');
        }
    }
}

แนวทางปฏิบัติที่ดีที่สุด​

1. ใช้ตัวแปรสภาพแวดล้อมสำหรับ Keys​

<?php
// ห้ามเขียน API keys แบบ hardcode
// แย่
define('OMISE_SECRET_KEY', 'skey_test_123456789');

// ดี
define('OMISE_SECRET_KEY', getenv('OMISE_SECRET_KEY'));

// ดีกว่า (Laravel)
define('OMISE_SECRET_KEY', config('services.omise.secret_key'));

// ตรวจสอบว่า keys มีอยู่
if (empty(OMISE_SECRET_KEY)) {
    throw new \RuntimeException('OMISE_SECRET_KEY ยังไม่ถูกตั้งค่า');
}

2. จัดการ Idempotency​

<?php
class Paymentบริการ
{
    public function createIdempotentCharge(
        int $amount,
        string $currency,
        string $token,
        string $orderId
    ): array {
        $idempotencyKey = sprintf('order-%s-%s', $orderId, time());

        // เก็บ idempotency key ใน cache/database
        \Cache::put("charge:idempotency:{$orderId}", $idempotencyKey, 3600);
        
        return OmiseCharge::create([
            'amount' => $amount,
            'currency' => $currency,
            'card' => $token
        ], $idempotencyKey);
    }
}

3. ใช้ Type Declarations (PHP 7.4+)​

<?php
declare(strict_types=1);

class Chargeบริการ
{
    private string $secretKey;
    
    public function __construct(string $secretKey)
    {
        $this->secretKey = $secretKey;
        define('OMISE_SECRET_KEY', $secretKey);
    }
    
    public function createCharge(
        int $amount,
        string $currency,
        string $token,
        array $metadata = []
    ): array {
        return OmiseCharge::create([
            'amount' => $amount,
            'currency' => $currency,
            'card' => $token,
            'metadata' => $metadata
        ]);
    }
}

4. เก็บข้อมูลขั้นต่ำ​

<?php
class Payment
{
    private string $chargeId;
    private ?array $chargeCache = null;
    
    public function getCharge(): array
    {
        if ($this->chargeCache === null) {
            $this->chargeCache = \OmiseCharge::retrieve($this->chargeId);
        }
        return $this->chargeCache;
    }
    
    public function refreshCharge(): array
    {
        $this->chargeCache = null;
        return $this->getCharge();
    }
}

5. ตรวจสอบความถูกต้องก่อนเรียก API​

<?php
class ChargeValidator
{
    public function validate(int $amount, string $currency): void
    {
        if ($amount < 2000) {
            throw new \InvalidArgumentException('จำนวนเงินต้องมีอย่างน้อย 20 บาท');
        }

        $allowedCurrencies = ['THB', 'USD', 'SGD', 'JPY'];
        if (!in_array($currency, $allowedCurrencies)) {
            throw new \InvalidArgumentException("สกุลเงิน {$currency} ไม่รองรับ");
        }
    }
}

// การใช้
$validator = new ChargeValidator();
$validator->validate(100000, 'THB');
$charge = OmiseCharge::create([...]);

6. ใช้ Logging​

<?php
use Psr\Log\LoggerInterface;

class Paymentบริการ
{
    private LoggerInterface $logger;

    public function __construct(LoggerInterface $logger)
    {
        $this->logger = $logger;
    }

    public function createCharge(array $params): array
    {
        $this->logger->info('กำลังสร้างค่าธรรมเนียม', [
            'amount' => $params['amount'],
            'currency' => $params['currency']
        ]);

        try {
            $charge = OmiseCharge::create($params);

            $this->logger->info('สร้างค่าธรรมเนียมแล้ว', [
                'charge_id' => $charge['id'],
                'paid' => $charge['paid']
            ]);

            return $charge;

        } catch (\OmiseException $e) {
            $this->logger->error('การสร้างค่าธรรมเนียมล้มเหลว', [
                'error' => $e->getMessage(),
                'code' => $e->getOmiseCode()
            ]);

            throw $e;
        }
    }
}

การทดสอบ​

ตัวอย่าง PHPUnit​

<?php
namespace Tests\Unit;

use PHPUnit\Framework\TestCase;
use Mockery;

class PaymentบริการTest extends TestCase
{
    protected function tearDown(): void
    {
        Mockery::close();
    }
    
    public function testCreateCharge()
    {
        // Mock OmiseCharge
        $chargeMock = Mockery::mock('alias:OmiseCharge');
        $chargeMock->shouldReceive('create')
            ->once()
            ->with([
                'amount' => 100000,
                'currency' => 'THB',
                'card' => 'tokn_test_123'
            ])
            ->andReturn([
                'id' => 'chrg_test_123',
                'amount' => 100000,
                'currency' => 'THB',
                'paid' => true,
                'status' => 'successful'
            ]);
        
        $service = new \App\บริการs\Paymentบริการ();
        $charge = $service->createCharge(100000, 'THB', 'tokn_test_123');
        
        $this->assertEquals('chrg_test_123', $charge['id']);
        $this->assertTrue($charge['paid']);
    }
    
    public function testCreateChargeWithError()
    {
        $this->expectException(\OmiseException::class);
        
        $chargeMock = Mockery::mock('alias:OmiseCharge');
        $chargeMock->shouldReceive('create')
            ->once()
            ->andThrow(new \OmiseException('insufficient_fund'));
        
        $service = new \App\บริการs\Paymentบริการ();
        $service->createCharge(100000, 'THB', 'tokn_test_123');
    }
}

Laravel Feature Tests​

<?php
namespace Tests\Feature;

use Tests\TestCase;
use App\Models\Order;
use App\Models\Payment;
use Illuminate\Foundation\การทดสอบ\RefreshDatabase;
use Mockery;

class PaymentตัวควบคุมTest extends TestCase
{
    use RefreshDatabase;
    
    protected function setUp(): void
    {
        parent::setUp();
        config(['services.omise.secret_key' => 'skey_test_123']);
    }
    
    public function testCreatePayment()
    {
        $order = Order::factory()->create(['total' => 1000.00]);
        
        $chargeMock = Mockery::mock('alias:OmiseCharge');
        $chargeMock->shouldReceive('create')
            ->once()
            ->andReturn([
                'id' => 'chrg_test_123',
                'paid' => true,
                'status' => 'successful'
            ]);
        
        $response = $this->post("/payment/{$order->id}", [
            'omise_token' => 'tokn_test_123'
        ]);
        
        $response->assertRedirect(route('orders.show', $order));
        $this->assertDatabaseHas('payments', [
            'order_id' => $order->id,
            'charge_id' => 'chrg_test_123',
            'paid' => true
        ]);
    }
}

การแก้ไขปัญหา​

ข้อผิดพลาดใบรับรอง SSL​

<?php
// อัปเดต CA bundle (ไม่แนะนำสำหรับการใช้งานจริง)
define('OMISE_CA_BUNDLE_PATH', '/path/to/cacert.pem');

// หรือปิดการตรวจสอบ SSL (สำหรับการทดสอบเท่านั้น!)
// ไม่แนะนำสำหรับการใช้งานจริง

หมดเวลาการเชื่อมต่อ​

<?php
// ตั้งค่า timeout แบบกำหนดเอง
define('OMISE_API_TIMEOUT', 60);  // วินาที

โหมดดีบัก​

<?php
// เปิดใช้งานโหมด debug
define('OMISE_DEBUG', true);

// จะแสดงรายละเอียด request/response

การตรวจสอบลายเซ็นเว็บฮุก​

<?php
function verifyWebhookSignature(string $payload, string $signature, string $secret): bool
{
    $expectedSignature = hash_hmac('sha256', $payload, $secret);
    return hash_equals($signature, $expectedSignature);
}

// การใช้
$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_OMISE_SIGNATURE'] ?? '';

if (!verifyWebhookSignature($payload, $signature, getenv('OMISE_WEBHOOK_SECRET'))) {
    http_response_code(401);
    exit('ลายเซ็นไม่ถูกต้อง');
}

$event = json_decode($payload, true);
// ประมวลผล event

คำถามที่พบบ่อย​

ฉันจะจัดการ webhooks ใน Laravel ได้อย่างไร?​

<?php
namespace App\Http\ตัวควบคุมs;

use Illuminate\Http\Request;
use Illuminate\การสนับสนุน\Facades\Log;

class Webhookตัวควบคุม extends ตัวควบคุม
{
    public function omise(Request $request)
    {
        // ตรวจสอบลายเซ็น
        $payload = $request->getContent();
        $signature = $request->header('Omise-Signature');

        if (!$this->verifySignature($payload, $signature)) {
            return response()->json(['error' => 'ลายเซ็นไม่ถูกต้อง'], 401);
        }
        
        $event = $request->json()->all();
        
        switch ($event['key']) {
            case 'charge.complete':
                $this->handleChargeComplete($event['data']);
                break;
            case 'refund.create':
                $this->handleRefundCreate($event['data']);
                break;
        }
        
        return response()->json(['status' => 'ok']);
    }
    
    protected function verifySignature(string $payload, string $signature): bool
    {
        $expected = hash_hmac('sha256', $payload, config('services.omise.webhook_secret'));
        return hash_equals($signature, $expected);
    }
    
    protected function handleChargeComplete(array $chargeData): void
    {
        $charge = \OmiseCharge::retrieve($chargeData['id']);
        $payment = Payment::where('charge_id', $charge['id'])->first();
        
        if ($payment) {
            $payment->update([
                'status' => $charge['status'],
                'paid' => $charge['paid']
            ]);
        }
    }
}

ฉันจะทดสอบการชำระเงินโดยไม่มีการเรียกเก็บเงินจริงได้อย่างไร?​

<?php
// ใช้ API keys แบบทดสอบ
define('OMISE_SECRET_KEY', 'skey_test_123456789');

// ใช้โทเค็นบัตรทดสอบ
// สำเร็จ: tokn_test_5086xl7ddjbases4sq3i
// ปฏิเสธ: tokn_test_no1

$charge = OmiseCharge::create([
    'amount' => 100000,
    'currency' => 'THB',
    'card' => 'tokn_test_5086xl7ddjbases4sq3i'
]);

// ตรวจสอบโหมดทดสอบ
var_dump($charge['livemode'] === false);

ฉันจะจัดการการแปลงสกุลเงินได้อย่างไร?​

<?php
class Money
{
    private int $amountSatang;
    
    public function __construct(float $amountBaht)
    {
        $this->amountSatang = (int)($amountBaht * 100);
    }
    
    public function getSatang(): int
    {
        return $this->amountSatang;
    }
    
    public function getBaht(): float
    {
        return $this->amountSatang / 100;
    }
    
    public static function fromSatang(int $amountSatang): self
    {
        $instance = new self(0);
        $instance->amountSatang = $amountSatang;
        return $instance;
    }
}

// การใช้
$money = new Money(1000.00);  // 1000.00 THB
$charge = OmiseCharge::create([
    'amount' => $money->getSatang(),  // 100000 satang
    'currency' => 'THB',
    'card' => 'tokn_test_123'
]);

ฉันจะใช้ logic การลองใหม่ได้อย่างไร?​

<?php
function createChargeWithRetry(array $params, int $maxRetries = 3): array
{
    $attempt = 0;

    while ($attempt < $maxRetries) {
        try {
            return OmiseCharge::create($params);
        } catch (\OmiseException $e) {
            $attempt++;

            if ($attempt >= $maxRetries) {
                throw $e;
            }

            // Exponential backoff
            sleep(2 ** $attempt);
        }
    }
}

ฉันจะจัดการการคืนเงินบางส่วนได้อย่างไร?​

<?php
function refundCharge(string $chargeId, ?float $refundAmount = null): array
{
    // รับข้อมูลค่าธรรมเนียมปัจจุบัน
    $charge = \OmiseCharge::retrieve($chargeId);

    // คำนวณจำนวนเงินที่สามารถคืนได้
    $refundable = $charge['amount'] - $charge['refunded'];

    if ($refundAmount !== null) {
        $refundAmountSatang = (int)($refundAmount * 100);
        if ($refundAmountSatang > $refundable) {
            throw new \Exception("จำนวนเงินคืนเกินจำนวนที่สามารถคืนได้");
        }
    } else {
        $refundAmountSatang = null;  // คืนเงินเต็มจำนวน
    }

    return \OmiseRefund::create($chargeId, [
        'amount' => $refundAmountSatang
    ]);
}

ฉันจะบันทึกบัตรหลายใบสำหรับลูกค้าได้อย่างไร?​

<?php
function addCardToCustomer(string $customerId, string $token): array
{
    return \OmiseCustomer::update($customerId, [
        'card' => $token
    ]);
}

function listCustomerCards(string $customerId): array
{
    $customer = \OmiseCustomer::retrieve($customerId);
    return $customer['cards']['data'];
}

function chargeSpecificCard(string $customerId, string $cardId, int $amount): array
{
    return \OmiseCharge::create([
        'amount' => $amount,
        'currency' => 'THB',
        'customer' => $customerId,
        'card' => $cardId
    ]);
}

ฉันจะใช้ระบบเรียกเก็บเงินแบบสมาชิกได้อย่างไร?​

<?php
class SubscriptionManager
{
    private string $customerId;
    private int $planAmount;
    
    public function __construct(string $customerId, int $planAmount)
    {
        $this->customerId = $customerId;
        $this->planAmount = $planAmount;
    }
    
    public function chargeMonthly(): array
    {
        return \OmiseCharge::create([
            'amount' => $this->planAmount,
            'currency' => 'THB',
            'customer' => $this->customerId,
            'description' => 'Subscription ' . date('F Y')
        ]);
    }
    
    public function handleFailedPayment(array $charge): void
    {
        // ส่งการแจ้งเตือน
        // อัปเดตสถานะสมาชิก
        // ลองใหม่หลังจากช่วงเวลาผ่อนผัน
    }
}

// Laravel Command
namespace App\Console\Commands;

use Illuminate\Console\Command;
use App\Models\Subscription;

class ChargeSubscriptions extends Command
{
    protected $signature = 'subscriptions:charge';
    
    public function handle()
    {
        $subscriptions = Subscription::where('status', 'active')->get();
        
        foreach ($subscriptions as $subscription) {
            $manager = new SubscriptionManager(
                $subscription->customer_id,
                $subscription->plan_amount
            );
            
            try {
                $charge = $manager->chargeMonthly();
                $subscription->update(['last_charge_date' => now()]);
            } catch (\OmiseException $e) {
                $manager->handleFailedPayment($charge);
            }
        }
    }
}

ทรัพยากรที่เกี่ยวข้อง​

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

การสนับสนุน​

หากคุณพบปัญหากับไลบรารี PHP:

  1. ตรวจสอบ GitHub Issues
  2. ตรวจสอบ เอกสาร API
  3. ติดต่อ support@omise.co พร้อม:
    • เวอร์ชัน PHP
    • เวอร์ชันไลบรารี omise-php
    • ข้อความข้อผิดพลาดและ stack trace
    • ขั้นตอนในการสร้างซ้ำ