Volet

Gereken bilgiler

Volet panelinde Payment Tools → Hosted Checkout → Create ile bir Hosted Checkout (eski adıyla SCI) oluşturun. Panelinize girilecek üç değer:

• Hesap e-postası (merchant_id): Volet hesabınızın e-posta adresi.
• SCI adı (merchant_key): Hosted Checkout'a verdiğiniz ad ("Hosted Checkout name"; en fazla 50 karakter).
• SCI şifresi (secret_key): "Hosted Checkout password", istekleri imzalayan ve bildirimleri doğrulayan gizli anahtar.

Hosted Checkout ayarlarında "Use a digital signature in Hosted Checkout requests" açık olmalıdır; panel her isteği imzalar ve imzasız bildirimi reddeder.

Panelinizde Ayarlar → Ödemeler → Yöntem ekle → Volet seçin, üç değeri girin. Yeni oluşturulan Hosted Checkout, Volet tarafında onaylanana kadar (genellikle birkaç saat) canlı ödeme almaz.

Volet'in bir test/sandbox ortamı yoktur; canlı hesapla küçük tutarlı bir deneme ödemesi yapın.

Callback adresleri

Panel, her ödeme isteğine kendi adreslerini ekler (ac_status_url, ac_success_url, ac_fail_url); Volet panelinde ayrıca URL girmek gerekmez. Yine de Hosted Checkout ayarlarındaki Status URL alanına şu adresi yazabilirsiniz:

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

Durum bildirimi POST ile gönderilir; müşteri dönüşleri GET'tir. Volet her URL parametresini 100 karakterle sınırlar; çok uzun bir panel alan adında dönüş adresinden ödeme referansı düşürülür (bakiye yüklemesi bundan etkilenmez, çünkü dönüş adresi bakiye yüklemez).

Sunucunuzda IP kısıtlaması varsa Volet'in bildirim sunucularına izin verin: 50.7.115.5, 51.255.40.139, 13.53.55.89. Panel doğrulamayı IP'ye göre değil, imzaya göre yapar.

Akış

1. Müşteri tutarı girer ve Volet'i seçer.
2. Tarayıcısı, imzalı bir formla (ac_sign = SHA-256) https://account.volet.com/sci/ adresine gönderilir. Sipariş numarası (ac_order_id) bizim ödeme referansımızdır.
3. Müşteri Volet'in sayfasında ödeme yöntemini seçer: Volet hesap bakiyesi ya da kripto cüzdanı (USDT, USDC, BTC, ETH vb.).
4. Ödeme tamamlanınca Volet sunucudan sunucuya durum bildirimini panelin callback adresine POST eder. Panel ac_hash imzasını SCI şifresiyle doğrular; ac_transaction_status = COMPLETED ise ac_amount kadar bakiye yüklenir.
5. Müşteri "Continue" ile panelin "Bakiye yükle" sayfasına döner. Bu dönüş yalnız bir mesaj gösterir, bakiye yüklemez.

Aynı işlem numarası (ac_transfer) ve aynı durum için ikinci bildirim yok sayılır; bakiye iki kez yüklenmez.

Durumlar

Volet ac_transaction_status	Panelde
COMPLETED	Tamamlandı, bakiye yüklendi
PENDING, PROCESS	Beklemede (kripto onayı sürüyor)
CANCELED	Başarısız

Ödeme notuna Volet'in hesabınıza geçirdiği tutar ve para birimi (ac_merchant_amount, ac_merchant_currency) ile varsa alıcının e-postası yazılır.

Para birimleri

Volet ödeme isteğinde şu birimleri kabul eder: USD, EUR (fiat) ve USDT, USDC, BTC, ETH, XRP, TRX, LTC, TON, SOL. Panelinizin para birimi bunlardan biri olmalı; örneğin TRY panelde Volet ile ödeme başlatılamaz. Fiat ve stablecoin tutarları 2 basamakla, diğer kripto tutarları en fazla 8 basamakla gönderilir. Volet'in hesabınıza hangi birimde geçireceği ("settlement") Hosted Checkout ayarlarınıza bağlıdır.

Sık sorunlar

• Volet sayfası imza hatası veriyor: Hesap e-postası, SCI adı ya da şifre panele yanlış girilmiş. Üçü de Volet'teki Hosted Checkout'la birebir aynı olmalı (ad büyük/küçük harfe duyarlıdır).
• Ödeme başarılı ama bakiye yok: Volet bildirimi callback adresine ulaşmamış olabilir (alan adı henüz bize yönlenmedi, SSL yok, IP engeli) ya da SCI şifresi yanlış olduğu için bildirim reddedilmiştir. Admin → Ödemeler'de kayıt "beklemede" kalır; Volet panelinden işlemi doğrulayıp manuel tamamlayabilirsiniz.
• "Volet USD/EUR/… kabul eder" hatası: Panel para birimi Volet listesinde değil.
• Kripto ödeme uzun süre beklemede: Zincir onayı bekleniyor; Volet COMPLETED bildirimini gönderince otomatik tamamlanır. Eksik gönderim durumunda Volet'in "Accept underpayment" ayarı devrede değilse ödeme tamamlanmaz.