lunipay 0.1.1

The official LuniPay Python SDK.

lunipay

The official LuniPay Python SDK.

pip install lunipay

Quick start

import lunipay

lunipay.api_key = "sk_test_YOUR_KEY"

session = lunipay.CheckoutSession.create(
    amount=5000,
    currency="usd",
    success_url="https://example.com/thanks?session_id={CHECKOUT_SESSION_ID}",
)

print(session["url"])

Resources

Every LuniPay resource is a top-level class on the module:

lunipay.Customer.create(email="[e-mail]", first_name="Ada", last_name="Lovelace")
lunipay.Customer.retrieve("cus_01JRZK...")
lunipay.Customer.modify("cus_01JRZK...", phone="[phone]")
lunipay.Customer.delete("cus_01JRZK...")

for customer in lunipay.Customer.list().auto_paging_iter():
    print(customer["email"])

Supported resources: CheckoutSession, Customer, Invoice, Payment, PaymentLink, WebhookEndpoint, Event.

Webhooks

import lunipay

@app.post("/webhook")
def webhook():
    payload = request.get_data()
    sig = request.headers.get("LuniPay-Signature")
    try:
        event = lunipay.Webhook.construct_event(
            payload=payload,
            sig_header=sig,
            secret="whsec_your_secret",
        )
    except lunipay.error.SignatureVerificationError:
        return "bad signature", 400

    if event["type"] == "checkout.session.completed":
        # fulfill the order
        pass

    return "", 200

Errors

All LuniPay API errors raise subclasses of lunipay.error.LuniPayError:

try:
    lunipay.Customer.create(email="bad", first_name="x", last_name="y")
except lunipay.error.InvalidRequestError as e:
    print(e.code, e.param, str(e))

Subclasses: AuthenticationError, PermissionError, InvalidRequestError, IdempotencyError, RateLimitError, APIError, APIConnectionError.

Idempotency

Pass idempotency_key to any mutating request:

import uuid

key = str(uuid.uuid4())
session = lunipay.CheckoutSession.create(
    amount=5000,
    currency="usd",
    success_url="https://example.com/thanks",
    idempotency_key=key,
)

Full documentation

See lunipay.io/docs/sdks/python.

License

MIT