epoint-python-sdk

Typed Python client for the Epoint payment gateway. Sync and async, every endpoint, signed callbacks, and retry rules built so a payment is never sent twice.

pip install epoint-python-sdk

Pay

from epoint_sdk import Epoint

with Epoint("i000000001", "PRIVATE_KEY", success_url="https://shop.az/ok", error_url="https://shop.az/fail") as ep:
    checkout = ep.payments.create("19.90", "ORDER-1042", description="Pro plan")
    redirect(checkout.redirect_url)

Confirm

tx = ep.verify_callback(request.POST)
if tx.paid:
    fulfil(tx.order_id, tx.amount, tx.transaction)

Never trust the redirect alone. Use the signed callback, or ask the gateway:

ep.payments.status(checkout.transaction).paid

Apple Pay and Google Pay

widget = ep.widgets.create("19.90", "ORDER-1043", "Pro plan")

<iframe src="{{ widget.widget_url }}" allow="payment" title="Apple Pay / Google Pay"></iframe>
<script>
addEventListener("message", (e) => {
  if (e.origin !== "{{ widget.origin }}") return;
  fetch("/orders/1043/check/", { method: "POST" });
});
</script>

The page needs Permissions-Policy: payment=(self "https://epoint.az"). The postMessage is a hint only: WidgetMessage.from_event(data) reads it, then confirm on the server with ep.payments.status(widget.transaction) or the signed callback. Epoint enables token payments per merchant. ep.widgets.split(...) is the split variant.

Safety

Reuse the same order_id when you retry. Epoint refuses a used one, so a double click or a crash can not charge twice. Amounts are Decimal end to end, and signatures are compared in constant time.

Endpoints

AsyncEpoint has the same methods, awaited.

Config

Pass values in code, or set EPOINT_PUBLIC_KEY, EPOINT_PRIVATE_KEY, EPOINT_SUCCESS_URL, EPOINT_ERROR_URL, EPOINT_LANGUAGE, EPOINT_TIMEOUT, EPOINT_MAX_RETRIES, or put them in epoint.toml. Every path is a setting (EPOINT_ENDPOINTS__PAYMENT=...) and base_url can point at a sandbox such as epoint-sandbox. Messages live in messages.yaml and can be replaced with messages.use(...).

Develop

pip install -e ".[dev]" && pytest && ruff check . && mypy src

Links

• Source code: github.com/qiyascc/epoint-python-sdk
• PyPI: pypi.org/project/epoint-python-sdk
• Project page: theqiyas.cc/projects/epoint-python-sdk
• Author: Qiyas Sadıqov, more projects at theqiyas.cc

License

MIT