esewa_maui 1.0.3

esewa_maui

Accept eSewa payments in your .NET MAUI app with a single, async call. esewa_maui wraps the official native eSewa SDKs on Android and iOS and exposes one cross-platform C# API.

var result = await EsewaPayment.Current.PayAsync(new EsewaPaymentRequest
{
    ClientId    = "<your-merchant-client-id>",
    SecretKey   = "<your-merchant-secret>",
    Amount      = "100",
    ProductName = "Premium Subscription",
    ProductId   = "TXN-1001",
    CallbackUrl = "https://your-merchant.com/callback",
    Environment = EsewaEnvironment.Production,
});

if (result.IsSuccess)
    await DisplayAlert("Success", result.Message, "OK");

Requirements

Installation

dotnet add package esewa_maui

Or via the Package Manager:

Install-Package esewa_maui

That's it — the native SDKs and their dependencies are included in the package. No manifest edits, no Info.plist changes, no extra native setup required.

Android: make sure your app's minimum SDK is 24 or higher (<SupportedOSPlatformVersion> for the -android target). The eSewa SDK's UI components require it.

Usage

Call it from anywhere with an active screen (a page, a view model command, etc.):

using Plugin.Esewa;

async Task PayAsync()
{
    if (!EsewaPayment.IsSupported)
        return; // Not running on Android or iOS.

    var request = new EsewaPaymentRequest
    {
        ClientId    = "<your-merchant-client-id>",
        SecretKey   = "<your-merchant-secret>",
        Amount      = "500",
        ProductName = "Order #1234",
        ProductId   = "ORD-1234",
        CallbackUrl = "https://your-merchant.com/callback",
        Environment = EsewaEnvironment.Production,
    };

    EsewaPaymentResult result = await EsewaPayment.Current.PayAsync(request);

    switch (result.Status)
    {
        case EsewaPaymentStatus.Success:
            // result.Message and result.Details carry the transaction info.
            break;
        case EsewaPaymentStatus.Cancelled:
            // The user backed out of the payment.
            break;
        case EsewaPaymentStatus.Failure:
            // result.Message explains what went wrong.
            break;
    }
}

PayAsync presents the native eSewa checkout UI and completes when the user finishes, cancels, or an error occurs. It never throws for a normal cancellation or decline — inspect result.Status.

API

EsewaPayment

EsewaPaymentRequest

EsewaPaymentResult

Getting merchant credentials

You need a merchant client id, secret key, and a registered callback URL from eSewa. Sign up and manage these on the official developer portal:

https://developer.esewa.com.np/

Use EsewaEnvironment.Test with sandbox credentials during development, then switch to EsewaEnvironment.Production with your live credentials to go live.

License

Released under the MIT License.

The MIT license covers this plugin. The bundled native eSewa SDKs are the property of eSewa and are subject to eSewa's own licensing terms; see https://developer.esewa.com.np/.