tcgunel / omnipay-vakifbank

v3.2.1 2026-10-16 07:32 UTC

Requires

• php: ^8.3
• ext-dom: *
• ext-json: *
• ext-simplexml: *
• league/omnipay: ^3

Requires (Dev)

• brianium/paratest: *
• fzaninotto/faker: *
• http-interop/http-factory-guzzle: ^1.2
• laravel/pint: ^1.0
• omnipay/tests: ^4
• phpstan/phpstan: ^1.0
• phpunit/phpunit: ^9

MIT

• Tolga Can Günel
• Omnipay Contributors

• purchase
• 3d
• enrollment
• vakifbank
• 3d ödeme

Published on Packagist.org on 2026-10-16 07:33 UTC

README

Omnipay Vakifbank Gateway

Omnipay gateway for Vakifbank: 3D enrollment, sale and transaction inquiry on the classic VPOS v3 service, İptal (cancel) and İade (refund), plus the Ortak Ödeme (3DPay) token register/query on the v2.1 API Gateway.

Requirements

PHP	Package
^7.4-^8.0	v1.0.0-v2.1.0
^8.3	v3.0.0+

Installation

composer require tcgunel/omnipay-vakifbank

Usage

Please see the Wiki page for detailed usage of every method.

İptal and İade are classic VPOS calls (/VposService/v3/Vposreq.aspx) addressed by the TransactionId of the original sale (ReferenceTransactionId):

// İptal (Cancel) — same day only, always the full amount.
$response = $gateway->void([
    'transactionReference' => $saleTransactionId,
    'client_ip' => $buyerIp, // optional, part of the official sample messages
]);

// İade (Refund) — full or partial, also from the same day on.
$response = $gateway->refund([
    'transactionReference' => $saleTransactionId,
    'amount' => '55.00',
    'currency' => 'TRY',
    'client_ip' => $buyerIp, // optional, part of the official sample messages
]);

$response->isSuccessful();
$response->getMessage();

Methods

Payment Services

• enrollment($options)
• purchase($options)
• fetchTransaction($options)
• void($options)
• refund($options)
• commonPaymentRegister($options)
• commonPaymentQuery($options)

Tests

composer test

For windows:

vendor\bin\paratest.bat

Treeware

This package is Treeware. If you use it in production, then we ask that you buy the world a tree to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.