Ücretsiz üye ol

E-ticaret siteniz için doğrulama ve hesaplama API'si

Ödeme sayfasındaki hatalı VKN, iade formundaki yanlış IBAN, üç farklı biçimde yazılmış telefon ve eksik ilçe listesi siparişten sonra iş çıkarır. VeriApi.Pro bunları sipariş anında, tek API anahtarıyla denetler. Kargo desisi, pazaryeri kâr hesabı ve fatura karekodu da aynı pakette. Tek tek doğrulama uçları ücretsiz pakette açıktır (günde 500 birim).

Ücretsiz anahtar al Dokümantasyon

Formlarınızda neler denetlenir?

Örnek: ödeme formunu sunucuda denetlemek

Anahtar tarayıcıya konmaz; form gönderilince sunucunuz API'yi çağırır. API'ye ulaşılamazsa sipariş engellenmez, yalnızca denetim atlanır.

<?php
function veriapi(string $yol, array $sorgu): ?array {
    $url = 'https://api.veriapi.pro' . $yol . '?' . http_build_query($sorgu);
    $ctx = stream_context_create(['http' => [
        'header' => "X-API-Key: " . getenv('VERIAPI_KEY') . "\r\nUser-Agent: magazam/1.0",
        'timeout' => 5,
        'ignore_errors' => true,
    ]]);
    $yanit = @file_get_contents($url, false, $ctx);
    $json = $yanit ? json_decode($yanit, true) : null;
    return $json['veri'] ?? null;   // ulaşılamazsa null: siparişi durdurma
}

$hatalar = [];

if (($_POST['fatura_turu'] ?? '') === 'kurumsal') {
    $firma = veriapi('/v1/dogrula/firma', [
        'vergi_no'      => $_POST['vergi_no'] ?? '',
        'vergi_dairesi' => $_POST['vergi_dairesi'] ?? '',
        'unvan'         => $_POST['unvan'] ?? '',
    ]);
    foreach ($firma['kontroller'] ?? [] as $k) {
        if ($k['durum'] === 'gecersiz') $hatalar[] = $k['mesaj'];
    }
}

if (!empty($_POST['iade_iban'])) {
    $iban = veriapi('/v1/iban/dogrula', ['iban' => $_POST['iade_iban']]);
    if ($iban && !$iban['gecerli']) $hatalar[] = 'IBAN hatalı: ' . $iban['hata'];
}

$tel = veriapi('/v1/telefon/bilgi', ['numara' => $_POST['telefon'] ?? '']);
if ($tel && !$tel['gecerli']) $hatalar[] = 'Telefon numarası geçersiz.';
$telefon = $tel['e164'] ?? ($_POST['telefon'] ?? '');   // +905321234567 biçiminde saklayın

Firma denetiminin yanıtındaki duzeltilmis alanı vergi dairesinin resmî adını ve kodunu, kısa unvanı verir; faturaya bunu yazabilirsiniz. Algoritma yalnızca yazımı denetler: firmanın kayıtlı ya da faal olduğunu göstermez.

Hangi paket?

Başlamak için: Ücretsiz paket

Tek tek VKN / TCKN, firma, IBAN, telefon, il-ilçe, posta kodu, desi ve barkod doğrulama. Günde 500 birim.

Pazaryeri hesabı ve toplu iş için: Başlangıç

149 TL/ay (KDV dahil), günde 10.000 birim; kâr hesabı, toplu doğrulama, Türkçe karakter düzeltme ve tüm API'ler, %99 SLA.

Başlangıç paketini seç Tüm paketler

Birden çok mağazayı yöneten ajans ya da e-ticaret altyapısı mısınız? Kurumsal teklif alın.

Sık sorulan sorular

VKN doğrulama firmanın gerçekten kayıtlı olduğunu gösterir mi?

Hayır. Numara, vergi dairesi ve MERSİS kurallara ve vergi dairesi listesine göre denetlenir; GİB mükellef sorgusu yapılmaz. Firmanın kayıtlı, faal ya da e-Fatura mükellefi olduğu bu yolla bilinemez. Yazım hatalarını ve tutarsız bilgiyi sipariş anında yakalamak içindir.

Girilen IBAN, VKN ve telefon numaraları saklanıyor mu?

Doğrulama sonuçları veritabanına kaydedilmez. Panelinizdeki "son istekler" listesi, sorun ayıklayabilmeniz için anahtar başına son 50 isteğin adresini 7 gün tutar ve yalnızca sizin hesabınızda görünür. Kişisel veriyi adreste taşımak istemiyorsanız toplu doğrulama uçlarını (POST gövdesi) kullanın.

Hangi paket yeterli?

Tek tek doğrulama, adres, telefon, desi ve barkod doğrulama ücretsiz pakette açıktır (günde 500 birim). Pazaryeri kâr hesabı, toplu doğrulama ve Türkçe karakter düzeltme ücretli paketlerdedir; Başlangıç paketi aylık 149 TL, günde 10.000 birim.

Doğrulamayı tarayıcıda mı sunucuda mı yapmalıyım?

Sunucuda. API anahtarı tarayıcıya konmaz; form gönderildiğinde kendi sunucunuz API'yi çağırır. Kullanıcı yazarken anlık uyarı için IBAN ve TCKN kontrol hanesi tarayıcıda da hesaplanabilir, kesin karar sunucuda verilir.

Komisyon oranlarını API mi veriyor?

Hayır. Pazaryeri komisyonu kategoriye ve kampanyaya göre değişir; oranı siz verirsiniz, API KDV, stopaj, kargo ve hizmet bedeliyle birlikte hakediş ve kârı hesaplar.