README

Tiko Sanal POS API (v1.0.8) için Laravel paketi. 3D / 3D’siz ödeme, durum sorgu, iptal, bin sorgu ve callback doğrulama yardımcılarını içerir.

Gereksinimler

• PHP 8.1+
• Laravel 9/10/11/12

Kurulum (Packagist yayını sonrası)

composer require gokhansahin/tiko-laravel
php artisan vendor:publish --provider="Tiko\\TikoServiceProvider" --tag=tiko-config

.env örneği:

TIKO_MERCHANT_ID=xxxxx
TIKO_API_KEY=your-secret
TIKO_PASSWORD=your-password
TIKO_SANDBOX=true
TIKO_TIMEOUT=15

Kullanım

use Illuminate\Support\Str;
use Tiko\Facades\Tiko;

$response = Tiko::pay3d([
    'OrderId' => (string) Str::uuid(),
    'Amount' => 10.00,
    'Currency' => 'TRY',
    'Installment' => 0,
    'UrlOk' => 'https://site.com/tiko/ok',
    'UrlFail' => 'https://site.com/tiko/fail',
    'CardName' => 'Ad Soyad',
    'CardNo' => '4109104545898068',
    'CardCvv' => '001',
    'CardExpireMonth' => '01',
    'CardExpireYear' => '29',
    'UserIp' => request()->ip(),
    'UserName' => 'Ad Soyad',
    'UserEmail' => 'mail@site.com',
]);

Diğer yardımcılar:

• Tiko::pay([...]) — 3D’siz ödeme
• Tiko::status($orderId)
• Tiko::cancel($orderId)
• Tiko::binQuery($bin)
• Tiko::verifyCallback($payload) — callback veya sonuç hash doğrulama

Callback endpoint’inizde gelen JSON’u verifyCallback ile doğrulayın; doğrulama başarılıysa HTTP 200 yanıtı verin.