Ana içeriğe geç

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ıkDeğer
Api-NameVolet.com hesabınızdaki API'nin adı
Account-EmailAPI'nin sahibi olan Volet.com hesabının e-posta adresi
Authentication-TokenAPI parolanız ile UTC'deki geçerli tarih ve saatten oluşturulan bir SHA-256 belirteci

Kimlik doğrulama belirtecini oluşturma​

  1. password:YYYYMMDD:HH dizesini oluşturun; burada password API parolanızdır, tarih ve saat UTC'dedir.
  2. Dizenin SHA-256 hash'ini hesaplayın.
  3. Hash'i onaltılık bir dize olarak Authentication-Token baş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.

Parolayı sunucunuzda tutun

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/json gö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ğin USDT. Bkz. Para birimi kodları ve tutarlar.

Örnek istek:

curl https://api.volet.com/api/account/balances \
-H "Api-Name: my-api" \
-H "Account-Email: [email protected]" \
-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.