ALATPay.NET 1.0.0

ALATPay.NET

Simplifying Payments, Empowering Businesses.

ALATPay.NET is a .NET library that simplifies integrating payment functionalities into your application. Designed for merchants and developers, it wraps the powerful ALATPay APIs, enabling seamless interactions with payment services like merchant onboarding, business management, and more.

Table of Contents

• Features
• Installation
• Getting Started
• Usage Examples
  • Merchant Onboarding
  • Fetching Businesses
• Error Handling
• Support

Features

• Merchant Onboarding: Create and manage merchant profiles.
• Business Management: Fetch, update, and track business information.
• Secure Transactions: Built-in mechanisms for secure API calls using keys and tokens.
• Scalable Design: Supports various .NET target frameworks (e.g., .NET 6.0, .NET 7.0, and .NET 8.0).

Installation

Install the ALATPay.NET NuGet package using the Package Manager Console or .NET CLI.

Package Manager Console:

Install-Package ALATPay.NET


# **Usage**

The most important type in this library is the **[ALATPayClient](https://wemabank.visualstudio.com/ALATpay/_git/ALATPay.NET?path=/ALATPay.NET/ALATPayClient.cs)** class. You can create an instance of this class as follows:

```csharp
var testOrLiveSecret = ConfigurationManager.AppSettings["AlatPaySecret"];
var ocpSubscriptionKey = ConfigurationManager.AppSettings["OcpKey"];
var api = new ALATPayClient(testOrLiveSecret, ocpSubscriptionKey);

Please see usage examples (and instructions) below:

Transactions API

To consume the Transactions API, use methods from the ITransactionsApi interface (available via the Transactions property of ALATPayClient, viz:

// Initializing a transaction
var response = api.Transactions.FetchTransaction(new Guid());
if (response.Status)
  // use response.Data
else
  // show response.Message

The ITransactions is defined as follows:

public interface ITransactions
{
        Task<TransactionModel> FetchTransaction(Guid id, CancellationToken token);

        Task<CustomerListModel> ListCustomers(Guid merchantId, Guid businessId, CancellationToken cancellationToken);

        Task<TransactionListModel> ListTransactions(Guid merchantId, Guid userId, Guid businessId, decimal amount, DateTime startAt, DateTime endAt, int paymentMethodId = 0, string status = "All", string currency = "NGN", int page = 1, int offset = 10, CancellationToken cancellationToken = default);
}

Other APIs

Other APIs are implemented in like manner and exposed via the ALATPayClient type as given below:

// Bank Transfer APIs

var request = new GenerateVirtualAccountModel { ... };
var response = api.BanKTransfers.Generate(request);

// etc

Support

For inquiries or support, please contact Horace or the Wema Bank Development Team.

• Email: support@alatpay.com
• Website: ALATPay
• GitHub Issues: Please create an issue in this repository if you encounter any bugs.