TrendXPAY API Dokümantasyonu

Genel Bakış

TrendXPAY Payment Gateway API, güvenli ödeme işlemleri için RESTful API yapısı sunar. JSON formatında veri alışverişi, SHA256 hash güvenliği ve gerçek zamanlı callback bildirimleri ile modern ödeme altyapısı.

API Özellikleri:

RESTful API yapısı (JSON)
SHA256 hash güvenliği
SSL/TLS şifreleme
Rate limiting koruması (50 istek / 5 dakika)
Gerçek zamanlı callback bildirimleri
Test ve production ortamları
Otomatik retry mekanizması
Detaylı hata mesajları

Base URL ve Versiyonlama

Production: https://pay.trendxgaming.com/api/services/
API Version: v1.0
Content-Type: application/json
Character Encoding: UTF-8
                            

İşlem Durumları

Durum	Açıklama	Callback
`pending`	İşlem bekleniyor	❌ Gönderilmez
`approved`	İşlem onaylandı	✅ Gönderilir
`rejected`	İşlem reddedildi	✅ Gönderilir
`cancelled`	İşlem iptal edildi	✅ Gönderilir

Desteklenen Ödeme Yöntemleri

Kod	Yöntem	Min. Tutar	Maks. Tutar
`havale`	Havale/EFT	₺50	₺50.000
`payco`	PayCo	₺50	₺10.000
`kredikarti`	Kredi Kartı	₺20	₺25.000
`papara`	Papara	₺20	₺15.000
`paratim`	Paratim	₺50	₺20.000
`pep`	Pep	₺50	₺10.000
`crypto`	Kripto Para	$10	$50.000

HTTP Status Codes

Kod	Durum	Açıklama
`200`	OK	İstek başarılı
`400`	Bad Request	Geçersiz istek formatı
`401`	Unauthorized	Geçersiz kimlik bilgileri
`403`	Forbidden	Erişim engellendi
`404`	Not Found	Kaynak bulunamadı
`429`	Too Many Requests	Rate limit aşıldı
`500`	Internal Server Error	Sunucu hatası

Kimlik Doğrulama

API erişimi için site anahtarı (site_key) gereklidir. Site anahtarınızı admin panelinden alabilirsiniz.

Önemli: Site anahtarınızı güvenli tutun ve asla client-side kodda kullanmayın. Tüm API isteklerini server-side'dan yapın.

Rate Limiting

API'de beş dakikalık süre içinde maksimum 50 istek yapabilirsiniz. Bu sınırı aşarsanız aşağıdaki hatayı alırsınız:

{
    "status": "error",
    "message": "Site kullanıcısı beş dakikalık sınıra ulaştı. Lütfen sonra deneyiniz."
}
                            

POST

Para Yatırma İşlemi

/api/services/deposit

Request Parametreleri

Parametre	Tip	Zorunlu	Açıklama
payment_method_id	string	Evet	Ödeme yöntemi kodu
amount	float	Evet	Yatırılacak tutar
user	string	Evet	Kullanıcının tam adı
user_name	string	Evet	Kullanıcı adı (username)
user_id	string	Evet	Benzersiz kullanıcı ID
site_key	string	Evet	Site anahtarı
site_reference_number	string	Evet	Benzersiz işlem referans numarası
return_url	string	Hayır	Dönüş URL'si

Örnek Request

{      
    "payment_method_id": "papara",      
    "amount": 100,      
    "user": "Ahmet Yılmaz",      
    "user_name": "ahmet123",      
    "user_id": "12345",      
    "site_key": "trendx_abc123def456",      
    "site_reference_number": "REF_001_20250730",      
    "return_url": "https://yoursite.com/success"   
}
                            

Başarılı Response

{
    "success": true,
    "status": "success",
    "message": "Deposit transaction created successfully",
    "token": "f98525ef44fa01826997d73c40bc13f8abc123def456789012345678",
    "transaction_id": "DEP_1738178400_A1B2C3D4",
    "transaction_status": "pending",
    "iframe_url": "https://pay.trendxgaming.com/payment.php?token=f98525ef44fa01826997d73c40bc13f8abc123def456789012345678",
    "iframe": {
        "link": "https://pay.trendxgaming.com/payment.php?token=f98525ef44fa01826997d73c40bc13f8abc123def456789012345678",
        "token": "f98525ef44fa01826997d73c40bc13f8abc123def456789012345678",
        "expires_at": "2025-07-30 14:15:00"
    },
    "amount": 100,
    "currency": "TRY",
    "payment_method": "papara",
    "site_reference_number": "REF_001_20250730"
}
                            

POST

Para Çekme İşlemi

/api/services/withdrawal

Para çekme işlemi için de aynı parametreler kullanılır. Sistem otomatik olarak işlemi para çekme olarak işler.

Örnek Request

{      
    "payment_method_id": "papara",      
    "amount": 500,      
    "user": "Mehmet Demir",      
    "user_name": "mehmet456",      
    "user_id": "67890",      
    "site_key": "trendx_abc123def456",      
    "site_reference_number": "REF_002_20250730"
}
                            

Başarılı Response

{
    "success": true,
    "status": "success",
    "message": "Withdrawal request created successfully",
    "token": "g12536af55gb02837998e84d41cd24g9abc123def456",
    "transaction_id": "WTH_1738178500_X9Y8Z7W6",
    "transaction_status": "pending",
    "amount": 500,
    "currency": "TRY",
    "payment_method": "papara",
    "site_reference_number": "REF_002_20250730"
}
                            

Callback Bildirimleri

İşlem durumu değişikliklerinde (onay, red) sistemimiz otomatik olarak belirlediğiniz callback URL'e POST isteği gönderir.

Callback Özellikleri:

POST metodu ile JSON formatında gönderilir
İşlem durumu değişikliklerinde tetiklenir (approved, rejected, cancelled)
SHA256 hash ile güvenlik sağlanır
Callback aldığınızda bakiye güncellemenizi yapın
Mutlaka {"message": "OK", "status": "true"} yanıtı verin
Yanıt vermezseniz sistem callback'i 3 kez tekrar gönderir

Para Yatırma Callback (Onaylı)

Admin onayladığında sitenize şu formatta callback gönderilir. Bu callback'i alınca kullanıcının bakiyesine amount kadar para ekleyin.

{
    "type": "deposit",
    "id": 4,
    "site_key": "trendx_abc123def456",
    "user": "Ahmet Yılmaz",
    "user_id": "12345",
    "user_name": "ahmet123",
    "amount": "100.00",
    "site_reference_number": "REF_001_20250730",
    "status": "approved",
    "data": "2025-07-30 14:33:05",
    "token": "f98525ef44fa01826997d73c40bc13f8",
    "method": "papara",
    "hashcode": "862ca3e3701585cabf37ac0da147eec2"
}
                            

Para Çekme Callback (Onaylı)

Admin onayladığında sitenize şu formatta callback gönderilir. Bu callback'i alınca kullanıcının bakiyesinden amount kadar para çıkarın.

{
    "type": "withdrawal",
    "id": 8,
    "site_key": "trendx_abc123def456",
    "user": "Mehmet Demir",
    "user_id": "67890",
    "user_name": "mehmet456",
    "amount": "500.00",
    "site_reference_number": "REF_002_20250730",
    "status": "approved",
    "data": "2025-07-30 15:45:12",
    "token": "g12536af55gb02837998e84d41cd24g9",
    "method": "papara",
    "hashcode": "a73bd4f8912ace56789def01234567890"
}
                            

Beklenen Response

Önemli: Callback aldığınızda mutlaka aşağıdaki formatta yanıt verin, aksi takdirde sistem callback'i tekrar gönderir.

{ 
    "message": "OK", 
    "status": "true" 
}
                            

Hash Doğrulama

Callback güvenliği için gelen isteklerin hashcode değerini mutlaka doğrulayın.

Hash Formülü:
hash('sha256', $site_reference_number . $token . $site_key)

PHP Hash Doğrulama Örneği

<?php
function verifyTrendXHash($site_reference_number, $token, $site_key, $received_hash) {
    $expected_hash = hash('sha256', $site_reference_number . $token . $site_key);
    return hash_equals($expected_hash, $received_hash);
}

// Kullanım örneği
$is_valid = verifyTrendXHash(
    'REF_001_20250730',
    'f98525ef44fa01826997d73c40bc13f8',
    'trendx_abc123def456',
    '862ca3e3701585cabf37ac0da147eec2'
);

if ($is_valid) {
    echo "Hash doğrulandı - güvenli işlem";
} else {
    echo "Hash doğrulanamadı - güvensiz istek";
}
?>
                            

PHP Entegrasyon Örnekleri

TrendX Client Class

<?php
class TrendXPaymentClient {
    private $api_url = 'https://pay.trendxgaming.com';
    private $site_key;
    
    public function __construct($site_key) {
        $this->site_key = $site_key;
    }
    
    public function createDeposit($data) {
        $url = $this->api_url . '/api/services/deposit';
        
        $payload = [
            'payment_method_id' => $data['payment_method_id'],
            'amount' => $data['amount'],
            'user' => $data['user'],
            'user_name' => $data['user_name'],
            'user_id' => $data['user_id'],
            'site_key' => $this->site_key,
            'site_reference_number' => $data['site_reference_number'],
            'return_url' => $data['return_url'] ?? ''
        ];
        
        return $this->makeRequest($url, $payload);
    }
    
    private function makeRequest($url, $payload) {
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Content-Type: application/json'
        ]);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        
        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        
        return [
            'http_code' => $httpCode,
            'response' => json_decode($response, true)
        ];
    }
}

// Kullanım
$client = new TrendXPaymentClient('your_site_key_here');
$result = $client->createDeposit([
    'payment_method_id' => 'papara',
    'amount' => 100,
    'user' => 'Ahmet Yılmaz',
    'user_name' => 'ahmet123',
    'user_id' => '12345',
    'site_reference_number' => 'REF_' . time(),
    'return_url' => 'https://yoursite.com/success'
]);
?>
                            

Hata Kodları

Hata Mesajı	Açıklama	Çözüm
`GET yöntemi desteklenmiyor`	Yanlış HTTP metodu	POST metodu kullanın
`Site anahtarı bulunamadı`	Geçersiz site_key	Doğru site anahtarını kontrol edin
`Site şu anda aktif değil`	Hesap devre dışı	Destek ekibiyle iletişime geçin
`Ödeme yöntemi bulunamadı`	Geçersiz payment_method_id	Desteklenen ödeme yöntemlerini kontrol edin
`Site kullanıcısı beş dakikalık sınıra ulaştı`	Rate limit aşıldı	5 dakika bekleyin

Entegrasyon Başvurusu

TrendXPAY sistemine entegrasyon için aşağıdaki formu doldurun. Başvurunuz 24 saat içinde değerlendirilecek ve size API anahtarlarınız gönderilecektir.

Başvuru Süreci:
1. Formu doldurun
2. Ekibimiz başvurunuzu inceler
3. Onay sonrası API anahtarları gönderilir
4. Test ortamında entegrasyonu tamamlayın
5. Canlıya geçiş için ekibimizle iletişime geçin

Site Adresi *

İsim Soyisim *

E-posta / Telefon *

Telegram Kullanıcı Adı *

Aylık Ortalama İşlem Hacmi *

Ek Notlar (Opsiyonel)

* ile işaretli alanlar zorunludur. Başvurunuz gönderildikten sonra 24 saat içinde size dönüş yapılacaktır.

TrendXPAY API Dokümantasyonu

Neden TrendXPAY API?

Hızlı Entegrasyon

Maksimum Güvenlik

Yüksek Performans

7/24 API Desteği

Genel Bakış

Base URL ve Versiyonlama

İşlem Durumları

Desteklenen Ödeme Yöntemleri

HTTP Status Codes

Kimlik Doğrulama

Rate Limiting

Para Yatırma İşlemi

Request Parametreleri

Örnek Request

Başarılı Response

Para Çekme İşlemi

Örnek Request

Başarılı Response

Callback Bildirimleri

Para Yatırma Callback (Onaylı)

Para Çekme Callback (Onaylı)

Beklenen Response

Hash Doğrulama

PHP Hash Doğrulama Örneği

PHP Entegrasyon Örnekleri

TrendX Client Class

Hata Kodları

Entegrasyon Başvurusu