NinePay.SDK.DotNet 1.0.1

9PAY Payment Gateway .NET SDK

Official .NET SDK for integrating 9PAY Payment Gateway.

This package allows you to:

• Create payment requests with strongly typed parameters.
• Query transaction status.
• Verify webhook / callback data.

Requirements

• .NET 8.0

Dependencies (automatically installed):

• Newtonsoft.Json
• DotNetEnv

Installation

Via .NET CLI

dotnet add package NinePay.SDK.DotNet

Via PackageReference

<PackageReference Include="NinePay.SDK.DotNet" Version="1.0.1" />

Environment Configuration

Set the following environment variables (or use a .env file — never commit it):

NINEPAY_MERCHANT_ID=YOUR_MERCHANT_ID
NINEPAY_SECRET_KEY=YOUR_SECRET_KEY
NINEPAY_CHECKSUM_KEY=YOUR_CHECKSUM_KEY
NINEPAY_ENDPOINT=https://your-gateway-endpoint.com

Configuration

using NinePay.SDK.DotNet.Config;

var merchantId = Environment.GetEnvironmentVariable("NINEPAY_MERCHANT_ID");
var secretKey = Environment.GetEnvironmentVariable("NINEPAY_SECRET_KEY");
var checksumKey = Environment.GetEnvironmentVariable("NINEPAY_CHECKSUM_KEY");
var endpoint = Environment.GetEnvironmentVariable("NINEPAY_ENDPOINT");

var config = new NinePayConfig(
    merchantId,
    secretKey,
    checksumKey,
    endpoint
);

Initialization

using NinePay.SDK.DotNet.Gateway;

var gateway = new NinePayGateway(config);

Create Payment

using NinePay.SDK.DotNet.Request;
using NinePay.SDK.DotNet.Response;
using NinePay.SDK.DotNet.Enums;

var request = new CreatePaymentRequest(
    "INV_" + DateTimeOffset.UtcNow.ToUnixTimeMilliseconds(), // Invoice No
    "50000",                                               // Amount
    "Payment for Order 1",                                 // Description
    "https://site.com/callback",                           // Back URL
    "https://site.com/return"                              // Return URL
);

request.WithMethod(PaymentMethod.ATM_CARD)
       .WithClientIp("127.0.0.1")
       .WithCurrency(Currency.VND)
       .WithLang(Language.VI);

ResponseInterface response = gateway.CreatePayment(request);

if (response.IsSuccess())
{
    var redirectUrl = response.GetData()["redirect_url"];
    Console.WriteLine("Redirect user to: " + redirectUrl);
}
else
{
    Console.WriteLine("Error: " + response.GetMessage());
}

Query Transaction

ResponseInterface response = gateway.Inquiry("INV_123456");

if (response.IsSuccess())
{
    Console.WriteLine(response.GetData());
}
else
{
    Console.WriteLine(response.GetMessage());
}

Verify Webhook / Callback

string result = Request.Query["result"];
string checksum = Request.Query["checksum"];

if (gateway.Verify(result, checksum))
{
    string decodedResult = gateway.DecodeResult(result);
    // Process JSON decodedResult...
}

License

MIT License © 9Pay