MakePay documentation

MakePay Digital Products documentation

Configure, operate, secure, and troubleshoot a complete self-hosted digital commerce workflow on BTCPay Server.

Getting startedProduct overviewUnderstand the storefront, protected delivery, customer library, and license-management capabilities in one self-hosted BTCPay plugin.Requirements and planningCheck BTCPay, email, storage, network, and operational prerequisites before installing Digital Products.InstallationInstall the signed plugin package, restart BTCPay Server, verify the store integration, and create the initial storefront.Upgrades and migrationSafely upgrade Digital Products, migrate from standalone plugins, preserve storage, and validate customer fulfillment.
Catalog and storefrontProduct formatsChoose the right format and delivery mode for files, PDFs, audio, video, photos, art, and software licenses.Product editorConfigure listing copy, media, pricing, protected content, previews, publication, and delivery policy in the BTCPay-native editor.Previews and media playbackBuild safe public samples and reliable buyer playback for PDF, audio, video, photo, and art products.Storage and protected deliveryConfigure local, private S3-compatible, or authenticated custom-origin files and understand delivery tokens, limits, ranges, and revocation.Storefront and live editorBuild a professional responsive shop with editable identity, slides, categories, navigation, typography, logo, and favicon.
Checkout and customersCart and BTCPay checkoutUnderstand background cart updates, server-side invoice creation, BTCPay's JavaScript modal, payment polling, and fulfillment transitions.Passwordless customer accessConfigure one-time email codes, encrypted sessions, purchase history, protected media, and customer recovery without passwords.Order details and fulfillment operationsUse the responsive admin order workspace to investigate invoices, customers, line snapshots, protected delivery usage, email, and licenses.
Licenses and integrationsLicense products and key managementDefine serial formats, activation and validity policies, issue keys, fulfill paid orders, and review lifecycle state.License verification APIIntegrate verify, activate, deactivate, and heartbeat endpoints with custom headers, HMAC signatures, nonces, and replay protection.GTM and Google AnalyticsConfigure consent-aware GTM or direct GA4 commerce events without leaking buyer email, keys, tokens, or capability URLs.
Operations and securityCustom domainsRoute a branded hostname to the complete Digital Products surface using BTCPay additional hosts, app identity, and domain mapping.Security modelReview trust boundaries, protected data, token and API controls, SSRF defenses, privacy, and operational hardening.TroubleshootingDiagnose installation, storefront, editor, checkout, email, storage, playback, analytics, license API, and custom-domain failures.