Py
Python SDK
Django, Flask ya da FastAPI projelerinize birkaç satırda kripto ödeme ekleyen resmi Python kütüphanesi.
Kurulum
pip ile (önerilen):
pip install mercanpay
İnternete kapalı sunucular için .whl dosyasını indirip pip install mercanpay-1.0.0-py3-none-any.whl ile kurabilirsiniz.
Fatura oluşturma
from mercanpay import MercanPay
zp = MercanPay("https://mercanpay.com", "mp_...") # panelden aldığınız API anahtarı
# USD fiyatlı fatura: müşteri coini ödeme sayfasında seçer
inv = zp.create_invoice(price_usd="25", order_id="siparis-1001", callback_url="https://magazaniz.com/hook")
print(inv["payment_url"])
Webhook doğrulama (Flask)
from mercanpay import verify_webhook
@app.post("/hook")
def hook():
if not verify_webhook(SECRET, request.get_data(), request.headers.get("X-MercanPay-Signature", "")):
abort(401)
event = request.get_json()
if event["type"] == "invoice.paid":
... # siparişi ödendi yapın
return "ok"
Çekim
w = zp.create_withdrawal("USDT", "10", "T...", idempotency_key="cekim-123")
print(w["status"]) # queued -> processing -> completed
Hatalar MercanPayError olarak gelir (.status, .code, .message). Tüm uç noktalar için dokümantasyona bakın.