FonsecaFramework.PayPal 2026.5.20.1

FonsecaFramework.PayPal

A simplified PayPal REST API client for .NET with invoicing and PDF generation.

Overview

FonsecaFramework.PayPal is a .NET 9 library that wraps the PayPal REST API to provide a streamlined experience for common payment operations. It supports purchasing products, creating and managing invoices, handling subscriptions, and generating professional invoice PDFs using iText.

Installation

dotnet add package FonsecaFramework.PayPal

Features

Examples

Configure and Start a Purchase

using FonsecaFramework.PayPal;

var settings = new PayPalSettings
{
    PayPalClientId = "<your-client-id>",
    PayPalClientSecret = "<your-client-secret>",
    PayPalUrl = "https://api-m.sandbox.paypal.com"
};

var client = new PayPalClient(new HttpClient(), settings, logger);

var products = new List<Product>
{
    new Product { Name = "Widget", Price = 25.00m, CurrencyCode = "USD", Quantity = 2 },
    new Product { Name = "Gadget", Price = 15.50m, CurrencyCode = "USD", Quantity = 1 }
};

Reciept? receipt = await client.StartPurchaseProducts(
    products,
    SuccessUrl: "https://mysite.com/success",
    FailureUrl: "https://mysite.com/cancel",
    InvoiceNumber: "INV-001",
    TaxRate: 0.08m);

if (receipt != null)
{
    Console.WriteLine($"Order: {receipt.OrderID}");
    Console.WriteLine($"Checkout: {receipt.CheckoutUrl}");
    Console.WriteLine($"Total: {receipt.Total:C}");
}

Generate an Invoice PDF

using FonsecaFramework.PayPal;

var invoice = new Invoice
{
    InvoiceNumber = "INV-2025-001",
    InvoiceDate = DateTime.Today,
    DueDate = DateTime.Today.AddDays(30),
    TaxRate = 0.07m,
    BillingParty = new BillingParty
    {
        FirstName = "Acme Corp",
        StreetAddress = "123 Main St",
        City = "Springfield",
        State = "IL",
        PostalCode = "62704",
        CountryCode = "US"
    },
    BillableParties = new List<BillableParty>
    {
        new BillableParty
        {
            FirstName = "Jane",
            LastName = "Doe",
            Email = "jane@example.com",
            StreetAddress = "456 Oak Ave",
            City = "Chicago",
            State = "IL",
            PostalCode = "60601",
            CountryCode = "US"
        }
    },
    Products = new List<Product>
    {
        new Product { Name = "Consulting", Price = 150.00m, CurrencyCode = "USD", Quantity = 4 }
    }
};

InvoicePdfGenerator.GenerateInvoice("invoice.pdf", invoice);
Console.WriteLine("Invoice PDF generated.");

Requirements

• .NET 9.0
• PayPal developer account (sandbox or live credentials)

License

Copyright 2025 Steven Fonseca / VLR Creations

Licensed under the Apache License, Version 2.0. You may use this library free of charge, provided you include the required attribution notices. See the LICENSE file for full terms.