Python SDK

import os
from kkhay import KkhayClient
 
# Initialize client with your API key
kkhay = KkhayClient(
    api_key=os.environ.get("KKHAY_API_KEY", "kkhay_live_..."),
    timeout=10,  # Request timeout in seconds (default: 10)
)

# Create an invoice for $50.00 USD
invoice = kkhay.create_invoice(
    amount=50.00,
    currency="USD",
    pay_network="bsc",       # Optional pre-selection (bsc, base, sol, btc...)
    pay_token="USDT",        # Optional token (USDT, USDC, BTC, ETH...)
    order_id="ORDER-5011",   # Your internal order reference
    title="Annual Pro Membership",
    customer_email="developer@example.com",
    redirect_url="https://yourshop.com/checkout/success",
    cancel_url="https://yourshop.com/cart",
)
 
print(f"Invoice ID: {invoice.id}")
print(f"Checkout URL: {invoice.hosted_url}")
# Redirect customer to: invoice.hosted_url

from fastapi import FastAPI, Request, HTTPException, Header
import os
from kkhay import parse_webhook_event, KkhaySignatureVerificationError
 
app = FastAPI()
WEBHOOK_SECRET = os.environ["KKHAY_WEBHOOK_SECRET"]
 
@app.post("/api/webhooks/kkhay")
async def handle_kkhay_webhook(
    request: Request,
    x_kkhay_signature: str = Header(None)
):
    raw_body = await request.body()
    
    try:
        event = parse_webhook_event(
            payload=raw_body.decode("utf-8"),
            signature=x_kkhay_signature,
            secret=WEBHOOK_SECRET,
        )
    except KkhaySignatureVerificationError:
        raise HTTPException(status_code=400, detail="Invalid signature")
 
    if event.event in ("payment.finished", "payment.paid"):
        print(f"Order {event.order_id} fulfilled on-chain: {event.tx_hash}")
        # Fulfill customer order in database
        
    return {"status": "ok"}