python-getpaid-payu

PayU payment processor plugin for the python-getpaid ecosystem.

Provides a fully async HTTP client (PayUClient) and a payment processor (PayUProcessor) implementing the getpaid-core BaseProcessor interface. Communicates with PayU via their REST API v2.1 using OAuth2 authentication.

Features

• Full Payment Lifecycle: Supports prepared, locked, paid, failed, and refunded states.
• Pre-authorization: Reserve funds on customer's card (lock) and capture them later (charge).
• Refunds: Full and partial refund support via API.
• Multiple Currencies: Support for 15 currencies across Europe and beyond.
• Asynchronous: Built with httpx for non-blocking API communication.
• Security: Robust callback signature verification (SHA-256 and MD5).
• Comprehensive API: Wraps every PayU REST API v2.1 endpoint.

Supported Currencies

The following 15 currencies are supported: BGN, CHF, CZK, DKK, EUR, GBP, HRK, HUF, NOK, PLN, RON, RUB, SEK, UAH, USD.

Installation

pip install python-getpaid-payu

Install simulator support only when you want this package to register its local simulator plugin with python-getpaid-simulator:

pip install python-getpaid-payu[simulator]

This extra installs the simulator host and Litestar dependencies, then exposes the payu plugin through the getpaid.simulator.providers entry point.

Simulator Plugin

When python-getpaid-payu[simulator] is installed alongside python-getpaid-simulator, the simulator host auto-discovers the PayU plugin.

Typical local setup:

pip install python-getpaid-simulator python-getpaid-payu[simulator]
getpaid-simulator

The plugin contributes:

• PayU OAuth and order/refund simulator API routes
• PayU authorization UI at /sim/payu/authorize/{order_id}
• PayU-specific webhook signing and state transitions

Useful simulator environment variables:

• SIMULATOR_PAYU_SECOND_KEY
• SIMULATOR_PLUGIN_FAILURE_MODE (warn or strict)

Configuration

To use the PayU backend, register it in your getpaid configuration and provide the following settings:

Example configuration:

GETPAID_BACKENDS = {
    "payu": {
        "pos_id": "300746",
        "second_key": "b6ca15b0d1020e8094d9b5f8d163db54",
        "oauth_id": "300746",
        "oauth_secret": "2ee86a66e5d97e3fadc400c9f19b065d",
        "notify_url": "https://your-domain.com/payments/payu/callback/",
        "continue_url": "https://your-domain.com/payments/payu/success/",
        "sandbox": True,
    }
}

Sandbox Mode

PayU provides a sandbox environment for testing. You can use the example keys provided above for testing in PLN.

Ecosystem

python-getpaid-payu is part of the larger python-getpaid ecosystem. Use it with one of our web framework wrappers:

• django-getpaid
• litestar-getpaid
• fastapi-getpaid

Requirements

• Python 3.12+
• python-getpaid-core >= 3.0.0
• httpx >= 0.27.0

License

MIT

Credits

Created by Dominik Kozaczko.