Kontör yükleme
Kontör havuzunuzdan bir alt hesabın e-Faturam firmasına kontör yüklemek için bu endpoint kullanılı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
POST /api/sub-accounts/{id}/credit
Accept: application/json
Authorization: Bearer ANA_HESAP_API_KEY
Content-Type: application/json
{id} kontörün yükleneceği hesaptır:
- Ana hesabınıza bağlı bir alt hesabın
iddeğeri, ya da - Ana hesabın kendi e-Faturam firması varsa ana hesabın
iddeğeri.
Başka bir değer için 404 döner. Hedef hesabın e-Faturam firması onaylanmış olmalıdır; bunu alt hesap listesindeki tenant.is_active alanından kontrol edebilirsiniz.
İstek gövdesi
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
quantity | integer | Evet | Yüklenecek kontör adedi; en az 1, en fazla havuzdaki bakiye. |
Firmaya yüklenen kontör havuza geri alınamaz ve başka bir firmaya aktarılamaz. Adedi göndermeden önce doğrulayın.
Örnek istekler
- 💻 cURL
- 🐘 PHP
- 🟢 Node.js
- 🐍 Python
curl -X POST "https://app.faturaentegrator.com/api/sub-accounts/1234/credit" \
-H "Accept: application/json" \
-H "Authorization: Bearer ANA_HESAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"quantity": 50}'
<?php
$ch = curl_init('https://app.faturaentegrator.com/api/sub-accounts/1234/credit');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Accept: application/json',
'Authorization: Bearer ANA_HESAP_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['quantity' => 50]),
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
const res = await fetch('https://app.faturaentegrator.com/api/sub-accounts/1234/credit', {
method: 'POST',
headers: {
Accept: 'application/json',
Authorization: 'Bearer ANA_HESAP_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ quantity: 50 }),
});
const data = await res.json();
import requests
r = requests.post(
'https://app.faturaentegrator.com/api/sub-accounts/1234/credit',
headers={'Accept': 'application/json', 'Authorization': 'Bearer ANA_HESAP_API_KEY'},
json={'quantity': 50},
)
data = r.json()
Yanıt
200 ile havuzun güncel durumu credit_pool altında döner. Biçim kontör havuzu yanıtıyla aynıdır:
{
"credit_pool": {
"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." }
}
]
}
}
Firmanın güncel kontörü (tenant.credit_qty) yüklemeden kısa süre sonra alt hesap detayında görünür.
Hatalar
Aşağıdaki durumlarda 422 döner ve havuzdan kontör düşülmez. Mesaj quantity anahtarındadır:
{
"message": "Kontör havuzunuzda yeterli bakiye bulunmuyor.",
"errors": { "quantity": ["Kontör havuzunuzda yeterli bakiye bulunmuyor."] }
}
| Mesaj | Neden |
|---|---|
Hesabın aktif bir e-Faturam firması bulunmuyor. | Hedef hesabın e-Faturam başvurusu yok ya da henüz onaylanmadı. |
Kontör havuzunuzda yeterli bakiye bulunmuyor. | quantity, havuzdaki bakiyeden büyük. |
| e-Faturam servisinin hata mesajı | Yükleme e-Faturam tarafında reddedildi. Mesaj olduğu gibi iletilir; tekrar denemeden önce mesajı inceleyin. |