C# PDF-owe pokwitowania i rejestry transakcji dla aplikacji FinTech

Problem zgodności, a nie tylko problem formatowania

Większość aplikacji FinTech przechowuje dane transakcyjne w relacyjnej bazie danych i generuje potwierdzenia na żądanie — gdy klient o to poprosi, aplikacja ponownie wysyła zapytanie do rekordu i wyświetla wynik. Takie podejście ma zasadniczą wadę: wynikowy plik PDF lub "paragon" odzwierciedla aktualny stan danych, a nie to, co klient widział w momencie zakończenia transakcji.

Rekordy bazy danych mogą być korygowane, zmieniane lub aktualizowane w ramach normalnych procesów operacyjnych. Ponownie wygenerowany paragon nie jest dokumentem historycznym, lecz aktualnym zrzutem ekranu z datą z przeszłości. Gdy operator płatności ma do czynienia z obciążeniem zwrotnym, gdy zespół ds. zgodności neobanku odpowiada organowi regulacyjnemu, gdy żądany jest dziennik audytowy platformy pożyczkowej lub gdy giełda kryptowalut musi wykazać integralność dokumentów przed inspektorem KYC, potrzebny jest dokument, a nie zapytanie.

Dokument PDF zapisany w momencie rozliczenia, z hashowaniem w celu wykrywania manipulacji i zapisany w niezmiennej pamięci, jest właśnie tym dokumentem. Dzięki temu istniejące dokumenty PDF zachowają swoją aktualność przez lata. Niezależnie od tego, czy masz do czynienia z raportami finansowymi, czy prostym pierwszym plikiem PDF, generowanie dokumentów musi być ostateczne.

Obowiązki dotyczące prowadzenia dokumentacji wynikające z norm PCI-DSS, SOX i AML nie wymagają konkretnie dokumentów PDF generowanych programowo, ale wymagają dokumentacji, którą można wykazać i poddać audytowi. Renderowany, zaszyfrowany i opatrzony sygnaturą czasową plik PDF spełnia ten wymóg w sposób, w jaki sam wiersz bazy danych tego nie robi. W dalszej części tego artykułu przyjrzymy się przykładowi IronPDF, aby zobaczyć, jak ten proces może wyglądać podczas tworzenia nowego dokumentu PDF.

Rozwiązanie w skrócie: Konwersja treści HTML do formatu PDF w języku C

Jak działa proces od transakcji do paragonu

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)

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>"
};

Dlaczego ma to znaczenie poza kwestią zgodności

Zakończenie

Różnica między "przechowujemy dane transakcji" a "posiadamy rejestr podlegający audytowi" jest mniejsza niż się wydaje — to tylko jeden dodatkowy etap przetwarzania w procesie zatwierdzania transakcji. Ten krok pozwala uzyskać dokument o pochodzeniu, którego sam wiersz w bazie danych nie jest w stanie zapewnić: sygnaturę czasową, której nie można cofnąć, skrót wykrywający manipulacje oraz fizyczny artefakt, który wygląda tak samo niezależnie od tego, czy otwiera go klient, czy żąda go audytor.

IronPDF zapewnia zespołom .NET pełną kontrolę nad tym etapem, od renderowania potwierdzenia HTML po umieszczanie stempla w stopce, haszowanie danych wyjściowych i przesyłanie strumieniowe do niezmiennej pamięci masowej — wszystko to za pomocą jednej biblioteki dostępnej na stronie ironpdf.com. Jeśli tworzysz lub wzmacniasz potok transakcyjny, rozpocznij bezpłatny 30-dniowy okres próbny i sprawdź, czy generowane potwierdzenia są zgodne z Twoimi wymaganiami, zanim wprowadzisz rozwiązanie do produkcji.