API v2.0Production

Columbia Pay

Müşteri API Dokümantasyonu

Base URL: https://columbiamoneypay.com

Son Güncelleme: 25 Mart 2026

Giriş

Columbia Pay API'ı müşterilerin para yatırma, çekme ve işlem durumlarını sorgulama işlemlerini gerçekleştirmelerine olanak sağlar.

Size Verilen Bilgiler

Terminal ID: Müşteri tanımlayıcısı (örn: demobahis)
API Key: İşlemleri imzalamak için kullanılan anahtarınız (pk_live_...)
Secret Key: Hash hesaplaması için gizli anahtarınız (sk_live_...)
Kimlik Doğrulama
Hash hesaplama ve güvenlik

Hash Nedir?

Hash, işleminizin güvenli olduğunu ispatlamak için kullanılan şifreli bir anahtar görevini görür. Hash sayesinde işleminiz güvenli aktarılır, kimse sizin yerinize işlem yapamaz ve sistem işlemin gerçek olduğunu doğrulayabilir.

Hash Hesaplama Kuralları

Hash Formülleri Özeti

Çekim: apiKey + islemid + tuser + tadsoyad + amount + secretKey
Durum (POST): apiKey + islemid + secretKey
API Endpoints
Mevcut işlemler ve kullanımları
GET/deposit/{ terminalid }

Yatırım

Müşteri yatırım talebini başlatmak için bu URL'ye yönlendirilir.

URL Parametreleri
ParameterTipZorunluAçıklama
terminalidString✓Terminal ID (örn: demobahis)
amountString✓Yatırım tutarı TRY
payment_nameString✓Ödeme yöntemi
Desteklenen Ödeme Yöntemleri

Banka Yöntemleri

  • • papara
  • • paycell
  • • hepsipay
  • • param
  • • paribu
  • • havale
  • • vip-havale

Kripto Yöntemleri

  • • bitcoin
  • • tether-trc20
  • • tether-erc20
  • • tron
  • • solana
Örnek URL
https://columbiamoneypay.com/deposit/demobahis?amount=500.00&payment_name=havale
POST/api/withdraw

Çekim

Müşteri çekim talebini API aracılığıyla kaydeder.

Request Parametreleri
ParameterZorunluFormatAçıklama
terminalid✓-Terminal ID
tuser✓-Kullanıcı adı
tadsoyad✓-Ad Soyad
amount✓"500.00"Çekim tutarı
islemid✓"CKM..."Benzersiz çekim ID
payment_name✓-Ödeme yöntemi
cekim_iban✓-Paranın aktarılacağı IBAN
hash✓64 charSHA256 hash
Hash Hesaplama Örneği

Adım 1: Parametreleri yazın

API Key: pk_live_abc123
İşlem ID: CKM20260325001
Kullanıcı: user123
Ad Soyad: Ahmet Yılmaz
Tutar: 500.00
Secret Key: sk_live_xyz789

Adım 2: Birleştirin (boşluk yok)

pk_live_abc123CKM20260325001user123Ahmet Yılmaz500.00sk_live_xyz789

Adım 3: SHA256 ile şifreleyin

d4f2c3a1b5e7f9d2a4c6e8f0b2d4a6c8e0f2b4d6a8c0e2f4b6d8a0c2e4f6b

GET/api/transaction/status/{ terminalid }/{ islemid }

Durum Sorgulama

İşlemin durumunu hash olmadan sorgulamak için basit bir GET isteği yapabilirsiniz.

Olası Status Değerleri
StatusAçıklama
pendingİşlem bekleme durumundadır
completedİşlem başarıyla tamamlandı
canceledİşlem iptal edildi
failedİşlem başarısız oldu
POST/api/status-check

Güvenli Durum Sorgulama

İşlem durumunu hash ile güvenli şekilde sorgulamak için POST yöntemi kullanın.

Hash Hesaplama (Durum Sorgulaması)

SHA256(apiKey + islemid + secretKey)

Hata Yönetimi
HTTP Status Kodları
KodAnlamıAçıklama
200OKİşlem başarılı
201CreatedYeni kayıt oluşturuldu
400Bad RequestEksik veya yanlış parametreler
401UnauthorizedYetkisiz (hash hatası)
404Not Foundİşlem bulunamadı
409ConflictDuplicate işlem ID
500Server ErrorSunucu hatası
Kod Örnekleri
Farklı programlama dillerinde uygulama örnekleri

Çekim İşlemi

const crypto = require('crypto');
const fetch = require('node-fetch');

const apiKey = 'pk_live_abc123';
const secretKey = 'sk_live_xyz789';

const hashString = apiKey + islemid + tuser + tadsoyad + amount + secretKey;
const hash = crypto.createHash('sha256').update(hashString).digest('hex');

const response = await fetch('https://columbiamoneypay.com/api/withdraw', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    terminalid, tuser, tadsoyad, amount, islemid, 
    payment_name, cekim_iban, hash
  })
});
Önemli Notlar

⚠️ Güvenlik

  • • Secret Key'i asla paylaşmayın - müşteri tarafında kalmalıdır
  • • Hash sırasını mutlaka kontrol edin - yanlış sıra hash'i geçersiz yapar
  • • HTTPS kullanın - API çağrılarını her zaman güvenli bağlantı üzerinden yapın
  • • API Key'ler değişebilir - kimlik sızıntısı şüphelenirseniz bizimle iletişime geçin

📌 İşlem ID (islemid)

  • • Benzersiz: Aynı ID iki kez gönderilemez
  • • Kontrollü: Sistem duplicate işlemleri reddeder (HTTP 409)
  • • Format: Önerilen format TRX20260325001 (Harfler + Tarih + Sıra)

💰 Amount Format

  • • Ondalık kullanılmalı: "500.00" (Tamam) vs "500" (Sorunlu)
  • • String olmalı: "100.00" (Tamam) vs 100 (Sorunlu)

🔄 CORS

Tüm API endpoint'leri CORS etkindir - GET, POST, OPTIONS yöntemleri desteklenir.

Columbia Pay API v2.0 • Son güncelleme: 25 Mart 2026

Sorularınız için:Teams