Aeroverra.PayPalSharp 0.0.1

AeroPayPalSharp

A strict-typed PayPal REST client for modern .NET, with first-class partner / platform (multiparty) support.

Why

The existing .NET options for PayPal are dated and loosely typed, and none cleanly support the partner APIs (acting on behalf of sellers). AeroPayPalSharp is generated from PayPal's official OpenAPI specs and then tightened so responses are actually typed instead of everything-nullable. It wraps all of PayPal's REST APIs behind one injectable client, handles OAuth for you, and makes partner flows (auth assertion, attribution) first-class.

• All of PayPal's REST APIs, one injectable IPayPalApiClient
• Strongly-typed models (enums are strings, so new PayPal values never crash deserialization)
• OAuth2 fetched, cached, and refreshed automatically
• Partner attribution and auth assertion built in, including a clean ActingAsMerchant scope
• .NET 10, Newtonsoft.Json

Install

dotnet add package AeroPayPalSharp

Getting started

Configure and inject (keep the client id / secret in user-secrets or env vars):

services.AddPayPalSharp(options =>
{
    options.Environment  = PayPalEnvironment.Sandbox;   // or Live
    options.ClientId     = config["PayPal:ClientId"];
    options.ClientSecret = config["PayPal:ClientSecret"];
});

Create an order and read it back:

public sealed class Checkout(IPayPalApiClient paypal)
{
    public async Task<string> CreateOrder()
    {
        var order = new Order_request
        {
            Intent = "CAPTURE",
            Purchase_units = new List<Purchase_units>
            {
                new Purchase_units { Amount = new Amount3 { Currency_code = "USD", Value = "10.00" } },
            },
        };

        Order created = await paypal.Orders.CreateAsync(order, payPal_Request_Id: Guid.NewGuid().ToString("N"));
        Order fetched = await paypal.Orders.GetAsync(created.Id);
        return fetched.Status;   // "CREATED"
    }
}

As a partner, acting for a seller

Direct the funds to the seller with payee.merchant_id, and run the call on their behalf with an ActingAsMerchant scope (it adds the PayPal-Auth-Assertion header for that merchant):

using (paypal.ActingAsMerchant(sellerMerchantId))
{
    var order = new Order_request
    {
        Intent = "CAPTURE",
        Purchase_units = new List<Purchase_units>
        {
            new Purchase_units
            {
                Amount = new Amount3 { Currency_code = "USD", Value = "10.00" },
                Payee  = new Payee3 { Merchant_id = sellerMerchantId },   // who gets the money
            },
        },
    };

    Order created = await paypal.Orders.CreateAsync(order, payPal_Request_Id: Guid.NewGuid().ToString("N"));
}

Documentation

Everything else lives in the wiki:

• Configuration
• Authentication
• Partner and platform (acting for sellers)
• Multi-tenant: clients from raw credentials
• The clients
• Error handling
• Models and nullability
• Regenerating the clients
• Testing

License

MIT. See LICENSE.md.