Heleket

Gereken bilgiler

Heleket panelinde Business → Merchants altında mağazanızı oluşturun; alan adı doğrulaması ve moderasyon bittikten sonra mağazanın Settings sekmesinden:

• merchant_uuid: Merchant ID (UUID)
• api_key: Payment API key (Payout anahtarı değil; ikisi ayrıdır)

Panelinizde Ayarlar → Ödemeler → Yöntem ekle → Heleket seçip iki değeri girin.

Heleket'in test ortamı (sandbox) yoktur; istekler her zaman api.heleket.com'a gider. Test modu kutusunun bu yöntemde etkisi olmaz.

Webhook adresi

Panel her faturayı oluştururken kendi webhook adresini (url_callback) isteğe ekler; Heleket panelinde ayrıca bir ayar gerekmez:

https://<panel-alan-adınız>/payments/heleket/callback

Bu adres Heleket'in sunucusundan sunucunuza gelen bildirimdir, müşterinin tarayıcısı değildir. Her bildirimin içindeki sign alanı API anahtarınızla doğrulanır; imzası tutmayan istek reddedilir ve bakiye yüklenmez. Heleket bildirimleri 31.133.220.8 adresinden gönderir; isterseniz güvenlik duvarınızda yalnız bu adrese izin verebilirsiniz (panel IP kontrolü yapmaz, imza kontrolü yapar).

Akış

1. Müşteri tutarı girer, Heleket'i seçer.
2. Panel, panelinizin para biriminde (TRY, USD …) bir Heleket faturası açar; sipariş numarası olarak ödemenin referansı gönderilir.
3. Müşteri Heleket'in ödeme sayfasına yönlendirilir; coin ve ağı orada seçer, Heleket tutarı o coine çevirir.
4. Ödeme zincirde onaylanınca Heleket webhook gönderir; imza doğrulanır, bakiye fatura tutarıyla yüklenir. Fazla ödeme (paid_over) Heleket bakiyenizde kalır.
5. Müşteri "Bakiye yükle" sayfasına döner (başarılı / başarısız). Dönüş sayfası bakiye yüklemez; yalnız webhook yükler.

Fatura 1 saat açık kalır. Müşteri ilk seferde eksik gönderirse kalanı aynı faturaya gönderebilir (is_payment_multiple); %1'e kadar eksik ödeme tam sayılır (accuracy_payment_percent).

Aynı bildirim ikinci kez gelirse (Heleket'in "resend" özelliği) yok sayılır; bakiye iki kez yüklenmez.

Durumlar

Heleket durumu	Panelde
paid, paid_over	tamamlandı, bakiye yüklendi
wrong_amount	eksik ödeme, bakiye yüklenmez; Admin → Ödemeler'den görülür
cancel, fail, system_fail	başarısız (nedeni ödeme notunda)
locked	beklemede. Heleket AML incelemesi, fonlar kilitli
check, process, confirm_check, wrong_amount_waiting, refund_*	beklemede

Eksik ödemede gönderilen miktar coin cinsindendir; fatura para birimine ancak fatura USD ise (payment_amount_usd) ya da fatura zaten o coin ise çevrilebilir. Diğer durumlarda gönderilen coin miktarı ödeme notuna yazılır.

Para birimleri

Fatura para birimi panelinizin para birimidir. Heleket dokümanı fatura para birimi olarak fiat (USD) ya da kripto kodu kabul eder; Heleket'in kur listesi TRY, EUR, RUB gibi diğer fiat birimlerini de içerir. Müşteri şu ağlarda öder: BTC, ETH, LTC, BCH, DASH, DOGE, XMR, SOL, TRX, TON, BNB, AVAX, POL ve USDT / USDC / DAI (Ethereum, Tron, BSC, Polygon, Arbitrum, Avalanche, Solana, TON).

Heleket "The currency was not found" derse fatura o birimde açılamıyor demektir; panel para biriminizi USD'ye çevirin ya da Heleket desteğine sorun.

Sık sorunlar

• "You are forbidden": mağaza moderasyonu bitmemiş ya da ödemeler kapalı; Heleket panelinden mağaza durumuna bakın.
• "Wallet not found": Heleket'te o coin için aktif bir mağaza cüzdanı yok; Heleket → Merchants → cüzdanları açın.
• "Minimum amount … USDT": tutar Heleket'in coin alt sınırının altında; daha yüksek tutar deneyin.
• Ödendi ama bakiye yok: Admin → Ödemeler'de kaydın durumuna bakın. pending ise zincir onayı bekleniyordur; underpaid ise eksik gönderilmiştir. Kayıt hiç güncellenmediyse api_key yanlıştır (imza tutmadığı için bildirim reddedilir). Heleket'in "Testing webhook" ucuyla panel adresinize deneme bildirimi gönderebilirsiniz.