pretix-thepay

The Pay payment provider plugin for Pretix. It creates payments via The Pay API, redirects customers to The Pay, and confirms payment status using the return and notification callbacks.

Features

The Pay REST API integration (payment creation, status lookup)
Redirect-based checkout flow
Server-to-server notifications
Refunds (full and partial)
ISO 4217 currency support with correct minor units
Demo mode via Test Mode setting
Multi-language gateway support (Czech, Slovak, English)

Requirements

Pretix >= 2.7.0
Python >= 3.8
requests >= 2.25.0

Installation

Install from PyPI:

pip install pretix-thepay

Or install from source:

pip install -e /path/to/pretix-thepay

Enable the plugin in pretix.cfg:

[pretix]
plugins = pretix_thepay

Restart Pretix after enabling the plugin.

Configuration

In the Pretix control panel, enable The Pay and configure:

Merchant ID: Your The Pay merchant ID
Project ID: Your The Pay project ID
API Password: Your The Pay API password
Language: Default language for the payment gateway
Test Mode: Enable to use the demo environment

Behavior

The customer selects The Pay.
Pretix creates a payment at The Pay and redirects the customer.
The customer completes payment on The Pay.
Pretix confirms the payment by querying The Pay from the return URL and from notifications.

Notes

Test Mode switches the API base URL to the demo environment.
The Pay requires a customer name plus email or phone; Pretix order data is used.

Refunds

Refunds are initiated from Pretix and sent to The Pay. The plugin supports full and partial refunds for payments that support automatic refunds in The Pay.

Troubleshooting

Payment not created

Verify Merchant ID, Project ID, and API Password
Check Pretix logs for The Pay API response details
Ensure the customer has a name and email or phone

Notifications not arriving

Make sure Pretix is reachable from The Pay (public URL)
Confirm your server IP is allowed in The Pay administration

Docker

For Pretix in Docker:

FROM pretix/standalone:stable
USER root
RUN pip3 install pretix-thepay
USER pretixuser
RUN cd /pretix/src && make production

License

Apache Software License 2.0

References

Metadata

Release files for pretix-thepay 9.0.24

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pretix-thepay 9.0.24
File	Size	Uploaded
pretix_thepay-9.0.24.tar.gz	16.1 kB	Oct 11, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pretix-thepay 9.0.24
File	Interpreter	ABI	Platform	Reset
pretix_thepay-9.0.24-py3-none-any.whl 15.4 kB Oct 11, 2026	Python 3	none	any	Details

Total release size: 31.5 kB

Release files / pretix_thepay-9.0.24.tar.gz

Download URL	pretix_thepay-9.0.24.tar.gz
Size	16.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`80a188f756c3479f16d27c6a50a423e38cba3919f853036c23a937acfcab7f79`
BLAKE2b-256 checksum How to use checksums	`8a1abd727b125b73d5191a60ad06fd397603245d1746044598646a0170a49512`
Upload date	Oct 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / pretix_thepay-9.0.24-py3-none-any.whl

Download URL	pretix_thepay-9.0.24-py3-none-any.whl
Size	15.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`db8360581d7dfcbac8caf172d4c6c48fe1843f225b921cf5a8c7ff179f7aaef1`
BLAKE2b-256 checksum How to use checksums	`38eab64803aae9f2c018c136b7deaede5f3986c6da6d8652c8fa88cfc9eafb74`
Upload date	Oct 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`