PHP SDK
Epoint.az ödəniş şlüzünü tətbiqinizə inteqrasiya etmək üçün müasir PHP SDK. Bütün ödəniş üsullarını, kart tokenizasiyasını, bölünmüş ödənişləri, ön avtorizasiyanı, Apple Pay, Google Pay, cüzdanları və fakturaları dəstəkləyir.
Xüsusiyyətlər
- Standart ödənişlər, checkout yönləndirmə
- Kart qeydiyyatı və saxlanmış kart ödənişləri
- Tacirlər arasında bölünmüş ödənişlər
- Ön avtorizasiya (blokla və çək)
- Geri qaytarmalar və əks əməliyyatlar
- Token widget vasitəsilə Apple Pay və Google Pay
- Cüzdan ödənişləri
- Faktura idarəetməsi
- Callback-lər üçün imza doğrulaması
- PHP 8.2+ enum-ları ilə tip-təhlükəsiz
Tələblər
- PHP 8.2 və ya yuxarı
- ext-json, ext-curl
Quraşdırma
cURL
1composer require rafoabbas/epoint-phpSürətli Başlanğıc
Müştəri İnisializasiyası
PHP
1use Epoint\EpointClient;2
3$client = new EpointClient(4 publicKey: 'i000000001',5 privateKey: 'your-private-key'6);Ödəniş Yaratma
PHP
1use Epoint\Enums\Language;2
3$response = $client->payment()4 ->amount(100.50)5 ->orderId('ORDER-12345')6 ->description('Product purchase')7 ->language(Language::EN)8 ->successUrl('https://yoursite.com/payment/success')9 ->errorUrl('https://yoursite.com/payment/error')10 ->send();11
12if ($response->isSuccess()) {13 header('Location: ' . $response->getRedirectUrl());14}Callback İşləmə
PHP
1$data = $_POST['data'];2$signature = $_POST['signature'];3
4try {5 $callbackData = $client->verifyCallback($data, $signature);6
7 if ($callbackData['status'] === 'success') {8 $orderId = $callbackData['order_id'];9 $transaction = $callbackData['transaction'];10 // Verilənlər bazanızı yeniləyin11 }12} catch (\Epoint\Exceptions\SignatureVerificationException $e) {13 http_response_code(400);14}Ödəniş Statusunun Yoxlanması
PHP
1$status = $client->checkStatus()2 ->transaction('te001234567')3 ->get();4
5if ($status->getPaymentStatus() === \Epoint\Enums\PaymentStatus::SUCCESS) {6 echo 'Ödəniş uğurlu!';7}Kart Qeydiyyatı
PHP
1$response = $client->registerCard()2 ->description('Save card for future purchases')3 ->successUrl('https://yoursite.com/cards/success')4 ->errorUrl('https://yoursite.com/cards/error')5 ->send();Saxlanmış Kartla Ödəniş
PHP
1$response = $client->savedCardPayment()2 ->cardId('saved-card-id')3 ->amount(25.00)4 ->orderId('ORDER-002')5 ->description('Subscription renewal')6 ->execute();Bölünmüş Ödəniş
PHP
1$response = $client->splitPayment()2 ->amount(100.00)3 ->orderId('ORDER-003')4 ->splitUser('i000000002')5 ->splitAmount(30.00)6 ->description('Marketplace order')7 ->send();Ön Avtorizasiya
PHP
1// Addım 1: Blokla2$response = $client->preauth()3 ->amount(100.00)4 ->orderId('ORDER-004')5 ->description('Hotel reservation')6 ->send();7
8// Addım 2: Vəsaiti çək9$completeResponse = $client->preauth()10 ->complete($response->getTransaction(), 85.00);Geri Qaytarma və Əks Əməliyyat
PHP
1// Qeydiyyatlı karta geri qaytarma2$response = $client->refund()3 ->cardId('card-id')4 ->orderId('order-id')5 ->amount(50.00)6 ->send();7
8// Əks əməliyyat9$response = $client->reverse()10 ->transaction('te001234567')11 ->amount(100.00)12 ->send();Apple Pay / Google Pay
PHP
1$widget = $client->widget()2 ->amount(75.00)3 ->orderId('ORDER-005')4 ->description('Digital wallet payment')5 ->create();6
7echo '<iframe src="' . $widget->getWidgetUrl() . '"></iframe>';Fakturalar
PHP
1$invoice = $client->invoice()->create([2 'sum' => 150.00,3 'display' => 1,4 'save_as_template' => 0,5 'name' => 'John Doe',6 'description' => 'Invoice for services',7 'period_from' => '2024-01-01',8 'period_to' => '2024-12-31',9]);10
11$client->invoice()->sendSms($invoice['id'], '+994501234567');12$client->invoice()->sendEmail($invoice['id'], '[email protected]');API Referansı
| Metod | Açıqlama |
|---|---|
payment() | Standart ödəniş yaratma |
checkStatus() | Ödəniş statusunu yoxlama |
registerCard() | Ödənişsiz kart qeydiyyatı |
registerCardWithPay() | Ödənişlə kart qeydiyyatı |
savedCardPayment() | Saxlanmış kartla ödəniş |
refund() | Geri qaytarma |
reverse() | Əks əməliyyat |
splitPayment() | Bölünmüş ödəniş |
splitCardPayment() | Saxlanmış kartla bölünmüş ödəniş |
preauth() | Ön avtorizasiya |
widget() | Apple Pay / Google Pay widget |
wallet() | Cüzdan əməliyyatları |
invoice() | Faktura idarəetməsi |
heartbeat() | API sağlamlıq yoxlaması |
verifyCallback() | Callback imzasını doğrulama |