MagicPay 0.1.0

dotnet add package MagicPay --version 0.1.0
                    
NuGet\Install-Package MagicPay -Version 0.1.0
                    
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="MagicPay" Version="0.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="MagicPay" Version="0.1.0" />
                    
Directory.Packages.props
<PackageReference Include="MagicPay" />
                    
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 MagicPay --version 0.1.0
                    
#r "nuget: MagicPay, 0.1.0"
                    
#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 MagicPay@0.1.0
                    
#: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=MagicPay&version=0.1.0
                    
Install as a Cake Addin
#tool nuget:?package=MagicPay&version=0.1.0
                    
Install as a Cake Tool

MagicPay .NET SDK

.NET 6 / .NET 8 client for the MagicPay API. No external dependencies.

dotnet add package MagicPay      # or reference src/MagicPay/MagicPay.csproj

Quick start

using MagicPay;

using var mp = new MagicPayClient(new MagicPayOptions
{
    ApiKey = "YOUR_API_KEY",
    SecretKey = "YOUR_SECRET_KEY",
    // BaseUrl = MagicPayOptions.ProductionUrl,   // trdev (SandboxUrl) by default
    // AuthVersion = AuthVersion.V1,              // V2 by default
});

// 1) Initialize a 3D Secure payment (anonymous object, Dictionary, JsonNode or your own DTO)
var init = await mp.Payments.Init3dsPaymentAsync(new
{
    price = 100.0, paidPrice = 100.0, installment = 1, currency = "TRY",
    paymentGroup = "PRODUCT", paymentChannel = "Online", clientIp = "192.168.1.1",
    redirectUrl = "https://shop.example.com/magicpay/return",
    callbackUrl = "https://shop.example.com/magicpay/callback",
    bankOrderId = "ORDER-1001",
    card = new { cardHolderName = "Jane Doe", cardNumber = "5406675406675403",
                 expireMonth = "12", expireYear = "2030", cvc = "000" },
    items = new[] { new { name = "Item1", price = 100.0 } },
});

// 2) Complete after the bank redirects back
var done = await mp.Payments.Complete3dsPaymentAsync(new { paymentId = 123 });

// Responses are System.Text.Json.Nodes.JsonNode
var payment = await mp.Payments.RetrievePaymentAsync(123);
string? status = (string?)payment?["data"]?["payment_status"];

// Bearer (merchant-panel) endpoints: log in once, the token is kept on the client
await mp.LoginAsync("panel-user@example.com", "secret-word");
var poses = await mp.Pos.ListPosAsync(new Dictionary<string, object?> { ["isActivePos"] = "ACTIVE" });

// Plugin POS management (V2 only)
var banks = await mp.Plugin.ListBanksAsync();

ASP.NET Core / IHttpClientFactory

builder.Services.AddHttpClient("magicpay");
builder.Services.AddSingleton(sp => new MagicPayClient(
    new MagicPayOptions { ApiKey = cfg["MagicPay:ApiKey"]!, SecretKey = cfg["MagicPay:SecretKey"]! },
    sp.GetRequiredService<IHttpClientFactory>().CreateClient("magicpay")));

The access token is per client instance: with a singleton client, LoginAsync affects all callers.

Errors

try { await mp.LoginAsync("panel-user@example.com", "wrong"); }
catch (MagicPayApiException e) { Console.WriteLine($"{e.StatusCode} {e.ErrorCode} {e.RawBody}"); } // 200 7005
catch (MagicPayConnectionException e) { /* network / timeout */ }

MagicPayApiException is thrown for HTTP ≥ 300 and for a 2xx body with an errors object. The built-in HttpClient never follows redirects; when you pass your own HttpClient, configure its handler with AllowAutoRedirect = false. A login access token is masked (***) in exceptions. Path parameters "", . and .. throw ArgumentException. The options object is copied by the constructor; change the token later with mp.AccessToken.

Options

Property Default
BaseUrl SandboxUrl = https://trdev.magicpay.ai (test) ProductionUrl = https://tr.magicpay.ai with live keys; must be https
AllowInsecure false allow an http:// BaseUrl for non-loopback hosts (tests/proxies only)
AuthVersion V2 V1 is rejected by Plugin endpoints
AccessToken null set by LoginAsync; also mp.AccessToken
Timeout 30 s
SignatureEncoding Hex Base64 only with V1

Every method accepts a CancellationToken. Generic signed call: mp.SendAsync(HttpMethod.Get, "/path", body, query). Signing helpers: MagicPayClient.ComputeSignatureV2(...), MagicPayClient.ComputeSignature(...) (V1).

All methods: ../ENDPOINTS.md. Tests: dotnet run --project tests/MagicPay.Tests.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  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.
  • net6.0

    • No dependencies.
  • 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
0.1.0 81 11/11/2026