WePayment.SDK 1.0.2

WePayment.SDK

Official WePayment SDK for .NET.

Features

• Create payment orders via the WePayment API.
• HMAC SHA256 signature generation for requests.
• Webhook verification helpers.
• Dependency Injection integration for HttpClient and options.

Requirements

• .NET 6.0

Install

# NuGet
Install-Package WePayment.SDK

Configure

using WePayment.SDK.Extensions;
using WePayment.SDK.Options;

builder.Services.AddWePayment(options =>
{
    options.BaseUrl = "https://api.wepayment.com";
    options.ApiKey = "your-api-key";
    options.SecretKey = "your-secret-key";
    options.TimeoutSeconds = 30;
});

Create an order

using WePayment.SDK.Interfaces;
using WePayment.SDK.Models.Requests;

public class PaymentsService
{
    private readonly IWePaymentClient _client;

    public PaymentsService(IWePaymentClient client)
    {
        _client = client;
    }

    public Task CreateAsync()
    {
        var request = new CreateOrderV2Request
        {
            Amount = 100.00m,
            Currency = "USD",
            ReferenceId = "order-123",
            ReturnUrl = "https://merchant.example.com/return",
            CallbackUrl = "https://merchant.example.com/webhook",
            Email = "customer@example.com",
            FirstName = "Jane",
            LastName = "Doe",
            UserCountryCode = "US",
            UseUserCountryAsResident = true,
            Description = "Order #123",
            Metadata = new Dictionary<string, string>
            {
                ["cartId"] = "c-001"
            }
        };

        return _client.CreateOrderAsync(request);
    }
}

The SDK automatically sets Nonce and Timestamp, builds the canonical parameter string, and adds the required X-API-KEY and X-Signature headers.

Webhook verification

using WePayment.SDK.Webhooks;

public class WebhooksController
{
    private readonly IWebhookVerifier _verifier;

    public WebhooksController(IWebhookVerifier verifier)
    {
        _verifier = verifier;
    }

    public IActionResult Handle(IDictionary<string, string> headers, string rawBody)
    {
        var result = _verifier.Verify(headers, rawBody);
        if (!result.IsValid)
        {
            return new BadRequestResult();
        }

        var payload = result.Payload;
        return new OkResult();
    }
}

The verifier checks:

• X-API-KEY and X-Signature headers.
• HMAC SHA256 signature over the canonical payload fields.

Responses

CreateOrderV2Response derives from BaseResponse<T> and includes:

• Success
• ErrorCode
• Message
• Data (order details, including PaymentUrl)

Notes

• WePaymentOptions.TimeoutSeconds defaults to 30 seconds.
• PaymentStatus values include Created, Processing, Success, Failed, Canceled, Refunded, Expired, and PartialReceived.