Ana içeriğe geç
PDF4me APIEntegrasyonlarBilgi BankasıUzantılarAPI Test CihazıBlog

SwissQR Kodunu Okuyun - Ödeme Veri Çıkarıcı API

PDF4me SwissQR kodunu okuyun SwissQR kodlarını ayıklamanıza ve okumanıza olanak tanır. PDF gelişmiş yöntemleri kullanan belgeler OCR ve barkod tanıma teknolojisi. Bu API hizmet süreçleri PDF Dosyaları oluşturur ve tutarlar, para birimi dahil olmak üzere yapılandırılmış ödeme bilgilerini çıkarır, IBANDijital ödeme işlemlerinin sorunsuz bir şekilde gerçekleştirilmesi için alacaklı bilgileri ve ödeme referansları. API alır PDF içerik aracılığıyla REST API aramalar, kullanarak Base64 Güvenli iletim için kodlama. Bu çözüm, fatura işleme, bankacılık entegrasyonu, ödeme otomasyonu ve finansal raporlama için idealdir.

İlgili Blog Yazıları
Bu özellik için henüz bir blog yazısı yok — yakında yayınlanacak.
Bu arada, her platforma yönelik eğitimler ve iş akışları için PDF4me bloguna göz atın.
Blogu ziyaret edin →

Kimliğinizi Doğrulama API Rica etmek​

Erişmek için PDF4me REST APIHer istek, geçerli kimlik doğrulama bilgilerini içermelidir. Kimlik doğrulama, güvenli iletişimi sağlar ve yetkili bir kullanıcı olarak kimliğinizi doğrular. REST API.

Get your api Key

Başlıca Özellikler​

  • SwissQR Kod TanımaSwissQR kodlarını çıkarın ve okuyun. PDF gelişmiş yöntemleri kullanan belgeler OCR ve barkod tanıma teknolojisi
  • Yapılandırılmış Ödeme Verileri: Tutarlar, para birimi dahil olmak üzere yapılandırılmış ödeme bilgilerini çıkarın, IBANAlacaklı bilgileri ve ödeme referansları
  • İsviçre Ödeme Standardıİsviçre'ye destek QR- Dijital fatura ödeme standardı (Haziran 2020)
  • Asenkron İşleme: Desteklemek için async Uzun süren işlemler için yoklama yöntemiyle işleme

SwissQR Kod Desteği​

O API SwissQR kodlarını okumayı destekler. PDF SwissQR kodları, tutar, para birimi gibi yapılandırılmış ödeme bilgilerini içerir. IBANAlacaklı bilgileri ve ödeme referansları da dahil olmak üzere, çıkarılan veriler ödeme işleme sistemleriyle entegrasyon için standartlaştırılmış bir formatta döndürülür.

REST API Uç Noktası​

O PDF4me REST API standart kullanır HTTP Kaynaklarla etkileşim kurma yöntemleri. Tüm SwissQR kod okuma işlemleri tek bir uç nokta üzerinden gerçekleştirilir:

  • Yöntem: POST
  • Uç nokta: /api/v2/ReadSwissQRBill

REST API Parametreleri​

SwissQR kodunu okuma işlemi için parametrelerin tam listesi REST APIParametreler, daha iyi anlaşılması ve uygulanması için kategoriye göre düzenlenmiştir.

Önemli: Yıldız (*) ile işaretlenmiş parametreler zorunludur ve mutlaka sağlanmalıdır. API doğru şekilde çalışması için.

Gerekli Parametreler​

ParametreTipTanımÖrnek
docContent*Base64PDF dosya içeriği kodlanmış Base64 İsviçre QR kodlarını içerenJVBERi...
docName*StringPDF .pdf uzantılı dosya adıinvoice.pdf
async*BooleanAsenkron işlemeyi etkinleştirin. true, o API 202 durum kodu döndürür ve bir yoklama işlemi sağlar. URL içinde Location başlıktrue

Çıktı​

O PDF4me SwissQR kodunu okuyun REST API İşleme moduna bağlı olarak farklı yanıtlar döndürür. API yapılandırılmış getiriler JSON SwissQR kod bilgileri içeren veriler.

Senkron İşleme (Varsayılan)

Ne zaman async ayarlanmamış veya ayarlanmış false, o API İsteği hemen işleme koyar:

Durum Kodu: 200 OK

Content-Type: application/json

Yanıt Metni:

{
  "fileName": "invoice.pdf",
  "mimeType": "application/pdf",
  "fileSize": 2456789,
  "success": true,
  "swissQrCodeData": {
    "amount": "100.00",
    "currency": "CHF",
    "iban": "CH9300762011623852957",
    "creditorName": "Swiss Company AG",
    "paymentReference": "INV-2024-001",
    "dueDate": "2024-12-31",
    "purpose": "Invoice payment"
  }
}

Yanıt Alanları:

  • dosya adı (dize): The PDF dosya adı
  • mimeType (sicim): MIME Dosya türü (application/pdf)
  • dosya boyutu (sayı): Boyutu PDF bayt cinsinden dosya
  • başarı (boolean): SwissQR kodunun başarıyla okunup okunmadığını gösterir.
  • İsviçre QR Kod Verileri (nesne): Çıkarılan SwissQR kodlu ödeme bilgileri
    • miktar (dize): Ödeme tutarı
    • para birimi (dize): Para birimi kodu (CHF, EUR, USD)
    • gidiyorlardı (sicim): IBAN alacaklının
    • alacaklı adı (dize): Alacaklının adı veya şirketi
    • ödemeReferansı (dize): Ödeme referans numarası
    • bitiş tarihi (dize): Ödeme vadesi (varsa)
    • amaç (dize): Ödeme amacı veya açıklaması

Örnek (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
if (data.success) {
  console.log(`Amount: ${data.swissQrCodeData.amount} ${data.swissQrCodeData.currency}`);
  console.log(`IBAN: ${data.swissQrCodeData.iban}`);
}

Talep Örneği​

Başlık​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Not:

  • Alın API anahtardan PDF4me Kontrol Paneli
  • O API anahtar olmalı Base64 "Basic" önekiyle kodlanmış ve ön eklenmiş Authorization başlık
  • Örnek: Eğer sizin API anahtar şudur abc123onu kodla Base64 ve kullanın Authorization: Basic YWJjMTIz

Yük​

Örnek:

{
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "docName": "invoice.pdf",
  "async": true
}

Kod Örnekleri​

O PDF4me SwissQR kodunu okuyun REST API Birden fazla programlama dilinde kod örnekleri sunar. Geliştirme ortamınıza en uygun dili seçin:

C# (CSharp) Örnek

Tamamlamak C# SwissQR kodlarını okumak için uygulama PDF Belgeler:

Sektör Kullanım Örnekleri ve Uygulamaları​

Finans ve Bankacılık Kullanım Örnekleri

  • Fatura İşlemeİsviçre'den ödeme bilgilerini çıkarın. QR otomatik ödeme işlemleri için faturalar
  • Bankacılık EntegrasyonuSwissQR kod okuma özelliğini bankacılık uygulamalarına ve ödeme sistemlerine entegre edin.
  • Ödeme OtomasyonuÖdeme iş akışlarını kolaylaştırın ve manuel veri girişini azaltın.
  • Fatura İşlemeİsviçre'yi Otomatikleştirin QR fatura işleme ve ödeme doğrulama
  • Ödeme MutabakatıÖdeme eşleştirme ve mutabakat süreçlerini otomatikleştirin.
  • Finansal Raporlamaİsviçre'den ödeme verilerini çıkarın. QR Finansal raporlama ve analiz için kodlar

Yardım Alın​

Get Your API KeyAPI SamplesGetting Started