SSS

SSS

Redirect URI'ye ne yazmalıyım? Modül ayar sayfasında gri yazılı adres: https://<dolibarr>/custom/garantiapi/callback.php. Token isteğin yanıtında gelir; bankanın bu adrese bir şey göndermesi gerekmez, ama token isteğindeki redirect_uri portaldakiyle birebir aynı olmalıdır. Portala farklı bir adres yazdıysanız ayarlardaki Redirect URI alanına aynısını girin.

Scope ne olmalı? oob.

Bağlantı testi 401 invalid_client diyor. API Key/Secret yanlış ya da anahtar portalda hâlâ Pending approval. Portalda anahtarın durumunun Enabled olduğunu, Secret'ı doğru kopyaladığınızı kontrol edin; yeni secret ürettiyseniz ayara da girin.

reason 4 — clientId-consentId hatalı. Kurumsal İnternet'teki EHO başvurusunda girilen API Key, ayarlardaki API Key ile aynı olmalı. Yeni anahtar oluşturduysanız başvuruyu güncelleyin.

reason 6 — hesap bilgisi hatalı. Hesap EHO başvurusunda seçilmemiş ya da IBAN yanlış. Başvuruya hesabı ekleyin ya da hesabı pasif yapın.

Bazı hareketler gelmiyor. EHO başvurusunda tüm hareket tiplerinin seçili olduğunu kontrol edin. Geç düşen hareketler için Tekrar okuma payını artırın ya da tarih aralığıyla yeniden çekin (mükerrer oluşmaz).

Aynı hareket Dolibarr'da iki kez görünüyor. Hareket Dolibarr'a elle de girilmiş ve ayrıca ödeme olarak kaydedilmiş. Fazla kaydı Dolibarr'dan silin, hareketi Yeniden aç ile açıp elle girilen satıra Bağla. Kartta eşleşen satır varsa modül uyarır; otomatik ödeme, eşleşen satır varken hiç çalışmaz.

Banka ile Dolibarr bakiyesi farklı. Bekleyen/yoksayılan hareketler, bankaya düşmemiş elle girilmiş kayıtlar ya da açılış bakiyesi. Banka hesabı kartındaki Garanti BBVA sekmesi ve Banka → hesap özetleri ile karşılaştırın.

Döviz hesabı destekleniyor mu? Evet: hareketler, bakiyeler, bağlama ve çeşitli ödeme. Fatura ödemesi, faturanın para birimi banka hesabınınkiyle aynıysa yapılır.

Cari VKN ile bulunmuyor. VKN/TCKN carinin Prof ID 1 ya da Prof ID 2 alanında ya da KDV numarasında (TR önekiyle ya da öneksiz) olmalı; ya da karşı IBAN carinin banka bilgilerinde kayıtlı olmalı. Kartta cariyi elle seçebilirsiniz.

Birden çok şirket (multicompany)? Ayarlar ve tablolar entity bazındadır; her şirket kendi API anahtarı ve consent'i ile çalışır.

Sadece bazı API'lere izin aldım. Ayarlar → Servisler tablosunda yalnız izin aldıklarınızı açın. Kapalı servis hiçbir yerde görünmez ve bankaya çağrı yapmaz. Hangisine izniniz olduğunu servis sekmesindeki Erişim testi gösterir (401/403 = izin yok).

Toplu ödemede aynı kişi hem hazırlayıp hem onaylayabilir mi? Çift onay açıkken (varsayılan) hayır: doğrulayan kullanıcı onaylayamaz. Küçük ekipler ayarı kapatabilir; yetkiler (hazırla / onayla / gönder) yine ayrı verilebilir.

Gönderim sırasında bağlantı koptu, ödeme gitti mi? Belirsiz sonuçta satırlar gönderildi sayılır ve otomatik yeniden gönderilmez (çift ödeme olmasın diye). Durumu sorgula bankadaki gerçek durumu getirir.

Ödeme amacı / durum kodlarının anlamı ne? Bankanın yayımladığı tanımlarda yalnız örnek değerler var (0500 ödendi, 0700 tahsil edildi). Kodları ve anlamlarını bankadan alıp servis ayarlarına girin.

Ödeme İste imza anahtarı nereden? Servis ayarlarında Anahtar çifti üret ile oluşturup açık anahtarı bankaya iletin, ya da bankanın verdiği anahtarı yapıştırın.

Denetim günlüğünü kim görür? Denetim günlüğünü görüntüle yetkisi olanlar. İstek/yanıtlar maskelidir; secret, consent ve token görünmez.

Diğer Garanti BBVA API'leri? Modül servis mimarisiyle genişletilir; bkz. Geliştirme.