Giriş
Volet.com Merchant API, uygulamanızın kripto ödemeleri kabul etmesini, ödemeler ve transferler göndermesini, işlemleri takip etmesini ve bakiyeler, tarifeler ve limitler gibi hesap bilgilerini almasını sağlar.
Adım adım senaryolar için kılavuzlara bakın: Ödeme kabulü için API entegrasyonu ve Toplu ödemeler için API entegrasyonu.
Temel URL
https://api.volet.com
Tüm uç noktalar bu URL'ye göredir, örneğin https://api.volet.com/api/account/balances.
Başlamadan önce
- Doğrulanmış bir Volet.com hesabı (bireysel veya Business).
- Hesabınızın ödeme araçları bölümünde oluşturulmuş, entegrasyonunuzun ihtiyaç duyduğu izinlere sahip bir API. Bkz. Ödeme ağ geçidi oluşturma veya Toplu ödemeleri etkinleştirme.
- Sunucularınızın IP adresleri, API'nin IP beyaz listesinde.
Volet.com sandbox sunmaz. Entegrasyonunuzu küçük gerçek işlemlerle test edin.
Kimlik doğrulama
Her istek üç başlık içerir:
| Başlık | Değer |
|---|---|
Api-Name | Volet.com hesabınızdaki API'nin adı |
Account-Email | API'nin sahibi olan Volet.com hesabının e-posta adresi |
Authentication-Token | API parolanız ile UTC'deki geçerli tarih ve saatten oluşturulan bir SHA-256 belirteci |
Kimlik doğrulama belirtecini oluşturma
password:YYYYMMDD:HHdizesini oluşturun; buradapasswordAPI parolanızdır, tarih ve saat UTC'dedir.- Dizenin SHA-256 hash'ini hesaplayın.
- Hash'i onaltılık bir dize olarak
Authentication-Tokenbaşlığında gönderin. API büyük/küçük harf ayrımı yapmaz; genellikle küçük harf kullanılır.
Örneğin, 26 Ekim 2026'da 14:00 UTC'de MySecret123 parolası için:
SHA256("MySecret123:20261026:14")
şu sonucu verir:
c98e6521afe72b0945d9fdefdf3fd0b4dea10baa7f69325a7d6381c15f2421fd
Token her UTC saatinde değişir. Her istekten hemen önce oluşturun. API önceki ve sonraki saatin token'larını da kabul eder; bu nedenle saat değişimi sırasında veya saati biraz kaymış bir sunucudan gönderilen istek reddedilmez.
Her yöntemin Try it panelinde API parolanızı girip belirteci tarayıcınızda oluşturabilirsiniz. Parola hiçbir yere gönderilmez.
API'ye parola değil, yalnızca belirteç gönderilir. API parolasını ve belirteçleri ön yüz koduna, mobil uygulamalara, botlara veya diğer istemci tarafı betiklere koymayın.
İstek biçimi
- İstekler ve yanıtlar HTTPS üzerinden JSON kullanır. İstek gövdesiyle birlikte
Content-Type: application/jsongönderin. - Tutarlar ondalık sayılardır, örneğin
"amount": 100. API bunları"amount": "100.00"gibi dize olarak da kabul eder. Ondalık basamak sayısı para birimine bağlıdır. - Stablecoin kodları, fonların blokzincir üzerinden gittiği yerlerde ağı içerir, örneğin
USDT_TRC20; cüzdan para birimleri ağ içermez, örneğinUSDT. Bkz. Para birimi kodları ve tutarlar.
Örnek istek:
curl https://api.volet.com/api/account/balances \
-H "Api-Name: my-api" \
-H "Authentication-Token: c98e6521afe72b0945d9fdefdf3fd0b4dea10baa7f69325a7d6381c15f2421fd"
İstek sınırı
Bireysel hesaplar ve doğrulamayı tamamlamamış kurumsal hesaplar için API, saat başına istek sayısını sınırlar. Sınır dolduğunda API, attemptsHaveEndedException hatasıyla HTTP 401 döndürür. Bekleyin ve isteği daha sonra gönderin. Doğrulanmış kurumsal hesaplarda bu saatlik sınır yoktur.
İlgili sayfalar
- Cüzdan bakiyelerini sorgulama — kimlik doğrulamayı kontrol etmek için basit bir ilk istek
- Ödeme kabulü için API entegrasyonu — kripto faturaları, durumlar ve bildirimler
- Toplu ödemeler için API entegrasyonu — ödemeleri doğrulama ve gönderme