plugipay (Python)

Official Python SDK for Plugipay. HMAC-signed REST client; works with Flask, FastAPI, Django, or anything else that speaks Python 3.9+.

Install

pip install plugipay

Quickstart

from plugipay import PlugipayClient

plug = PlugipayClient(key_id="ak_live_...", secret="...")

# Create a customer
customer = plug.customers.create(email="ada@example.com", name="Ada Lovelace")

# Open a checkout session
session = plug.checkout_sessions.create(
    amount=125000,
    currency="IDR",
    methods=["qris", "va", "ewallet"],
    success_url="https://yourapp.com/checkout/success",
    cancel_url="https://yourapp.com/checkout/cancel",
    customer_id=customer["id"],
)
print(session["hostedUrl"])

# Paginate customers
page = plug.customers.list(limit=20)
for c in page.data:
    print(c["id"], c.get("email"))
if page.has_more:
    next_page = plug.customers.list(limit=20, cursor=page.cursor)

The client is a context manager — with PlugipayClient(...) as plug: will close the underlying httpx pool for you.

Resource namespaces

Mirrors @forjio/plugipay-node 1:1:

Webhooks

Plugipay signs every webhook with HMAC-SHA256 over ${timestamp}.${rawBody}. Pass the raw request body (bytes or str), not the parsed JSON.

from flask import Flask, request, abort
from plugipay import verify_webhook, PlugipaySignatureError
import os

app = Flask(__name__)
SECRET = os.environ["PLUGIPAY_WEBHOOK_SECRET"]

@app.post("/webhooks/plugipay")
def plugipay_webhook():
    raw = request.get_data()
    sig = request.headers.get("X-Plugipay-Signature", "")
    try:
        event = verify_webhook(raw, sig, SECRET)
    except PlugipaySignatureError:
        abort(400)
    if event.type == "plugipay.invoice.paid.v1":
        invoice = event.object
        # ...
    return "", 204

Platform keys

If you hold a platform-admin key acting across many merchants, scope each call with X-Plugipay-On-Behalf-Of via for_merchant():

plat = PlugipayClient(key_id="ak_live_platform_...", secret="...")
for_acc = plat.for_merchant("acc_abc123")
for_acc.invoices.list()

Errors

Every failure raises PlugipayError (or a subclass — PlugipayNetworkError, PlugipayTimeoutError, PlugipaySignatureError). The exception carries .status, .code, .message, and (when present) .request_id.

from plugipay import PlugipayClient, PlugipayError

plug = PlugipayClient(key_id="...", secret="...")
try:
    plug.customers.get("cus_does_not_exist")
except PlugipayError as e:
    print(e.status, e.code, e.message, e.request_id)

Source

https://github.com/hachimi-cat/saas-plugipay/tree/master/sdk/python

License

MIT