gPdf ödeme alır veya iade yapar mı?

Hayır. Ödeme işleyici ve iş sistemi ödeme durumunu belirler; gPdf PDF'i render eder.

Makbuzlar Template Render kullanmalı mı?

Yerleşim kararlıysa genellikle evet. Çağıran sistem yalnızca ödeme veya sipariş verisi gönderir.

Makbuz PDF'leri PDF/A kullanabilir mi?

Evet, JSON Render desteklenen PDF/A ayarları ile kullanılabilir.

Makbuz e-invoice yerine geçer mi?

Hayır. Sıradan makbuz PDF'leri JSON Render veya Template Render kullanır. Factur-X ve ZUGFeRD paketleme E-Invoice Render endpoint'ini kullanır.

Faturalama ve finans

E-ticaret ve SaaS ödemeleri için makbuz PDF API'si

E-ticaret ve SaaS ödeme verilerinden makbuz PDF'leri üretin; ödeme durumu, vergi mantık ve iade semantiği sisteminizde kalır.

ANA API JSON Render

ENDPOINT /api/v1/pdf/render

SİSTEMLER billing backend'i / ödeme servis / SaaS app / e-ticaret backend'i'i

Playground’da dene Dokümantasyonu oku

Çözülecek iş

Ödeme, order veya abonelik veriden özeler-readable makbuz PDF'i üretirken ödeme durumu, vergi, iade ve muhasebe semantiğini kendi sisteminizde tutmak.

Bu API ne zaman kullanılır

Sisteminiz ödeme, sipariş, iade veya abonelik veriye zaten sahip.
Müşteri için indirilebilir veya e-posta ile gönderilebilir makbuz PDF'i gerekiyor.
Tekrarlanan makbuz yerleşimleri için template_id sözleşmesi istiyorsunuz.
PDF/A gibi optional arşiv ayarları gerekebilir.

Neyin yerine geçmez

gPdf'in ödeme işleyici, iade motoru veya hesaping muhasebe defteri olmasını bekliyorsunuz.
Factur-X veya ZUGFeRD çıktı için legal e-invoice paketleme gerekiyor. E-Invoice Render kullanın.
Ödeme doğrulaması veya fraud kararı'ı render API'den bekliyorsunuz.

Hangi endpoint çağrılır

ANA

/api/v1/pdf/render

JSON Render bu iş akışı için varsayılan yoldur.

İKİNCİL 1

/api/v1/template-render

İş akışı ilgili API yoluna, template sözleşmesine veya capability sorgusuna ihtiyaç duyduğunda kullanın.

Minimum request

POST /api/v1/pdf/render - ödeme makbuz PDF'i.

{
  "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
        }
      ]
    }
  ]
}

gPdf neyi üstlenir

JSON Render veya Template Render ile makbuz PDF'i render işlemi.
Metin, toplamlar, ödeme referansları, metadata ve optional PDF/A ayarları.
Kararlı makbuz yerleşimleri için Template Render.
İndirme, e-posta attachment veya depolama için binary PDF yanıtı.

Sisteminiz neyi yönetir

Ödeme durumu, vergi hesaplaması, iade kuralları, özeler identity ve muhasebe kaydı anlamı.
Delivery, depolama, erişim kontrolü ve hesaping reconciliation.
Chargeback, fraud, makbuz uygunluğu ve compliance review.

Production kontrol listesi

Ödeme verisinin final olduğundan emin olun.
Refund, partial ödeme, discount ve multi-para birimi cases test edin.
template_id, request ID ve ödeme nesnesi ID'yi loglayın.
Müşteri teslimatını ve depolama politikasını render API dışında yönetin.
Legal e-invoice gerekiyorsa E-Invoice Render'a yönlendirin.

İddia sınırları

gPdf makbuz PDF'i render eder; ödeme veya iade işlemez.
Finansal doğruluk ve muhasebe semantiği çağıran sisteme aittir.
PDF/A çıktısı saklama politikası yerine geçmez.

Makbuz PDF’leri render işlemi çıktılarıdır

Makbuz, ödeme sisteminizin zaten bildiği gerçeklerin görünür belgesidir: ödeme durumu, amount, discount, vergi, iade durumu ve özeler details. Sisteminiz bu değerleri DocumentRequest olarak veya yayınlanmış şablon data olarak gönderebilir. gPdf bunları PDF’e render eder, ödeme veya hesaping kararları vermez.

Tekrarlanan makbuzlar için template path

Makbuz yerleşimi kararlı olduğunda Template Render, çağıran sistemlerin yalnızca ödeme verisi göndermesini sağlar. JSON Render prototyping veya özel yerleşimler için kullanılmaya devam eder.

SSS

gPdf ödeme alır veya iade yapar mı?: Hayır. Ödeme işleyici ve iş sistemi ödeme durumunu belirler; gPdf PDF'i render eder.
Makbuzlar Template Render kullanmalı mı?: Yerleşim kararlıysa genellikle evet. Çağıran sistem yalnızca ödeme veya sipariş verisi gönderir.
Makbuz PDF'leri PDF/A kullanabilir mi?: Evet, JSON Render desteklenen PDF/A ayarları ile kullanılabilir.
Makbuz e-invoice yerine geçer mi?: Hayır. Sıradan makbuz PDF'leri JSON Render veya Template Render kullanır. Factur-X ve ZUGFeRD paketleme E-Invoice Render endpoint'ini kullanır.