Skip to Content
docs

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-php

Sü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əyin
11 }
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: Blokla
2$response = $client->preauth()
3 ->amount(100.00)
4 ->orderId('ORDER-004')
5 ->description('Hotel reservation')
6 ->send();
7
8// Addım 2: Vəsaiti çək
9$completeResponse = $client->preauth()
10 ->complete($response->getTransaction(), 85.00);

Geri Qaytarma və Əks Əməliyyat

PHP
1// Qeydiyyatlı karta geri qaytarma
2$response = $client->refund()
3 ->cardId('card-id')
4 ->orderId('order-id')
5 ->amount(50.00)
6 ->send();
7
8// Əks əməliyyat
9$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ı

MetodAçı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

Keçidlər