CibPay.Sdk 1.0.0-preview.3

This is a prerelease version of CibPay.Sdk.
dotnet add package CibPay.Sdk --version 1.0.0-preview.3
                    
NuGet\Install-Package CibPay.Sdk -Version 1.0.0-preview.3
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="CibPay.Sdk" Version="1.0.0-preview.3" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="CibPay.Sdk" Version="1.0.0-preview.3" />
                    
Directory.Packages.props
<PackageReference Include="CibPay.Sdk" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add CibPay.Sdk --version 1.0.0-preview.3
                    
#r "nuget: CibPay.Sdk, 1.0.0-preview.3"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package CibPay.Sdk@1.0.0-preview.3
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=CibPay.Sdk&version=1.0.0-preview.3&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=CibPay.Sdk&version=1.0.0-preview.3&prerelease
                    
Install as a Cake Tool

Cibpay .NET SDK Github readme banner

⚠️ PREVIEW VERSION

This SDK is currently in preview. Features and APIs may change in future releases. Use in production environments at your own discretion.


CibPay .NET SDK

A comprehensive .NET library for integrating with CibPay's payment processing API. This official SDK provides a simple, secure, and efficient way to implement payment functionality in your .NET applications, specifically designed for the Azerbaijani local banking system.

⭐ We appreciate your star, it helps!

GitHub Repo stars

Key Features

  • 📦 Single Package - Everything included in one NuGet package, no additional dependencies
  • 🔒 Secure Authentication - Certificate-based authentication with basic auth support
  • 💳 Order Management - Create and retrieve payment orders with comprehensive status tracking
  • 🏗️ Easy Integration - Simple client setup with dependency injection support
  • ⚡ Async/Await Support - Modern async programming patterns throughout
  • 🛡️ Type Safety - Strongly-typed models and comprehensive error handling
  • 📱 Multi-Platform - Compatible with console apps, ASP.NET Core, and other .NET platforms

Quick Installation

CibPay.Sdk

dotnet add package CibPay.Sdk

Quick Example

using CibPay.Http.Configuration;
using CibPay.Sdk;
using CibPaySdk.Core.Models;

// Configure the SDK
var options = new SdkOptions
{
    Username = "your-username",
    Password = "your-password", 
    BaseUrl = "https://api-preprod.cibpay.co",
    CertificatePath = "Certificate/api-cibpay.p12",
    CertificatePassword = "your-cert-password",
    ReturnUrl = "https://yoursite.com/payment/return"
};

// Create client
var client = CibPayClientFactory.Create(options);

// Create an order
var order = await client.Orders.CreateAsync(new CreateOrderRequest 
{ 
    Amount = 100.50m 
});

Console.WriteLine($"Order created: {order.Data.Id}");

Supported Operations

Operation Status Description
Create Order ✅ Available Create new payment orders
Get Order ✅ Available Retrieve order details with expansions
Refunds 🔄 Coming Soon Process refunds and reversals
Webhooks 🔄 Coming Soon Handle payment notifications

Support & Contributing

💖 Premium Sponsor and Support: @Cibpay

For issues, contributions, or feedback:

Maintainer: Ali Aliyev - LinkedIn

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net8.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.0-preview.3 126 9/3/2025
1.0.0-preview.2 115 9/1/2025
1.0.0-preview.1 114 9/1/2025

Preview release of CibPay .NET SDK featuring:
     - ReturnUrl, Force3D and other options no longer required in SdkOptions, you can pass it
     directly when creating in order
     - Several documentation enhancement both in inline code and for Error handling and Requests.