Bisakah gPdf menghitung total receipt?

Tidak. Sistem pembayaran atau commerce Anda memiliki total, diskon, pajak, dan status refund. gPdf merender nilai yang Anda kirim.

Sebaiknya receipt memakai JSON Render atau Template Render?

Gunakan JSON Render saat mendesain layout. Gunakan Template Render saat layout receipt dan kontrak field sudah stabil.

Bisakah receipt memuat QR code?

Ya. gPdf mendukung elemen barcode QR code dalam output PDF. Sistem Anda memiliki URL atau payload yang dikodekan dalam QR code.

Apakah ini sama dengan e-invoice API?

Tidak. PDF receipt biasa memakai JSON Render atau Template Render. Packaging Factur-X dan ZUGFeRD memakai endpoint E-Invoice Render.

Invoice dan finance

Receipt PDF API untuk pembayaran ecommerce dan SaaS

Buat PDF receipt dari data pesanan, pembayaran, pajak, dan refund dengan QR code, barcode, pengaturan PDF/A, dan output template yang dapat diulang.

API UTAMA JSON Render

ENDPOINT /api/v1/pdf/render

SISTEM backend ecommerce / backend billing / platform SaaS / layanan export POS

Coba di Playground Baca dokumentasi

Pekerjaan yang diselesaikan

Mengubah data pesanan selesai, pembayaran, refund, dan pajak menjadi PDF receipt yang bisa dikirim email, disimpan, dicetak, atau dilampirkan ke akun pelanggan tanpa meminta setiap caller memiliki kode menggambar PDF.

Kapan memakai API ini

Sistem Anda sudah memiliki status pembayaran, nomor receipt, baris pajak, dan data pelanggan.
Anda membutuhkan PDF receipt untuk email, riwayat akun, workflow support, atau export audit.
Anda ingin QR code atau barcode di dalam receipt untuk lookup, refund, atau alur pickup.
Anda membutuhkan template receipt yang stabil setelah layout disetujui.

Apa yang tidak digantikan

Anda membutuhkan pemrosesan pembayaran atau eksekusi refund. gPdf merender receipt; sistem pembayaran Anda mengelola perpindahan uang.
Anda membutuhkan packaging e-invoice legal. Gunakan endpoint E-Invoice Render untuk output Factur-X atau ZUGFeRD.
Anda membutuhkan kontrol hardware POS atau logika cash drawer.

Endpoint yang dipanggil

UTAMA

/api/v1/pdf/render

JSON Render adalah jalur default untuk workflow ini.

SEKUNDER 1

/api/v1/template-render

Gunakan saat workflow butuh jalur API terkait, kontrak template, atau capability lookup.

Request minimal

POST /api/v1/pdf/render - receipt ringkas dengan QR code lookup.

{
  "pages": [
    {
      "size": "a6",
      "elements": [
        {
          "type": "text",
          "x": 10,
          "y": 12,
          "content": "Receipt R-2026-1001",
          "style": { "font_size": 16, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "text",
          "x": 10,
          "y": 28,
          "content": "Order total: $82.40\nPaid by card ending 4242\nTax: $6.10",
          "style": { "font_size": 10, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "barcode",
          "format": "qrcode",
          "content": "https://example.com/receipts/R-2026-1001",
          "x": 10,
          "y": 58,
          "width": 28,
          "height": 28
        }
      ]
    }
  ]
}

Yang ditangani gPdf

Render halaman receipt dari payload JSON Render.
Teks, total, baris item, QR code, barcode, metadata, dan pengaturan PDF/A opsional.
Binding Template Render ketika layout receipt yang sama dipakai ulang.
Output PDF biner dengan envelope error gPdf yang sama saat gagal.

Yang dikelola sistem Anda

Otorisasi pembayaran, capture, refund, perhitungan pajak, dan penomoran receipt.
Identitas pelanggan, status pesanan, format mata uang, dan kebijakan retensi.
Delivery email, storage akun, dan penanganan receipt duplikat.

Checklist produksi

Gunakan nomor receipt yang stabil dan kirim X-Request-Id pada setiap render.
Tentukan apakah receipt harus digenerate ulang dari source data atau disimpan setelah render pertama.
Uji nama item panjang, refund, diskon, beberapa baris pajak, dan pesanan bernilai nol.
Pindah ke Template Render setelah tim support dan finance menyetujui layout.
Jaga keputusan pembayaran dan pajak tetap di luar request render.

Batas klaim

gPdf tidak memproses pembayaran, menghitung pajak, atau menerbitkan refund.
PDF receipt tidak otomatis menjadi e-invoice legal.
Sistem Anda memiliki kebenaran bisnis; gPdf merender representasi PDF.

PDF receipt adalah output rendering

Ini bukan endpoint pembayaran atau POS terpisah. Backend ecommerce, billing, atau POS Anda memutuskan bahwa receipt ada, lalu mengirim konten receipt ke gPdf sebagai DocumentRequest atau sebagai data untuk template yang dipublikasikan.

Lapisan rendering harus tetap deterministik. Jika agen support meminta receipt yang sama lagi, sistem Anda dapat memutar ulang source data atau mengembalikan PDF yang sudah disimpan sesuai kebijakan retensi.

Jalur template untuk receipt berulang

Layout receipt biasanya cepat stabil. Setelah desain disetujui, publikasikan template dan panggil POST /api/v1/template-render dengan field receipt. Ini menjaga sistem pembayaran fokus pada data dan menjaga kepemilikan layout di satu tempat.

FAQ

Bisakah gPdf menghitung total receipt?: Tidak. Sistem pembayaran atau commerce Anda memiliki total, diskon, pajak, dan status refund. gPdf merender nilai yang Anda kirim.
Sebaiknya receipt memakai JSON Render atau Template Render?: Gunakan JSON Render saat mendesain layout. Gunakan Template Render saat layout receipt dan kontrak field sudah stabil.
Bisakah receipt memuat QR code?: Ya. gPdf mendukung elemen barcode QR code dalam output PDF. Sistem Anda memiliki URL atau payload yang dikodekan dalam QR code.
Apakah ini sama dengan e-invoice API?: Tidak. PDF receipt biasa memakai JSON Render atau Template Render. Packaging Factur-X dan ZUGFeRD memakai endpoint E-Invoice Render.