8000 GitHub - yasinkuyu/omnipay-paycell-sdk · GitHub
[go: up one dir, main page]

Skip to content

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

49 Commits

Folders and files

Repository files navigation

Omnipay: Paycell SDK

Turkcell Paycell SDK gateway for Omnipay payment processing library

Omnipay is a framework agnostic, multi-gateway payment processing library for PHP 8.1.x. This package implements Turkcell Paycell SDK support for Omnipay.

Important Notes

  • Please review Paycell SDK Documentation before starting integration
  • Check "Service Access and General Information" section for critical integration points
  • This package uses RESTful JSON service examples
  • For integration support: paycelldev@paycell.com.tr

Installation

composer require league/omnipay yasinkuyu/omnipay-paycell-sdk

Required additional dependencies:

composer require php-http/curl-client guzzlehttp/psr7 php-http/message

Test Mode

To enable test mode, set the following in your initialization:

$gateway->setTestMode(true); // For test environment
$gateway->setTestMode(false); // For production environment

Test mode uses different endpoints and credentials:

Test Environment Credentials

  • Application name: PAYCELLTEST
  • Application password: PaycellTestPassword
  • Secure code: PAYCELL12345
  • Eulaid: 17
  • Merchant Code: 9998
  • Terminal Code: [Get from Paycell]

Basic Usage

  1. Navigate to example directory:
cd /YOUR-COMPOSER-PATH/vendor/yasinkuyu/omnipay-paycell-sdk/example
  1. Copy init.php.example to init.php

  2. Start test server:

php -S localhost:8000
  1. Open test page in browser: http://localhost:8000/purchase.php

Initialize Gateway

use Omnipay\Omnipay;

$gateway = Omnipay::create('PaycellSDK');
$gateway->setTestMode(true); // Enable test mode
$gateway->setApplicationName('PAYCELLTEST');
$gateway->setApplicationPwd('PaycellTestPassword');
$gateway->setSecureCode('PAYCELL12345');
$gateway->setEulaID(17);
$gateway->setMerchantCode(9998);
$gateway->setTerminalCode('XXXXXXXXX');

Process Purchase

$transactionDateTime = date('YmdHis') . substr(microtime(), 2, 3);

$gateway->setReferenceNumber($transactionDateTime);
$gateway->setHostAccount("customer@email.com");
$gateway->setPaymentSecurity("NON_THREED_SECURE"); // or "THREED_SECURE"
$gateway->setLanguage("tr");

$response = $gateway->purchase([
    'amount' => '10.00',
    'currency' => 'TRY',
])->send();

if ($response->isSuccessful()) {
    echo "Payment successful!";
    // Get tracking URL for redirect
    $trackingUrl = $response->getTrackingUrl();
}

Query Transaction Status

$response = $gateway->query([
    'originalPaymentReferenceNumber' => $paymentReferenceNumber,
])->send();

if ($response->isSuccessful()) {
    echo "Transaction status: " . $response->getMessage();
}

Process Refund

$response = $gateway->refund([
    'amount' => '10.00',
    'currency' => 'TRY',
    'originalPaymentReferenceNumber' => $paymentReferenceNumber,
])->send();

Process Reverse (Cancel)

$response = $gateway->reverse([
    'originalPaymentReferenceNumber' => $paymentReferenceNumber,
])->send();

Supported Methods

  • Purchase (Regular and 3D Secure)
  • Query Transaction Status
  • Refund
  • Reverse (Cancel)

Test Cards

For test credit cards, visit: https://paycell.com.tr/test-kredi-kartlari

System Requirements

  • PHP >= 8.1.0
  • Composer
  • PHP cURL extension

Support

Documentation

For detailed integration information and API documentation, please visit Paycell SDK Documentation.

License

The MIT License (MIT). Please see License File for more information.

Other Omnipay packages

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages

0