PHPackages                             sportakal/garantipos - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. sportakal/garantipos

ActiveLibrary[Payment Processing](/categories/payments)

sportakal/garantipos
====================

0.1.4(3y ago)3491MITPHP

Since May 27Pushed 3y ago1 watchersCompare

[ Source](https://github.com/sportakal/garantipos)[ Packagist](https://packagist.org/packages/sportakal/garantipos)[ RSS](/packages/sportakal-garantipos/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (9)Dependencies (2)Versions (10)Used By (0)

Garanti Pos PHP SDK
===================

[](#garanti-pos-php-sdk)

Garanti bankası sanal pos işlemleri için php entegrasyon kütüphanesidir. 3D Secure, XMLPay ve İade işlemlerini kolayca yapabilirsiniz.

Test ve canlı ortam kullanıcı bilgileri için Garanti Bankası ile iletişime geçmelisiniz.

Installation
============

[](#installation)

### Composer

[](#composer)

Bağımlılıkları [Composer](http://getcomposer.org/) ile yükleyebilirsiniz.

```
$ composer require sportakal/garantipos
```

Bağımlılıkları kullanmak için Composer'ın [autoload](https://getcomposer.org/doc/00-intro.md#autoloading) özelliğini kullanın.

```
require_once('vendor/autoload.php');
```

Usage
=====

[](#usage)

Sanalpos kullanıcı bilgilerinizi **Options** nesnesine atayın.

```
use Sportakal\Garantipos\Models\Options;

$options = new Options();
$options->setMode($_ENV['MODE']);
$options->setApiVersion($_ENV['API_VERSION']);
$options->setTerminalId($_ENV['TERMINAL_ID']);
$options->setTerminalProvUserId($_ENV['TERMINAL_PROV_USER_ID_PAY']);
$options->setTerminalProvUserPassword($_ENV['TERMINAL_PROV_USER_PASSWORD']);
$options->setTerminalUserId($_ENV['TERMINAL_USER_ID']);
$options->setTerminalMerchantId($_ENV['TERMINAL_MERCHANT_ID']);
$options->setStoreKey($_ENV['STORE_KEY']);
```

Kart bilgilerini **Card** nesnesine atayın.

```
$card = new Card();
$card->setNumber('5549608789641500');
$card->setExpireDate('0323');
$card->setCVV2('712');
```

Müşteri bilgilerini **Customer** nesnesine atayın.

```
$customer = new Customer();
$customer->setIpAddress('159.146.45.34');
$customer->setEmailAddress('portakalsinan@gmail.com');
```

Sipariş bilgilerini **Order** nesnesine atayın.

```
$order = new Order();
$order->setOrderID('sportakal_garantipos_' . time());
```

Adres bilgilerini **Address** nesnesine atayın.

```
$address = new Address();
$address->setType('B'); // B for 'billing' or S for 'shipping'
$address->setName('Sinan');
$address->setLastName('Portakal');
$address->setPhoneNumber('+90 532 345 67 89');
$address->setText('Kınıklı Mah.');
$address->setDistrict('Pamukkale');
$address->setCity('Denizli');
$address->setCountry('Turkey');
```

**addAddress** methoduyla siparişinize ekleyin.

```
$order->addAddress($address);
```

İşlem bilgilerini **Transaction** nesnesine atayın.

```
$transaction = new Transaction();
$transaction->setInstallmentCnt("");
$transaction->setAmount(1000);
$transaction->setCurrencyCode('TRY');
$transaction->setCardholderPresentCode('0');
$transaction->setMotoInd('N');
$transaction->setDescription('test payment');
```

Tüm bu nesneleri **RequestModel** nesnesinde toplayın.

```
$request = new RequestModel();
$request->setOptions($options);
$request->setCard($card);
$request->setCustomer($customer);
$request->setOrder($order);
$request->setTransaction($transaction);
```

RequestModel'i yapacağınız işleme göre **Request** nesnesine atayın.

### 3D Secure'siz işlem için

[](#3d-securesiz-işlem-için)

```
$request = new \Sportakal\Garantipos\Requests\Pay($request);
```

### İade işlemi için

[](#i̇ade-işlemi-için)

```
$request = new \Sportakal\Garantipos\Requests\Refund($request);
```

### 3D Secure Pay işlemi için

[](#3d-secure-pay-işlemi-için)

```
$request = new \Sportakal\Garantipos\Requests\ThreeDSecurePay($request);
```

### İşlemlerin sonucu

[](#i̇şlemlerin-sonucu)

İşlemin sonucunu aşağıdaki şekilde kontrol edebilirsiniz.

```
$result = $request->getResult();

$status = $result->getStatus(); //boolean
$message = $result->getStatusMessage(); //string
$error_message = $result->getErrorMessage()); //string
```

3D Secure işlemlerde mdStatusCode ve mdErrorMessage değerleri de döner.

3D Secure işlemi sonucunda veriler, **successUrl** veya **errorUrl** olarak belirlediğiniz adrese post edilir. Bu adreste aşağıdaki methodla bu verileri yakalayabilirsiniz ve mdStatus değerlerini kontrol edebilirsiniz.

```
$result = new \Sportakal\Garantipos\Results\ThreeDSecurePayResult($options);

$md_status = $result->getMdStatus();
$md_response_message = $result->getResponseMessage();
$md_error_message = $result->getErrorMessage()
```

İşlemlerin sonucunda **Order** ve **Transaction** nesneleri de döner.

```
$order = $result->getOrder();
$transaction = $result->getTransaction();
```

***/samples*** klasöründe daha fazla örnek bulabilirsiniz.

Development
-----------

[](#development)

Bağımlılıkları yükleyin:

```
composer install
```

Milestones
----------

[](#milestones)

- Daha fazla işlem türü eklenecek
    - İptal İşlemi
    - Garanti Pay
    - Bin sorgulama
    - TCKN sorgulama
    - Ön Provizyon işlemleri

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

9

Last Release

1443d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7b295ac13f35ddd8353ed14e752e200b61ffc289beeddc692eeeef7e6af08bbc?d=identicon)[sportakal](/maintainers/sportakal)

---

Top Contributors

[![sportakal](https://avatars.githubusercontent.com/u/44243313?v=4)](https://github.com/sportakal "sportakal (12 commits)")

### Embed Badge

![Health badge](/badges/sportakal-garantipos/health.svg)

```
[![Health](https://phpackages.com/badges/sportakal-garantipos/health.svg)](https://phpackages.com/packages/sportakal-garantipos)
```

###  Alternatives

[mabiola/paystack-php-lib

A PHP Library for https://paystack.co

262.0k](/packages/mabiola-paystack-php-lib)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)