.NET/C# SDK

The official .NET SDK for Unified Commerce Platform. Built with async/await support and ASP.NET Core integration.

Version: 2.2.0 | License: MIT | .NET: 6.0+ | Package: UnifiedCommerce.SDK

Installation

Install via NuGet Package Manager:

dotnet add package UnifiedCommerce.SDK

Or via Package Manager Console:

Install-Package UnifiedCommerce.SDK

Quick Start

using UnifiedCommerce.SDK;

var client = new UnifiedCommerceClient(
    apiKey: Environment.GetEnvironmentVariable("UNIFIED_COMMERCE_API_KEY"),
    environment: CommerceEnvironment.Production
);

// List products
var products = await client.Products.ListAsync(new ProductListParams
{
    Category = "electronics",
    Limit = 10
});

foreach (var product in products.Data)
{
    Console.WriteLine($"{product.Name}: ${product.Price}");
}

// Create an order
var order = await client.Orders.CreateAsync(new OrderCreateParams
{
    Items = new[]
    {
        new OrderItem { ProductId = "123", Quantity = 2 }
    },
    Customer = new Customer
    {
        Email = "customer@example.com"
    }
});

ASP.NET Core Integration

// Program.cs
using UnifiedCommerce.SDK;

var builder = WebApplication.CreateBuilder(args);

// Register UnifiedCommerce client
builder.Services.AddUnifiedCommerce(options =>
{
    options.ApiKey = builder.Configuration["UnifiedCommerce:ApiKey"];
    options.Environment = CommerceEnvironment.Production;
});

// Controllers/ProductsController.cs
using Microsoft.AspNetCore.Mvc;
using UnifiedCommerce.SDK;

[ApiController]
[Route("api/[controller]")]
public class ProductsController : ControllerBase
{
    private readonly UnifiedCommerceClient _client;

    public ProductsController(UnifiedCommerceClient client)
    {
        _client = client;
    }

    [HttpGet]
    public async Task<IActionResult> GetProducts(
        [FromQuery] string category,
        [FromQuery] int limit = 20)
    {
        var products = await _client.Products.ListAsync(new ProductListParams
        {
            Category = category,
            Limit = limit
        });

        return Ok(products);
    }
}

Documentation

Full documentation coming soon. For now, please refer to:

Support

Was this page helpful?