Baca Kode QR Swiss - Ekstraktor Data Pembayaran API
PDF4me Baca Kode QR Swiss memungkinkan Anda untuk mengekstrak dan membaca kode SwissQR dari PDF dokumen menggunakan teknologi canggih OCR dan teknologi pengenalan kode batang. Ini API proses layanan PDF menyimpan dan mengekstrak informasi pembayaran terstruktur termasuk jumlah, mata uang, IBAN, detail kreditur, dan referensi pembayaran untuk pemrosesan pembayaran digital yang lancar. The API menerima PDF konten melalui REST API panggilan, memanfaatkan Base64 Pengkodean untuk transmisi yang aman. Solusi ini ideal untuk pemrosesan faktur, integrasi perbankan, otomatisasi pembayaran, dan pelaporan keuangan.
Memverifikasi Identitas Anda API Meminta
Untuk mengakses PDF4me REST APISetiap permintaan harus menyertakan kredensial otentikasi yang tepat. Otentikasi memastikan komunikasi yang aman dan memvalidasi identitas Anda sebagai pengguna yang berwenang. REST API.
Fitur Utama
- Pengenalan Kode QR SwissEkstrak dan baca kode QR Swiss dari PDF dokumen menggunakan teknologi canggih OCR dan teknologi pengenalan kode batang
- Data Pembayaran TerstrukturEkstrak informasi pembayaran terstruktur termasuk jumlah, mata uang, IBAN, rincian kreditur, dan referensi pembayaran
- Standar Pembayaran SwissDukungan untuk Swiss QR-standar pembayaran tagihan digital (Juni 2020)
- Pemrosesan Asinkron: Dukungan untuk async pemrosesan dengan polling untuk operasi yang berjalan lama
Dukungan Kode QR Swiss
Yang API mendukung pembacaan kode QR Swiss dari PDF dokumen. Kode QR Swiss berisi informasi pembayaran terstruktur termasuk jumlah, mata uang, IBAN, detail kreditur, dan referensi pembayaran. Data yang diekstrak dikembalikan dalam format standar untuk diintegrasikan dengan sistem pemrosesan pembayaran.
Titik Akhir API REST
Yang PDF4me REST API menggunakan standar HTTP Metode untuk berinteraksi dengan sumber daya. Semua operasi pembacaan kode SwissQR dilakukan melalui satu titik akhir:
- Metode: POST
- Titik akhir:
/api/v2/ReadSwissQRBill
Parameter API REST
Daftar lengkap parameter untuk Read SwissQR Code REST APIParameter-parameter tersebut diorganisir berdasarkan kategori untuk pemahaman dan implementasi yang lebih baik.
Penting: Parameter yang ditandai dengan tanda bintang (*) wajib diisi dan harus diberikan agar dapat digunakan. API agar berfungsi dengan benar.
Parameter yang Diperlukan
| Parameter | Jenis | Keterangan | Contoh |
|---|---|---|---|
| docContent* | Base64 | PDF isi file yang dikodekan dalam Base64 berisi kode QR Swiss | JVBERi... |
| docName* | String | PDF nama file dengan ekstensi .pdf | invoice.pdf |
| async* | Boolean | Aktifkan pemrosesan asinkron. Saat true, itu API mengembalikan status 202 dan menyediakan polling URL di dalam Location judul | true |
Keluaran
Yang PDF4me Baca Kode QR Swiss REST API Mengembalikan respons yang berbeda berdasarkan mode pemrosesan. API pengembalian terstruktur JSON Data dengan informasi kode QR Swiss.
- Success Response
- Asynchronous Processing
- Error Responses
- Response Format Details
Pemrosesan Sinkron (Default)
Kapan async tidak diatur atau diatur ke false, itu API memproses permintaan tersebut dengan segera:
Kode Status: 200 OK
Content-Type: application/json
Isi Tanggapan:
{
"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"
}
}
Kolom Respons:
- nama file (string): The PDF nama file
- mimeType (rangkaian): MIME jenis file (aplikasi/pdf)
- Ukuran berkas (angka): Ukuran PDF berkas dalam byte
- kesuksesan (boolean): Menunjukkan apakah kode SwissQR berhasil dibaca
- Kode QR Swiss (objek): Informasi pembayaran kode QR Swiss yang diekstrak
- jumlah (string): Jumlah pembayaran
- mata uang (string): Kode mata uang (CHF, EUR, USD)
- mereka akan pergi (rangkaian): IBAN dari kreditur
- nama kreditur (string): Nama atau perusahaan kreditur
- referensi pembayaran (string): Nomor referensi pembayaran
- tenggat waktu (string): Tanggal jatuh tempo pembayaran (jika tersedia)
- tujuan (string): Tujuan atau deskripsi pembayaran
Contoh (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}`);
}
Pemrosesan Asinkron
Kapan async: true sudah ditetapkan, API memproses permintaan secara asinkron:
Kode Status: 202 Accepted
Header Respons:
Location: https://api.pdf4me.com/api/v2/ReadSwissQRBill/poll/12345-abcde-67890
Proses Pemungutan Suara:
- Ekstrak
Locationheader dari respons 202 - Jajak pendapat URL menggunakan GET permintaan
- Lanjutkan jajak pendapat hingga Anda menerima 200 OK status
- Jawaban terakhir berisi hal yang sama. JSON format dengan data kode QR Swiss
Contoh Polling:
// Initial request returns 202 with Location header
const response = await fetch(url, options);
const location = response.headers.get('Location');
// Poll until complete
while (true) {
const pollResponse = await fetch(location, { headers: { 'Authorization': 'Basic ' + apiKey } });
if (pollResponse.status === 200) {
const data = await pollResponse.json();
// Process data.swissQrCodeData
break;
}
await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}
Respons Kesalahan
Yang API pengembalian standar HTTP Kode kesalahan beserta detail kesalahannya:
- Parameter permintaan tidak valid
- Kolom yang wajib diisi belum terisi (
Konten dokumen,Nama dokumen,asinkron) - Tidak sah Base64 pengkodean dalam
Konten dokumen - PDF tidak mengandung kode QR Swiss
- Tidak valid atau hilang API kunci
- API kunci tidak berfungsi dengan benar Base64 dikodekan dalam Authorization judul
- Hilang
Authorization: Dasarjudul
- Kesalahan pemrosesan sisi server
- PDF kegagalan pemrosesan
- Kegagalan pengenalan kode QR Swiss
Format Respons Kesalahan:
{
"error": "Error message describing what went wrong"
}
Detail Format Respons
Penting: Yang API selalu kembali JSON dengan data kode QR Swiss terstruktur.
Struktur Respons:
{
"fileName": "string", // PDF filename
"mimeType": "string", // MIME type
"fileSize": number, // File size in bytes
"success": boolean, // Success indicator
"swissQrCodeData": { // SwissQR code data object
"amount": "string", // Payment amount
"currency": "string", // Currency code
"iban": "string", // IBAN
"creditorName": "string", // Creditor name
"paymentReference": "string", // Payment reference
"dueDate": "string", // Due date (optional)
"purpose": "string" // Payment purpose (optional)
}
}
Content-Type Judul:
- Kesuksesan:
application/json
Kode QR Swiss tidak ditemukan:
Jika tidak ditemukan kode QR Swiss di PDF, respons tersebut mungkin menunjukkan success: false atau swissQrCodeData Kolom tersebut mungkin bernilai null atau kosong.
Contoh Permintaan
Judul
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
Catatan:
- Dapatkan milikmu API kunci dari PDF4me Dasbor
- Yang API kunci harus Base64 dikodekan dan diawali dengan "Basic" di dalam Authorization judul
- Contoh: Jika Anda API kuncinya adalah
abc123, mengkodekannya menjadi Base64 dan menggunakanAuthorization: Basic YWJjMTIz
Muatan
Contoh:
{
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"docName": "invoice.pdf",
"async": true
}
Contoh Kode
Yang PDF4me Baca Kode QR Swiss REST API Menyediakan contoh kode dalam berbagai bahasa pemrograman. Pilih bahasa yang paling sesuai dengan lingkungan pengembangan Anda:
- C#
- Java
- JavaScript
- Python
- Salesforce
- n8n
- Google Script
- AWS Lambda
C# (CSharp) Contoh
Menyelesaikan C# implementasi untuk membaca kode SwissQR dari PDF dokumen:
Java Contoh
Java Implementasi dengan penanganan kesalahan dan pemrosesan respons yang lengkap:
JavaScript Contoh
Node.js dan kompatibel dengan browser JavaScript implementasi:
Google Script Contoh
Google Apps Script implementasi untuk Google Workspace integrasi:
Studi Kasus & Aplikasi Industri
- Finance & Banking
- Business & Enterprise
- Government & Compliance
Studi Kasus Keuangan & Perbankan
- Pemrosesan FakturEkstrak informasi pembayaran dari Swiss QR faktur untuk pemrosesan pembayaran otomatis
- Integrasi PerbankanMengintegrasikan pembacaan kode QR Swiss ke dalam aplikasi perbankan dan sistem pembayaran.
- Otomatisasi PembayaranSederhanakan alur kerja pembayaran dan kurangi entri data manual.
- Pemrosesan Tagihan: Otomatisasi Swiss QR pemrosesan tagihan dan verifikasi pembayaran
- Rekonsiliasi PembayaranOtomatiskan proses pencocokan dan rekonsiliasi pembayaran.
- Pelaporan KeuanganEkstrak data pembayaran dari Swiss QR kode untuk pelaporan dan analisis keuangan
Kasus Penggunaan Bisnis & Perusahaan
- Manajemen FakturOtomatiskan pemrosesan faktur dan pelacakan pembayaran.
- Sistem AkuntansiIntegrasikan pembacaan kode QR Swiss ke dalam akuntansi dan ERP sistem
- Dokumen Keuangan: Memproses dokumen keuangan yang berisi dokumen Swiss QR kode
- Integrasi Pembayaran: Integrasi Swiss QR kode ke dalam sistem pemrosesan pembayaran yang sudah ada.
- Transformasi DigitalModernisasi alur kerja pemrosesan pembayaran
- Otomatisasi Proses BisnisOtomatiskan alur kerja pembayaran untuk operasional perusahaan.
Studi Kasus Pemerintahan & Kepatuhan
- Manajemen Kepatuhan: Memastikan kepatuhan terhadap peraturan perbankan dan standar pembayaran Swiss
- Kepatuhan Regulasi: Proses Swiss QR kode untuk kepatuhan peraturan dan audit
- Pembayaran Pemerintah: Memproses dokumen pembayaran pemerintah dengan Swiss QR kode
- Kepatuhan Keuangan: Memastikan kepatuhan terhadap peraturan keuangan Swiss