Ana içeriğe geç

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 id değeri, ya da
  • Ana hesabın kendi e-Faturam firması varsa ana hesabın id değ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​

AlanTipZorunluAçıklama
quantityintegerEvetYüklenecek kontör adedi; en az 1, en fazla havuzdaki bakiye.
Yükleme geri alınamaz

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​

<?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);

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."] }
}
MesajNeden
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.