Omnia.PaymentStripe 1.3.3

Omnia.PaymentStripe

Libreria ASP.NET Core per integrazione completa con Stripe: pagamenti, clienti, webhook, subscriptions.

Installazione

dotnet add package Omnia.PaymentStripe

Setup rapido

1. Configurazione appsettings.json

{
  "Stripe": {
    "SecretKey": "sk_test_...",
    "PublishableKey": "pk_test_...",
    "WebhookSecret": "whsec_...",
    "DefaultCurrency": "usd"
  }
}

2. Implementa IStripeSettings

public class StripeConfiguration : IStripeSettings
{
    private readonly IConfiguration _config;
    
    public StripeConfiguration(IConfiguration config) => _config = config;
    
    public string GetSecretKey() => _config["Stripe:SecretKey"]!;
    public string GetPublishableKey() => _config["Stripe:PublishableKey"]!;
    public string GetWebhookSecret() => _config["Stripe:WebhookSecret"]!;
    public string GetDefaultCurrency() => _config["Stripe:DefaultCurrency"] ?? "usd";
    public string GetSuccessUrl() => _config["Stripe:SuccessUrl"] ?? "/success";
    public string GetCancelUrl() => _config["Stripe:CancelUrl"] ?? "/cancel";
    public string GetWebhookEndpoint() => _config["Stripe:WebhookEndpoint"] ?? "/api/stripwebhook/hook";
}

3. Registra i servizi in Program.cs

builder.Services.AddSingleton<IStripeSettings, StripeConfiguration>();
    builder.Services.AddScoped<IPaymentRepository, StripePaymentRepository>();
    builder.Services.AddScoped<ICustomerRepository, StripeCustomerRepository>();
builder.Services.AddScoped<IStripeEventHandler, StripeEventHandler>();

// Opzionale: hook Before/After per logica personalizzata
builder.Services.AddScoped<CustomerControllerBefore>();
builder.Services.AddScoped<CustomerControllerAfter>();
builder.Services.AddScoped<PaymentControllerBefore>();
builder.Services.AddScoped<PaymentControllerAfter>();

builder.Services.AddControllers();

Controller inclusi

La libreria fornisce controller REST pronti all'uso:

PaymentController - /api/payment

• POST /create - Crea un PaymentIntent
• POST /confirm/{id} - Conferma un pagamento
• POST /cancel/{id} - Annulla un pagamento
• GET /{id} - Recupera dettagli pagamento
• PUT /{id} - Aggiorna un pagamento
• GET /{id}/status - Verifica stato pagamento
• GET /customer/{customerId} - Lista pagamenti cliente

CustomerController - /api/customer

• POST /create - Crea un cliente Stripe
• PUT /{id} - Aggiorna un cliente
• DELETE /{id} - Cancella un cliente
• GET /{id} - Recupera dettagli cliente
• GET /list - Elenca clienti (paginato)

StripeWebhookController - /api/stripwebhook

• POST /hook - Gestisce webhook Stripe

Uso diretto delle interfacce

Gestione pagamenti

public class MyService
{
    private readonly IPaymentRepository _paymentHandler;

    public async Task<PaymentIntent> CreatePayment(decimal amount)
    {
        return await _paymentHandler.InitiatePaymentAsync(
            amount: (long)(amount * 100), // converti in centesimi
            currency: "eur",
            customerId: "cus_xxx",
            description: "Ordine #123",
            metadata: new Dictionary<string, string> { ["orderId"] = "123" }
        );
    }
}

Gestione clienti

public class MyService
{
    private readonly ICustomerRepository _customerHandler;

    public Customer CreateCustomer(string email, string name)
    {
        return _customerHandler.CreateCustomer(
            email: email,
            name: name,
            metadata: new Dictionary<string, string> { ["source"] = "web" }
        );
    }
}

Hook Before/After

Personalizza la logica prima e dopo ogni operazione estendendo le classi base:

public class MyPaymentHooks : PaymentControllerBefore
{
    public override void BeforeCreatePayment(CreatePaymentRequest request)
    {
        // Validazione custom, logging, ecc.
        Console.WriteLine($"Creating payment for {request.Amount}");
    }
}

public class MyPaymentAfterHooks : PaymentControllerAfter
{
    public override void AfterCreatePayment(CreatePaymentRequest request, PaymentIntent paymentIntent)
    {
        // Salva in database, invia notifica, ecc.
        Console.WriteLine($"Payment created: {paymentIntent.Id}");
    }
}

// Registra in Program.cs
builder.Services.AddScoped<PaymentControllerBefore, MyPaymentHooks>();
builder.Services.AddScoped<PaymentControllerAfter, MyPaymentAfterHooks>();

Gestione eventi webhook

Estendi StripeEventHandler per gestire eventi Stripe:

public class MyEventHandler : StripeEventHandler
{
    public override void SuccessfulPayment(PaymentIntent paymentIntent)
    {
        base.SuccessfulPayment(paymentIntent);
        // Logica custom: aggiorna ordine, invia email, ecc.
        Console.WriteLine($"Payment succeeded: {paymentIntent.Id}");
    }

    public override void FailedPayment(PaymentIntent paymentIntent)
    {
        base.FailedPayment(paymentIntent);
        // Gestisci fallimento pagamento
        Console.WriteLine($"Payment failed: {paymentIntent.Id}");
    }
}

// Registra in Program.cs
builder.Services.AddScoped<IStripeEventHandler, MyEventHandler>();

Configurazione webhook

Configura l'endpoint webhook su Stripe Dashboard → Developers → Webhooks:

• URL: https://tuo-dominio.com/api/stripwebhook/hook
• Eventi: seleziona gli eventi che vuoi ricevere

License

LGPL-3.0-or-later