Faturalı ödeme

Faturalı ödeme ile önceden bakiye yüklemeden enerji, bant genişliği, etkinleştirme ve AML kontrolleri sipariş edebilirsiniz. Hizmetler, geçerli indirimler de dahil olmak üzere geçerli müşteriye özel tarife kullanılarak fiyatlandırılır. Ücretler, ödemeler ve düzeltmeler, sözleşmenizin faturalandırma ve ödeme koşulları kapsamında faturanıza yansıtılır.

Faturalı ödeme, Netts tarafından kurumsal hesaplar için talep üzerine etkinleştirilir. Bu bölümdeki uç noktalar yalnızca faturalı ödemeye sahip hesaplar için yanıt verir; diğer hesaplar 403 postpaid_required hatası alır.

Nasıl çalışır

1. Her zamanki gibi sipariş verirsiniz. Aynı sipariş uç noktaları, aynı API anahtarı. Faturalı bir hesabın bu siparişler için bir bakiye tutmasına gerek yoktur. Fiyat, indirimleriniz dahil olmak üzere sözleşmeniz kapsamındaki fiyattır.
2. Sağlanan hizmetler ücret olarak kaydedilir. Kabul edilen bir sipariş, tek başına sağlanmış bir hizmet anlamına gelmez. Bir ücret, hizmet veya siparişin ayrı olarak ücretlendirilebilir bir kısmı sağlandıktan sonra kullanım bölümünde görünür — bu, sipariş yanıtından daha sonra olabilir.
3. Fiyat ve kur sabitlenir ve korunur. Geçerli bir fiyat teklifi, ilgili sipariş için sözleşmeniz kapsamındaki fiyatı sabitler. Bir fiyat teklifi olmadan, sipariş verildiğinde sözleşmeniz kapsamındaki fiyat geçerli olur ve sözleşmenizin para birimindeki tutar, hizmetin sağlandığı andaki kur üzerinden hesaplanır. Kaydedilen tutarlar; siz kullanımı okuduğunuzda, bir fatura aldığınızda veya bir ödeme yaptığınızda yeniden hesaplanmaz.
4. Faturanızı alır ve ödersiniz. Faturalandırma dönemi ve ödeme koşulları sözleşmenizde kararlaştırılanlardır. Bir fatura; dönemin hizmetlerini, uygulanan ödemeleri ve düzeltmeleri ve hâlâ ödenecek tutarı gösterir; bir ödeme hizmet kayıtlarını silmez. Bkz. faturalar ve ödemeler. Ödeme para birimi, ağ ve ödeme vadesi hesap içindeki settlement alanında gösterilir. Fazla yapılan bir ödeme hesabınızda alacak olarak kalır ve sonraki ücretler için kullanılır.

Tarife, fiyat teklifi ve kaydedilen döviz kuru

Bir fiyat teklifi (freezePrice), sözleşmeniz kapsamındaki fiyatı bir dakika boyunca sabitler. Siparişi o bir dakika içinde quoteId ve aynı parametrelerle verin; fiyat değişse veya hizmet daha sonra sağlansa bile teklif edilen fiyattan faturalandırılır. Fiyat teklifi isteğe bağlıdır; istek alanları için 1 saatlik enerji ve 5 dakikalık enerji sayfalarına bakın.

Bir fiyat teklifi olmadan, sözleşmenizin para birimindeki tutar, bir fiyata veya hesabınıza baktığınız andaki değil, hizmetin sağlandığı andaki kur üzerinden hesaplanır. Güncel kur — kurunuz ve hesap yanıtlarında gösterilen kur — yalnızca karşılaştırma amaçlıdır; gelecekteki bir siparişin kuruna dair bir taahhüt değildir.

AML kontrolleri ABD doları cinsinden fiyatlandırılır ve sözleşmenizin para biriminde kaydedilir; TRX eşdeğeri, kontrol tamamlandığı andaki kur üzerinden hesaplanır. Bir AML ücretini yuvarlanmış TRX tutarından yeniden hesaplamayın.

Tutarlar TRX cinsinden ve sözleşmenizin para biriminde gösterilir; limitleriniz sözleşmenizin para birimi üzerinden sayılır. usdPerTrx, TRX'in sözleşmenizin para birimine olan kurudur. settlement içinde gösterilen, sözleşmenizin para birimi ve ağında ödeme yaparsınız.

Bir siparişin birden fazla ücreti olabilir, örneğin enerji ve ayrı olarak ücretlendirilebilir bir etkinleştirme. Her ücretin kendi zamanı ve kuru vardır. Tutarlar altı ondalık basamağa, çift sayıya yuvarlama (half-even) yöntemiyle bir kez yuvarlanır; bir fiyat teklifi teklif edilen tutarlarını korur. Bir siparişi, toplamına güncel bir kur uygulayarak değil, ücretleri üzerinden mutabakat yaparak eşleştirin.

Tüm zamanlar UTC'dir. Tüm tutarlar ondalık dize (string) biçimindedir, örneğin "30000.000000" — bunları kayan noktalı sayı (float) olarak değil, ondalık (decimal) bir türle ayrıştırın.

Kredi limiti

Netts hesabınızın kredi limitini belirler: herhangi bir anda borçlanabileceğiniz azami tutar. hesap ve limitler bölümlerinde "origin": "netts" ile gösterilir. Bunu görebilirsiniz ancak değiştiremez veya kapatamazsınız — farklı bir limite ihtiyacınız varsa Netts yöneticinizle görüşün.

Ürünler ve API anahtarları bu tek hesap düzeyindeki kredi limitini paylaşır. Her yeni sipariş, geçerli olan her limite göre kontrol edilir. Bu kontrol yetersiz kullanılabilir kredi tespit ettiğinde, sipariş yürütülmeden önce reddedilir:

{
  "detail": {
    "code": 1004,
    "msg": "Postpaid credit limit reached.",
    "paymentMode": "postpaid",
    "reason": "limit_reached",
    "product": "*",
    "period": "outstanding",
    "limitId": 1
  }
}

Sipariş uç noktası 402 yanıtını verir. Yapılan bir ödeme limiti tekrar serbest bırakır. Kontrol geçici olarak kullanılamıyorsa, sipariş uç noktası 5036 koduyla 503 yanıtını verir — daha sonra tekrar deneyin, reddedilen deneme nedeniyle hiçbir ücret alınmamıştır. Bir okuma isteği tarafından gösterilen kullanılabilir tutar anlık rakamdır, daha sonraki bir sipariş için yapılan bir rezervasyon değildir; kabul edilen diğer siparişler bunu değiştirebilir.

Kendi limitleriniz

Netts limitinin dahilinde, harcamaları kontrol altında tutmak veya belirli ürünleri kısıtlamak için kendi daha düşük limitlerinizi belirleyebilirsiniz:

• Kendi genel limitiniz — Netts limitinin altında, borçlanmanıza izin verdiğiniz toplam tutar.
• Bir ürün limiti — bir ürünün ne kadar kullanabileceği, örneğin energy_5m.

Limitleriniz asla kredi eklemez. Ürün limitleri toplanmaz: 50 USD Netts limiti ile, energy_1h için 50 USD ve energy_5m için 50 USD ürün limitleri yine de hesap düzeyindeki 50 USD krediyi paylaşır. Sipariş kontrolü ilgili her limiti uygular ve limitler her ürün için şu anda ne kadar harcama yapılabileceğini gösterir.

Bir limit şunları sayabilir:

period	Neler sayılır
outstanding	ödenmemiş ücretler, artı henüz kaydedilmemiş kabul edilen siparişler
day	geçerli UTC gününün ücretleri, ödenmiş olanlar dahil, artı henüz kaydedilmemiş kabul edilen siparişler
week	Pazartesi 00:00 UTC'den itibaren geçerli UTC haftasının ücretleri, ödenmiş olanlar dahil, artı henüz kaydedilmemiş kabul edilen siparişler
order	tek bir yeni siparişin tutarı

Bir ödeme borcunuzu azaltır ancak günün veya haftanın kullanımını sıfırlamaz. Fazla ödemeden kaynaklanan kredi creditApplied olarak gösterilir ve genel borcunuza karşı bir kez sayılır; her bir ürün limitine ayrı ayrı eklenmez.

Limitleriniz Netts limitinin para birimindedir ve bundan daha yüksek olamaz. Netts limitini sizinkilerden birinin altına düşürürse, geçerli olan daha düşük kısıtlama yürürlükte kalır.

Ürünler: energy_1h, energy_5m, bandwidth, activation, aml_check.

API anahtarı izinleri

Her API anahtarının bu bölüm için bir izne ihtiyacı vardır. Netts yöneticiniz bunu anahtar başına tanımlar:

İzin	İzin verilen işlem
billing.read	hesap, kur, limitler, kullanım, faturalar ve ödemeler
limits.write	kendi limitlerinizi oluşturma, değiştirme, kapatma ve açma

İzin olmadığında uç nokta billing_read_required veya forbidden ile 403 yanıtını verir. Anahtarın IP beyaz listesi diğer tüm uç noktalarda olduğu gibi geçerlidir. Bu uç noktalar, bakiye sıfır olduğunda da kullanılabilir kalır.

Uç Noktalar

Uç Nokta	Ne yapar
GET /apiv2/billing/account	kredi limiti, borç ve şu anda kullanılabilir olan tutar
GET /apiv2/billing/rate	TRX'in sözleşmenizin para birimine karşı güncel kurunuz
GET /apiv2/billing/limits	kullanılan ve kullanılabilir tutarlarla birlikte tüm limitler, ürün başına kullanılabilir tutar
POST /apiv2/billing/limits	kendi limitlerinizi oluşturma, değiştirme, kapatma ve açma
GET /apiv2/billing/usage	siparişleriyle bağlantılı ücret bileşenleri
GET /apiv2/billing/invoices	faturalar, ücretleriyle birlikte tek bir fatura
GET /apiv2/billing/payments	ödemeler ve alacak

Yanıt biçimi

{ "success": true, "data": { }, "timestamp": "2026-10-19T20:12:30+00:00" }

Hizmetten dönen bir hata:

{
  "success": false,
  "error": { "code": "postpaid_required", "message": "this account has no postpaid billing" },
  "timestamp": "2026-10-19T20:12:30+00:00"
}

Eksik veya geçersiz bir anahtar ya da anahtarın beyaz listesi dışındaki bir IP'den gelen bir istek, hizmete ulaşmadan önce API ağ geçidi tarafından 401 ile reddedilir:

{ "detail": { "code": -1, "msg": "Invalid or missing API key" } }

"Invalid API key or IP not in whitelist" mesajını içeren -2 kodu, IP'nin anahtarın beyaz listesinde olmadığı anlamına gelir. Tek bir IP'den saniyede 10'dan fazla veya dakikada 300'den fazla istek 429 ve {"message": "API rate limit exceeded"} ile reddedilir.

HTTP	code	Anlamı
400	invalid_request, invalid_amount, idempotency_key_required, invalid_idempotency_key	bir parametre eksik veya hatalı biçimde
403	postpaid_required	hesabın faturalı ödemesi yok
403	postpaid_disabled	faturalı ödeme duraklatıldı: okuma yapabilirsiniz ancak limitleri değiştiremezsiniz
403	billing_read_required, forbidden	anahtarda billing.read veya limits.write izni eksik
403	netts_limit_readonly	limit Netts tarafından belirlenmiştir ve değiştirilemez
404	not_found	hesabınızda böyle bir limit veya fatura yok
409	revision_conflict	limit bu sırada değiştirildi — tekrar okuyun
409	limit_exists	bu ürün ve dönem için zaten bir limitiniz var
409	idempotency_conflict	Idempotency-Key başka bir istekle kullanıldı
409	no_account_limit	hesap için henüz Netts tarafından belirlenmiş bir kredi limiti yok
422	above_account_limit	değer Netts limitinden daha yüksek
422	product_not_postpaid	ürün faturalı ödemede kullanılamaz
422	unit_mismatch	Netts limitinin para birimi değişti — limitinizi açmadan önce yeni bir değer belirleyin
503	unavailable	geçici olarak kullanılamıyor — daha sonra tekrar deneyin
503	rate_unavailable	kurunuz geçici olarak kullanılamıyor — daha sonra tekrar deneyin