Ana içeriğe geç

Kontör havuzu

Kontör havuzunuzun bakiyesini ve son hareketlerini almak için bu endpoint kullanılır.

Geliştirici paketinde satın aldığınız e-Faturam kontörleri doğrudan bir firmaya değil, ana hesabınızın kontör havuzuna eklenir. Havuzdaki kontörü daha sonra kontör yükleme ucuyla alt hesaplarınızın e-Faturam firmalarına dağıtırsınız. Her e-Faturam işlemi (gelen veya giden) firmadan 1 kontör düşer.

Havuza kontör eklemek için Fatura Entegratör ekibiyle iletişime geçin (destek@faturaentegrator.com). Satın alma, havuza ekip tarafından işlenir ve hareketlerde purchase olarak görünür.

Bu uç yalnızca Geliştirici paketindeki ana hesabın anahtarıyla çağrılır; alt hesabın anahtarıyla 403 döner.

İstek​

GET /api/credit-pool
Accept: application/json
Authorization: Bearer ANA_HESAP_API_KEY

Örnek istekler​

<?php
$ch = curl_init('https://app.faturaentegrator.com/api/credit-pool');
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => ['Accept: application/json', 'Authorization: Bearer ANA_HESAP_API_KEY'],
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Yanıt​

{
"balance": 350,
"histories": [
{
"id": 12,
"credit_pool_id": 3,
"sub_account_id": 1234,
"type": "distribute",
"quantity": 50,
"balance": 350,
"note": null,
"created_at": "2026-11-06T10:15:00.000000Z",
"sub_account": { "id": 1234, "name": "Örnek Ticaret Ltd. Şti." }
},
{
"id": 11,
"credit_pool_id": 3,
"sub_account_id": null,
"type": "purchase",
"quantity": 400,
"balance": 400,
"note": "Kasım satışı",
"created_at": "2026-11-06T09:00:00.000000Z",
"sub_account": null
}
]
}
AlanAçıklama
balanceHavuzda dağıtılmayı bekleyen kontör adedi. Havuz henüz hiç kullanılmadıysa 0 ve histories boş döner.
historiesEn yeniden eskiye son 20 hareket.

histories alanları​

AlanAçıklama
typepurchase: havuza eklenen satın alma. distribute: havuzdan bir hesaba yapılan yükleme.
quantityHareketteki kontör adedi. purchase havuzu artırır, distribute azaltır.
balanceHareketten sonra havuzda kalan kontör.
sub_account_id, sub_accountdistribute hareketinde kontörün yüklendiği hesap; ana hesabın kendisine yüklendiyse ana hesap görünür. purchase hareketinde null.
noteSatın almaya eklenen not; yüklemelerde null.
created_atHareket zamanı (ISO 8601).