Migrate from Self-Hosted Сервер BTCPay to Managed Non-Custodial XPayr

Why Engineering & Finance Teams Switch Away From Сервер BTCPay

Field-by-Field API & Webhook Mapping (Сервер BTCPay → XPayr v1)

Keep your existing database order schema intact — map these 6 fields to cut over cleanly.

import hmac
import hashlib
from fastapi import FastAPI, Request, HTTPException

app = FastAPI()

def verify_xpayr_or_btcpay_hmac(raw_body: bytes, sig_header: str, secret: str) -> bool:
    """Identical SHA-256 HMAC verification logic as BTCPay-Sig Greenfield webhooks."""
    clean_sig = sig_header.replace("sha256=", "").strip()
    expected = hmac.new(secret.encode("utf-8"), raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, clean_sig)

@app.post("/webhooks/xpayr")
async def xpayr_webhook(request: Request):
    raw = await request.body()
    sig = request.headers.get("X-XPayr-Signature", "")
    if not verify_xpayr_or_btcpay_hmac(raw, sig, "whsec_your_secret"):
        raise HTTPException(status_code=401, detail="Invalid signature")
    event = await request.json()
    if event.get("event") in ("payment.completed", "payment.underpaid_accepted"):
        # Same fulfillment handler previously triggered by BTCPay InvoiceSettled
        pass
    return {"ok": True}

4-Step Zero-Downtime Canary Cutover Checklist

Часто задаваемые вопросы — Switching From Сервер BTCPay

Explore All 10 инструкций по миграции с других шлюзов