kapital 0.2.5

A simple client for the Kapital payment gateway.

Kapital Payment Gateway Client

kapital is a Python client for the Kapital Bank payment gateway, designed to simplify the process of creating and managing payment orders. This library provides a straightforward interface to interact with the Kapital Bank API, making it easier to integrate payment functionality into your applications.

Features

• Create payment orders with customizable parameters.
• Supports basic authentication for secure API access.
• Handles JSON payloads and responses seamlessly.

Installation

You can install the kapital package via pip. It's recommended to create a virtual environment for your project.

pip install kapital

Usage

Here’s a quick guide on how to use the kapital client.

Importing the Client

from kapital import Kapital

Initializing the Client

To use the client, initialize it with your credentials. If you don't provide any credentials, default values will be used.

client = Kapital(
    base_url="https://e-commerce.kapitalbank.az/api",
    username="your-username",
    password="your-password"
)

Creating a Payment Order

You can create a payment order by calling the create_order method. Here's an example:

response = client.create_order(
    redirect_url="https://your-redirect-url.com",
    amount=100.00,
    description="Payment for Order #123",
    currency="AZN",
    language="az"
)

print(response)

Response Structure

The create_order method returns a dictionary containing the following keys:

• order_id: The unique identifier for the order.
• password: The password for the order.
• hppUrl: The URL for redirecting the user to complete the payment.
• status: The status of the order.
• cvv2AuthStatus: The CVV2 authentication status.
• secret: A secret value associated with the order.
• redirect_url: The full URL to redirect the user for payment.

Example Response

{
    "order_id": "123456",
    "password": "secret_password",
    "hppUrl": "https://payment-url.com",
    "status": "pending",
    "cvv2AuthStatus": "approved",
    "secret": "order_secret",
    "redirect_url": "https://payment-url.com?id=123456&password=password"
}

Error Handling

The client raises exceptions for various error cases, such as:

• If the response status code is not 200, an Exception will be raised.
• If the response format is invalid, a ValueError will be raised indicating the specific issue.

try:
    response = client.create_order(
        redirect_url="https://your-redirect-url.com",
        amount=100.00,
        description="Payment for Order #123"
    )
except Exception as e:
    print(f"An error occurred: {e}")

Contributing

Contributions are welcome! If you have suggestions for improvements or want to report bugs, please open an issue or submit a pull request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Authors

• Zaman Kazimov
• Fuad Huseynov