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
- 💻 cURL
- 🐘 PHP
- 🟢 Node.js
- 🐍 Python
curl -X GET "https://app.faturaentegrator.com/api/credit-pool" \
-H "Accept: application/json" \
-H "Authorization: Bearer ANA_HESAP_API_KEY"
<?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);
const res = await fetch('https://app.faturaentegrator.com/api/credit-pool', {
headers: { Accept: 'application/json', Authorization: 'Bearer ANA_HESAP_API_KEY' },
});
const data = await res.json();
import requests
r = requests.get(
'https://app.faturaentegrator.com/api/credit-pool',
headers={'Accept': 'application/json', 'Authorization': 'Bearer ANA_HESAP_API_KEY'},
)
data = r.json()
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
}
]
}
| Alan | Açıklama |
|---|---|
balance | Havuzda dağıtılmayı bekleyen kontör adedi. Havuz henüz hiç kullanılmadıysa 0 ve histories boş döner. |
histories | En yeniden eskiye son 20 hareket. |
histories alanları
| Alan | Açıklama |
|---|---|
type | purchase: havuza eklenen satın alma. distribute: havuzdan bir hesaba yapılan yükleme. |
quantity | Hareketteki kontör adedi. purchase havuzu artırır, distribute azaltır. |
balance | Hareketten sonra havuzda kalan kontör. |
sub_account_id, sub_account | distribute hareketinde kontörün yüklendiği hesap; ana hesabın kendisine yüklendiyse ana hesap görünür. purchase hareketinde null. |
note | Satın almaya eklenen not; yüklemelerde null. |
created_at | Hareket zamanı (ISO 8601). |