codecrack-01/raqm-core

This is a Python library that makes it easier to accept payments through Pakistani payment systems. Instead of writing separate integration code for each payment provider, developers can use a single consistent interface that works the same way regardless of which gateway is being called. The library currently supports two live gateways: EasyPaisa and JazzCash's mobile wallet service. Support for additional banks, including HBL, ABL, and UBL, is listed as planned but not yet implemented. The library is available via pip and requires Python 3.9 or newer. All of the library's payment methods are asynchronous, meaning they can run without blocking other code while waiting for a network response. Responses are returned as typed Python objects validated by Pydantic, so fields are guaranteed to be present and correctly formatted rather than being raw dictionaries that might vary between gateways. When a payment fails at the business level (for example, when the gateway returns a non-success code), the library raises a PaymentError exception with the full gateway response attached, rather than returning the failure silently. The code is organized around three layers per gateway: a client class with the public API, helper files that handle authentication and request signing, and schema files that define what request and response objects look like. This structure is consistent across all supported gateways, and the README includes a step-by-step guide for contributors who want to add support for a new gateway. The project is described as a work in progress. The two implemented gateways are live and usable. If you need to accept payments via EasyPaisa or JazzCash in a Python application, this library offers a faster starting point than building the integration yourself. The full README is longer than what was shown.