Synetec.Payment.Gateway 3.0.1

Synetec.Payment.Gateway

A .NET 8 library for integrating Stripe payment processing into your applications, with support for both hosted and embedded checkout experiences. Optimized for Blazor and ASP.NET Core projects.

✨ Features

• Stripe Hosted Checkout (redirect-based)
• Stripe Embedded Checkout (Stripe Elements)
• Product and price retrieval from Stripe Portal
• Secure, validated Stripe webhook endpoint

📦 Installation

Add the NuGet package to your project:

dotnet add package Synetec.Payment.Gateway

🚀 Usage

1. Register Endpoints

In your Program.cs (Blazor or ASP.NET Core):

// Register the Payment Gateway context and services
var builder = WebApplication.CreateBuilder(args);
ConfigurationManager configuration = builder.Configuration;
builder.Services.AddPaymentGateway(configuration);

// Register Synetec.Payment.Gateway endpoints depending on your needs
var app = builder.Build();
app.AddStripeProductEndpoints();
app.AddStripeHostedCheckoutEndpoints();
app.AddStripeEmbeddedCheckoutEndpoints();
app.AddStripeWebhook();

app.Run();

2. Configuration

Add your Stripe settings to appsettings.json:

{
  "PaymentGateway": {
    "ConnectionString": "REDACTED",
    "RedirectBaseUrl": "REDACTED",
    "SuccessPath": "REDACTED",
    "CancelPath": "REDACTED",
    "Stripe": {
      "SecretKey": "REDACTED",
      "PublishableKey": "REDACTED",
      "WebhookSecret": "REDACTED"
    }
  }
}

3. Endpoints

Get Products

• GET /api/v{version}/stripe/product
• Returns a list of Stripe products and prices.

Create Hosted Checkout Session

• POST /api/v{version}/stripe/checkout
• Request body: CheckoutRequest
• Returns a Stripe Checkout session URL.

Create Embedded Payment Intent

• POST /api/v{version}/stripe/initialize-payment
• Request body: PaymentIntentRequest
• Returns a Stripe PaymentIntent client secret.

Stripe Webhook

• POST /api/v{version}/stripe/webhook
• Receives Stripe webhook events for payment updates and notifications.

4. Example: Creating a Checkout Session

POST /api/v1/stripe/checkout
Content-Type: application/json

{
  "idempotencyKey": "b1a7c8e2-1234-4c9a-8e2b-1234567890ab",
  "items": [
    { "priceId": "price_1N...", "quantity": 1 }
  ],
  "paymentMethodTypes": ["card"],
  "consumerReference": "user@example.com",
  "additionalMetadata": { "orderId": "12345" }
}

5. Webhook Security

Set your Stripe webhook secret in configuration. The webhook endpoint validates incoming requests using the Stripe-Signature header.

🧩 Getting Started Example

// Example: Minimal API integration
var builder = WebApplication.CreateBuilder(args);
builder.Services.Configure<StripeOptions>(builder.Configuration.GetSection("Stripe"));

var app = builder.Build();
app.AddStripeHostedCheckoutEndpoints();
app.Run();

🛠️ Requirements

• .NET 8.0 or later
• Stripe account and API keys

🤝 Contributing

Contributions are welcome!

1. Fork the repository
2. Create a feature branch (git checkout -b feature/new-feature)
3. Run tests with dotnet test
4. Submit a pull request

📜 License

© 2025 Synetec Limited. All rights reserved.