OrcusPay 1.0.0

OrcusPay .NET SDK

Official .NET client for the OrcusPay API.

Install

dotnet add package OrcusPay

Quick Start

using OrcusPay;

using var client = new OrcusPayClient(
    accessKey: "ak_test_xxxxx",
    secretKey: "sk_test_xxxxx"
);

var session = await client.CreateCheckoutSessionAsync(new
{
    success_url = "https://yoursite.com/success?session={CHECKOUT_SESSION_ID}",
    cancel_url = "https://yoursite.com/cancel",
    line_items = new[]
    {
        new
        {
            quantity = 1,
            price_data = new
            {
                unit_amount = 50000, // 500.00 BDT in paisa
                product_data = new { name = "Premium Plan" },
            },
        }
    },
    currency = "BDT",
    customer = new
    {
        name = "Test Customer",
        email = "customer@example.com",
        phone = "01700000000",
    },
});

// Redirect customer to session.GetProperty("url").GetString()

Retrieve a Checkout Session

var session = await client.GetCheckoutSessionAsync("pay_abc123");
Console.WriteLine(session.GetProperty("payment_status").GetString());

List Payments

var payments = await client.ListPaymentsAsync(limit: 10, status: "SUCCEEDED");

foreach (var payment in payments.GetProperty("payments").EnumerateArray())
{
    Console.WriteLine($"{payment.GetProperty("id")} - {payment.GetProperty("amount")}");
}

Create a Payment Link

var link = await client.CreatePaymentLinkAsync(new
{
    title = "Donation",
    amount = 500,
    is_reusable = true,
    success_url = "https://yoursite.com/thanks",
});

Console.WriteLine(link.GetProperty("url").GetString());

Error Handling

try
{
    var payment = await client.GetPaymentAsync("invalid_id");
}
catch (OrcusPayException ex)
{
    Console.WriteLine(ex.Code);    // "not_found"
    Console.WriteLine(ex.Message); // "Payment not found"
    Console.WriteLine(ex.Status);  // 404
}

Available Methods

• CreateCheckoutSessionAsync(params) — Create a hosted checkout page
• GetCheckoutSessionAsync(id) — Retrieve a checkout session
• ListPaymentsAsync(limit?, cursor?, status?) — List payments with pagination
• GetPaymentAsync(id) — Retrieve a single payment
• ListPaymentLinksAsync(limit?, cursor?) — List payment links
• CreatePaymentLinkAsync(params) — Create a payment link
• GetPaymentLinkAsync(id) — Retrieve a payment link
• StatusAsync() — Check API status

All methods accept an optional CancellationToken.

Custom API URL

For self-hosted OrcusPay instances:

using var client = new OrcusPayClient(
    accessKey: "ak_prod_xxxxx",
    secretKey: "sk_prod_xxxxx",
    apiUrl: "https://your-instance.com/api/v1"
);

Requirements

• .NET 6.0, 7.0, 8.0, or 9.0
• No external dependencies

License

MIT