C# FinTech Uygulamaları için PDF Makbuzlar ve İşlem Kayıtları

Bir ödeme başarılı olur ve işlem kaydı veritabanına yazılır. Aynı işlemci – bir yanıt döndürmeden önce – işlem ayrıntılarıyla birlikte bir HTML içerik makbuzu şablonunu doldurur: Kimlik, UTC zaman damgası, tutar ve para birimi, gönderen ve alıcı kimlikleri, ücret dökümü ve dinamik içerik.

Yeni ChromePdfRenderer (özellikle var renderer = new ChromePdfRenderer();), web içeriğini PDF formatına dönüştürür. Ortaya çıkan PDF byte dizisi anında SHA-256 kullanılarak karmalanır.

using IronPdf
using System.Security.Cryptography;

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.MarginTop = 15;

renderer.RenderingOptions.MarginBottom = 15;

string receiptHtml = $@"
    <h1>Transaction Receipt</h1>
    <p><strong>Transaction ID:</strong> {tx.Id}</p>
    <p><strong>Timestamp (UTC):</strong> {tx.CompletedAt:u}</p>
    <p><strong>Amount:</strong> {tx.Amount:F2} {tx.Currency}</p>
    <p><strong>Fee:</strong> {tx.Fee:F2} {tx.Currency}</p>
    <p><strong>From:</strong> {tx.SenderRef} &rarr; <strong>To:</strong> {tx.ReceiverRef}</p>
    <p><strong>Resulting Balance:</strong> {tx.ClosingBalance:F2} {tx.Currency}</p>";

var pdf = renderer.RenderHtmlAsPdf(receiptHtml);

string hash = Convert.ToHexString(SHA256.HashData(pdf.BinaryData));

await _db.StoreReceiptHashAsync(tx.Id, hash);

await _blobStorage.UploadImmutableAsync($"receipts/{tx.Id}.pdf", pdf.BinaryData);

using IronPdf
using System.Security.Cryptography;

var renderer = new ChromePdfRenderer();

renderer.RenderingOptions.MarginTop = 15;

renderer.RenderingOptions.MarginBottom = 15;

string receiptHtml = $@"
    <h1>Transaction Receipt</h1>
    <p><strong>Transaction ID:</strong> {tx.Id}</p>
    <p><strong>Timestamp (UTC):</strong> {tx.CompletedAt:u}</p>
    <p><strong>Amount:</strong> {tx.Amount:F2} {tx.Currency}</p>
    <p><strong>Fee:</strong> {tx.Fee:F2} {tx.Currency}</p>
    <p><strong>From:</strong> {tx.SenderRef} &rarr; <strong>To:</strong> {tx.ReceiverRef}</p>
    <p><strong>Resulting Balance:</strong> {tx.ClosingBalance:F2} {tx.Currency}</p>";

var pdf = renderer.RenderHtmlAsPdf(receiptHtml);

string hash = Convert.ToHexString(SHA256.HashData(pdf.BinaryData));

await _db.StoreReceiptHashAsync(tx.Id, hash);

await _blobStorage.UploadImmutableAsync($"receipts/{tx.Id}.pdf", pdf.BinaryData);

Imports IronPdf
Imports System.Security.Cryptography

Dim renderer As New ChromePdfRenderer()

renderer.RenderingOptions.MarginTop = 15

renderer.RenderingOptions.MarginBottom = 15

Dim receiptHtml As String = $"
    <h1>Transaction Receipt</h1>
    <p><strong>Transaction ID:</strong> {tx.Id}</p>
    <p><strong>Timestamp (UTC):</strong> {tx.CompletedAt:u}</p>
    <p><strong>Amount:</strong> {tx.Amount:F2} {tx.Currency}</p>
    <p><strong>Fee:</strong> {tx.Fee:F2} {tx.Currency}</p>
    <p><strong>From:</strong> {tx.SenderRef} &rarr; <strong>To:</strong> {tx.ReceiverRef}</p>
    <p><strong>Resulting Balance:</strong> {tx.ClosingBalance:F2} {tx.Currency}</p>"

Dim pdf = renderer.RenderHtmlAsPdf(receiptHtml)

Dim hash As String = Convert.ToHexString(SHA256.HashData(pdf.BinaryData))

Await _db.StoreReceiptHashAsync(tx.Id, hash)

Await _blobStorage.UploadImmutableAsync($"receipts/{tx.Id}.pdf", pdf.BinaryData)

Örnek Oluşturulmuş PDF Belgesi

Yeni PDF belgesi daha sonra değişmez depolamaya kaydedilir. İster ilk PDF'iniz ister mevcut PDF'leri birleştiriyor olun, süreç değişmez. Bir kopyası müşteriye bir PDF görüntüleyicisinde sunulur. Bir Iron Software ürün demosu sırasında, yazılım ürünü demo ekibi genellikle birkaç satırlık kodla dinamik raporlar ve HTML'den PDF dönüşümüne ya da PDF oluşturma görevlerine nasıl çözümler getirebileceğini vurgular.

UI/UX'e yardımcı olmak için, panoda mavi daire içinde bir anahtar, gri daire içinde bir anahtar veya mavi daire içinde bir anahtar görebilirsiniz; bu, güvenli bir şekilde karmalanmış bir dosyayı simgeler. İndirme bağlantısını içeren sağ ok simgesi kullanıcıların gezinmesine yardımcı olur.

Damgalı bir başlık veya altbilgi, belgenin kaynağını her sayfada pekiştirir:

var shortHash = hash[..12];

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = $@"
        <div style='font-size:9px; color:#666; text-align:center;'>
            Generated: {tx.CompletedAt:u} &nbsp;|&nbsp;
            TX: {tx.Id} &nbsp;|&nbsp;
            SHA-256: {shortHash}...
        </div>"
};

var shortHash = hash[..12];

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
    HtmlFragment = $@"
        <div style='font-size:9px; color:#666; text-align:center;'>
            Generated: {tx.CompletedAt:u} &nbsp;|&nbsp;
            TX: {tx.Id} &nbsp;|&nbsp;
            SHA-256: {shortHash}...
        </div>"
};

Örnek Altbilgi

Makbuzun her sayfası, işlem kimliğini, oluşturma zaman damgasını ve kısaltılmış bir karmayı taşır; bu, bir bağlılık görevlisinin bütünlüğü kontrol etmesi için yeterlidir, veritabanına erişim gerektirmez.