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