See the stars

MicroPatron Specification

Home / MicroPatron / MicroPatron Specification

MicroPatron

Support Without the Guesswork


Overview

MicroPatron is an open-source tipping and digital patronage specification designed to make it easier for creators, publishers, developers, educators, independent professionals, and organizations to receive voluntary financial support. The platform enables recipients to accept contributions through standalone tipping pages or embedded interfaces integrated into websites, applications, articles, posts, digital publications, and individual projects.

MicroPatron supports contributions in multiple fiat currencies and cryptocurrencies, allowing contributors to select their preferred denomination and available payment method. The system maintains the original transaction details while recording the equivalent value in a recipient-designated accounting currency using timestamped exchange and market valuations. This creates a consistent financial record without losing the underlying transaction information.

The platform combines payment processing, financial recordkeeping, currency conversion, and AI-assisted accounting and tax intelligence. It organizes contribution activity, tracks transaction fees and settlement details, identifies potential income classifications, estimates applicable taxes, and generates supporting financial and tax-preparation documentation. Recipients can evaluate a scenario in which tips represent their only income or enter additional income, deductions, credits, and other financial information for more comprehensive projections.

MicroPatron is designed around modularity, transparency, privacy, and recipient control. Its architecture supports independent operation, third-party integrations, customizable contribution experiences, and self-hosted deployments. AI-assisted features provide classification, research, explanations, and financial insights while deterministic calculation systems maintain the accuracy and reproducibility of monetary conversions, accounting records, and tax estimates.


Core Modules

Universal Tipping Module

  • Provide a universal tipping system for accepting voluntary financial contributions.
  • Support standalone tipping pages and embedded contribution interfaces.
  • Allow recipients to accept contributions at the account, organization, website, page, post, article, publication, or project level.
  • Support one-time contributions and optional recurring support.
  • Allow recipients to configure suggested amounts, minimum contributions, maximum contributions, and custom contribution amounts.
  • Support contributor-selected denominations and available payment methods.
  • Provide configurable contributor identification and anonymous contribution options where supported by applicable payment services and legal requirements.
  • Allow optional contributor messages and acknowledgments.
  • Associate each contribution with a unique recipient and originating content or project reference.
  • Provide customizable contribution buttons, widgets, overlays, and standalone interfaces.
  • Support responsive layouts and accessible contribution experiences.
  • Allow recipients to configure contribution descriptions, suggested amounts, currencies, and display preferences.
  • Clearly distinguish voluntary contributions from mandatory fees, service charges, and other payment obligations.

Embeddable Integration Module

  • Allow MicroPatron to operate independently or integrate into existing websites, applications, and publishing platforms.
  • Provide lightweight embedding options for websites, articles, blog posts, social publications, and individual projects.
  • Support configurable JavaScript embedding and reusable contribution components.
  • Allow recipients to associate contribution interfaces with specific pages, posts, articles, products, publications, and projects.
  • Support multiple websites and domains under one recipient account.
  • Provide integration options for content management systems and publishing platforms.
  • Support customizable appearance, placement, contribution messaging, and suggested amounts.
  • Provide secure origin verification and domain-level integration controls.
  • Maintain contextual references identifying the content or project associated with each contribution.
  • Support standalone contribution links for sharing through email, messaging, social media, and other communication channels.
  • Provide integration interfaces that minimize unnecessary dependencies on external platforms.

Universal Currency Module

  • Support multiple fiat currencies and cryptocurrencies as contribution denominations.
  • Allow contributors to select from the currencies and payment methods accepted by each recipient.
  • Allow recipients to designate one or more accounting currencies.
  • Automatically calculate the equivalent value of contributions in the recipient’s designated accounting currency.
  • Preserve the original transaction amount, currency, exchange rate, converted value, valuation timestamp, and applicable data source.
  • Support historical exchange rates and cryptocurrency market valuations.
  • Maintain sufficient precision for currencies and digital assets with different decimal conventions.
  • Track currency conversion spreads, exchange fees, and payment processing costs separately.
  • Distinguish original contribution amounts, converted accounting values, gross receipts, and net proceeds.
  • Support multiple accounting currencies and historical reporting.
  • Preserve historical valuation records so that previously recorded transactions are not silently recalculated using current exchange rates.
  • Identify unavailable, delayed, estimated, or potentially unreliable valuation data.
  • Use deterministic conversion calculations and documented valuation sources rather than allowing generative AI to invent exchange rates or market prices.

Cryptocurrency Management Module

  • Support cryptocurrency contributions through compatible digital wallets and blockchain networks.
  • Prioritize noncustodial integrations that allow recipients to retain control of their digital assets.
  • Support multiple blockchain networks, tokens, and supported digital asset standards.
  • Record wallet addresses, transaction hashes, network identifiers, token identifiers, transaction timestamps, and confirmation details.
  • Verify blockchain transactions and monitor confirmation and settlement status.
  • Associate incoming transactions with the appropriate recipient and contribution reference.
  • Record the fair market value of cryptocurrency at the applicable recognition time using documented valuation sources.
  • Preserve the original cryptocurrency amount and its equivalent accounting currency value.
  • Track network fees, conversion fees, transfers, and other transaction costs separately.
  • Distinguish cryptocurrency received as contribution income from subsequent asset transfers, exchanges, sales, and other dispositions.
  • Maintain separate records for the initial contribution valuation and subsequent gains or losses resulting from changes in asset value.
  • Support wallet ownership verification where required.
  • Identify incomplete, unconfirmed, duplicated, or potentially suspicious transactions.
  • Provide historical transaction and valuation records for accounting and tax preparation.

Payment Processing Module

  • Support multiple payment processors and financial service providers through independent integration interfaces.
  • Provide payment options for supported cards, bank transfers, digital wallets, and other available payment methods.
  • Support processor-authorized payment transactions, settlement notifications, refunds, reversals, disputes, and chargebacks.
  • Track payment authorization, processing, settlement, and failure statuses.
  • Record transaction identifiers, processing dates, settlement dates, and applicable provider references.
  • Track processing fees, currency conversion fees, network charges, and other transaction costs.
  • Calculate gross contributions and net proceeds after applicable fees and adjustments.
  • Support reconciliation between MicroPatron records and external payment provider statements.
  • Provide secure payment handoffs and avoid unnecessary storage of sensitive payment credentials.
  • Allow recipients to configure and manage their own payment integrations.
  • Support multiple payment providers and payment accounts for individual recipients.
  • Maintain a clear distinction between payment processing services and MicroPatron accounting functionality.
  • Identify integrations that may require additional regulatory, contractual, or compliance obligations based on their implementation.

Financial Ledger Module

  • Maintain a centralized financial ledger for all contribution activity.
  • Record original contribution amounts, currencies, payment methods, transaction dates, settlement dates, and recipient information.
  • Preserve the original transaction details alongside normalized accounting values.
  • Record exchange rates, valuation timestamps, valuation sources, and conversion calculations.
  • Track gross contributions, payment processing fees, network fees, refunds, reversals, chargebacks, and net proceeds.
  • Maintain separate accounting records for cryptocurrency contributions and subsequent digital asset activity.
  • Associate transactions with their originating websites, pages, posts, articles, publications, and projects.
  • Support historical transaction retrieval and date-based reporting.
  • Maintain an auditable transaction history.
  • Preserve original records and use linked correction or adjustment entries rather than silently overwriting financial history.
  • Support manual transaction entries with source descriptions and appropriate audit information.
  • Identify duplicate, incomplete, inconsistent, or unreconciled transactions.
  • Provide reconciliation tools for external payment providers and financial accounts.
  • Support financial exports in commonly used accounting and data formats.
  • Maintain transaction provenance and calculation details for independent review.

AI Accounting and Classification Module

  • Provide AI-assisted organization and classification of contribution records.
  • Identify potential distinctions between employee tips, independent contractor receipts, business income, gifts, other income, and other relevant financial categories.
  • Distinguish voluntary tips from mandatory service charges, automatic gratuities, and other required payments.
  • Consider the recipient’s employment relationship, occupation, services, payment arrangement, and other relevant circumstances when suggesting classifications.
  • Identify information that may affect the appropriate tax treatment of a contribution.
  • Provide explanations for suggested classifications and identify the information supporting each recommendation.
  • Flag uncertain classifications for recipient review.
  • Detect missing transaction information, inconsistent records, unusual payment activity, and potential accounting discrepancies.
  • Assist with organizing transaction histories and supporting documentation.
  • Allow recipients to review, approve, correct, or reject AI-generated classifications.
  • Preserve classification decisions and subsequent corrections in an auditable history.
  • Avoid treating an AI-generated classification as a binding legal or tax determination.
  • Separate AI-generated insights from deterministic accounting and tax calculations.

IRS Tax Intelligence Module

  • Provide federal income tax and self-employment tax estimation for recipients receiving tips and other contributions.
  • Support scenarios in which tips represent the recipient’s only income.
  • Allow recipients to enter additional employment income, business income, investment income, deductions, credits, and other relevant financial information.
  • Support applicable filing statuses and tax-year-specific deduction and credit calculations.
  • Distinguish employee tip income from independent contractor and business receipts.
  • Evaluate potential eligibility for the federal qualified tip income deduction under applicable tax-year requirements.
  • Account for applicable occupation requirements, qualified tip definitions, reporting requirements, deduction limits, income phaseouts, and other statutory conditions.
  • Avoid assuming that every payment described as a tip automatically qualifies for a federal tip deduction.
  • Estimate applicable federal income tax, Social Security tax, Medicare tax, and self-employment tax.
  • Distinguish income tax deductions from payroll tax and self-employment tax obligations.
  • Support estimates of quarterly federal tax payments where applicable.
  • Provide estimated after-tax income and net proceeds.
  • Explain the assumptions, classifications, tax rules, and calculations used in each estimate.
  • Identify circumstances requiring additional information or professional tax review.
  • Maintain separate calculations for contribution income, payment expenses, cryptocurrency valuations, and subsequent digital asset gains or losses.
  • Support historical tax years and current-year projections.
  • Use deterministic calculation rules and versioned tax tables rather than generative AI for final numerical tax calculations.

IRS Documentation and Reporting Module

  • Generate organized financial summaries and supporting tax-preparation records.
  • Provide annual and periodic contribution reports.
  • Generate employee tip summaries and supporting records for applicable tip reporting requirements.
  • Provide independent contractor and business income summaries.
  • Generate Schedule C supporting summaries and Schedule SE calculation worksheets where applicable.
  • Provide estimated tax worksheets and supporting information for Form 1040-ES.
  • Generate qualified tip deduction calculation summaries and supporting records where applicable.
  • Separate gross contributions, payment fees, expenses, refunds, adjustments, and net proceeds.
  • Include original currency amounts, accounting currency values, exchange rates, valuation timestamps, and cryptocurrency transaction details.
  • Maintain supporting documentation for classification decisions and tax calculations.
  • Provide downloadable records for recipients and their tax professionals.
  • Support CSV, JSON, PDF, and other appropriate reporting formats.
  • Preserve historical reports and the tax-year rules used to generate them.
  • Clearly distinguish supporting worksheets and tax-preparation documents from official IRS forms, submissions, and filings.
  • Identify estimates and unverified information so they are not mistaken for confirmed tax liabilities or completed filings.

Tax Law and Regulatory Research Module

  • Maintain a research library covering applicable IRS publications, forms, instructions, regulations, and federal tax guidance.
  • Monitor changes to federal tax laws affecting tips, gratuities, digital contributions, self-employment income, and cryptocurrency.
  • Track changes to qualified tip deduction eligibility, occupation requirements, income thresholds, deduction limits, and phaseouts.
  • Monitor applicable reporting requirements for employees, independent contractors, and businesses.
  • Maintain historical tax rules and identify the tax years to which each rule applies.
  • Provide source references for tax explanations and calculations.
  • Identify outdated, conflicting, incomplete, or superseded guidance.
  • Explain relevant changes and their potential effects on recipients.
  • Support review and validation of updated tax rules before they are used in calculations.
  • Maintain a distinction between proposed legislation, enacted law, published administrative guidance, and established tax requirements.
  • Provide optional research into state, local, and international tax requirements through jurisdiction-specific integrations.
  • Avoid presenting AI-generated legal interpretations as authoritative tax guidance.

Tax Scenario and Projection Module

  • Allow recipients to create and compare multiple tax and income scenarios.
  • Provide a tips-only income scenario.
  • Support scenarios combining tips with employment, independent contractor, business, investment, and other income.
  • Allow adjustments for filing status, deductions, credits, and other relevant tax information.
  • Estimate federal income tax, payroll tax, self-employment tax, and applicable deductions.
  • Compare gross contribution income, payment expenses, net receipts, estimated taxes, and projected after-tax income.
  • Estimate potential quarterly tax obligations.
  • Evaluate the impact of qualifying tip deductions and other applicable tax provisions.
  • Allow recipients to modify assumptions and compare the resulting projections.
  • Preserve historical scenarios and their underlying assumptions.
  • Identify potential underpayment risks and situations requiring professional review.
  • Clearly distinguish estimates from actual tax liabilities.

Recipient Account and Identity Module

  • Support individual, professional, business, nonprofit, and organizational recipient accounts.
  • Allow recipients to manage multiple websites, projects, publications, and contribution profiles.
  • Separate public display identities from private legal, tax, and financial information.
  • Support public names, pseudonyms, organization names, and customizable recipient profiles.
  • Provide secure account authentication and configurable access permissions.
  • Allow recipients to manage payment integrations, supported currencies, wallets, and accounting preferences.
  • Support multiple authorized users with role-based access controls.
  • Provide account-level privacy and data management settings.
  • Allow recipients to export their financial records and account information.
  • Maintain separation between contributor-facing information and confidential recipient records.

Contributor Experience Module

  • Provide a simple and accessible contribution experience.
  • Allow contributors to choose their preferred supported currency and payment method.
  • Display recipient-configured suggested contribution amounts and custom amount options.
  • Provide transparent information about payment methods and applicable processing fees where available.
  • Support optional contributor identification and anonymous contributions where permitted.
  • Allow optional messages and contributor acknowledgments.
  • Support recurring voluntary contributions where available.
  • Provide localized currency and language display options.
  • Minimize unnecessary account registration and personal information collection.
  • Clearly identify the recipient and the content, publication, or project being supported.
  • Provide confirmation of successful contributions and appropriate transaction references.
  • Avoid misleading contribution prompts, undisclosed charges, and deceptive payment experiences.

Dashboard and Analytics Module

  • Provide recipients with a centralized dashboard for contribution activity.
  • Display contribution totals, transaction counts, gross receipts, processing costs, and net proceeds.
  • Support daily, weekly, monthly, quarterly, and annual reporting.
  • Break down contributions by website, page, post, article, publication, project, currency, and payment method.
  • Display fiat and cryptocurrency contribution activity.
  • Provide historical currency conversion and valuation summaries.
  • Display payment settlement, refund, reversal, and chargeback activity.
  • Present estimated tax obligations and projected after-tax income.
  • Provide contribution trends and historical comparisons.
  • Identify high-performing content and contribution sources.
  • Allow recipients to filter, search, and export financial activity.
  • Clearly distinguish confirmed financial records from estimates and AI-generated insights.

Security and Privacy Module

  • Protect recipient accounts, contributor information, transaction records, and financial data.
  • Support encryption for sensitive information in storage and during transmission.
  • Provide role-based permissions and secure authentication.
  • Protect payment integration credentials and sensitive account information.
  • Support secure API authentication and domain-level embedding controls.
  • Separate public profile information from private identity, tax, and financial records.
  • Maintain security logs and auditable access histories.
  • Provide configurable data retention and deletion policies subject to applicable recordkeeping requirements.
  • Support secure backups and recovery procedures.
  • Minimize collection and exposure of personal information.
  • Provide mechanisms for identifying suspicious access and transaction activity.
  • Preserve recipient control over payment accounts, financial records, and cryptocurrency wallets.
  • Prioritize noncustodial cryptocurrency integrations and avoid unnecessary asset custody.

Administration and Configuration Module

  • Allow recipients to configure contribution settings, currencies, payment methods, and accounting preferences.
  • Support management of payment provider integrations and cryptocurrency wallets.
  • Provide configuration for exchange-rate and market valuation sources.
  • Allow recipients to select preferred accounting currencies and tax jurisdictions.
  • Support configurable contribution limits, suggested amounts, and recurring support settings.
  • Allow configuration of AI providers and classification preferences.
  • Provide notification settings for contributions, settlements, refunds, chargebacks, and reconciliation issues.
  • Support account permissions and administrative controls.
  • Provide system health, integration status, and processing activity monitoring.
  • Allow recipients to configure reporting periods and financial export preferences.
  • Maintain configuration histories where changes affect financial processing or reporting.

API and Developer Integration Module

  • Provide documented interfaces for integrating MicroPatron into external applications and services.
  • Support contribution creation, transaction retrieval, recipient management, and financial reporting.
  • Provide integration interfaces for payment providers, currency sources, cryptocurrency networks, and accounting services.
  • Support event notifications for contributions, payment settlements, refunds, reversals, and other transaction updates.
  • Provide embeddable contribution components and reusable integration interfaces.
  • Support website, publishing platform, and content management integrations.
  • Provide testing and sandbox capabilities where supported.
  • Maintain versioned interfaces and backward compatibility where practical.
  • Document authentication, permissions, transaction references, and integration requirements.
  • Allow third-party developers to create compatible extensions without requiring modifications to the core specification.

Data Portability and Export Module

  • Allow recipients to export complete financial and contribution records.
  • Preserve original transaction amounts, denominations, payment details, and normalized accounting values.
  • Include exchange rates, valuation timestamps, transaction references, and source information.
  • Support exports of fiat and cryptocurrency transaction histories.
  • Include payment fees, settlement records, refunds, chargebacks, and adjustment entries.
  • Support tax-year-specific financial summaries and supporting documentation.
  • Provide common machine-readable and accounting-compatible export formats.
  • Support importing historical financial records from compatible services.
  • Preserve transaction provenance and historical calculation details.
  • Avoid vendor lock-in and ensure recipients retain access to their financial information.

Optional Plugin Modules

Payment Provider Plugin

Integrate additional payment processors, payment gateways, banking services, and supported payment methods.

Cryptocurrency Network Plugin

Add support for additional blockchain networks, tokens, wallet integrations, transaction monitoring, and blockchain verification.

Currency Exchange Plugin

Connect additional fiat currency exchange-rate providers and historical foreign exchange data sources.

Cryptocurrency Valuation Plugin

Integrate cryptocurrency market data providers and historical digital asset valuation sources.

WordPress Plugin

Provide native contribution widgets, configuration tools, and financial integration for WordPress websites.

Ghost Publishing Plugin

Integrate MicroPatron contribution interfaces into Ghost publications, articles, and creator pages.

Content Management Plugin

Provide integrations for additional content management systems and publishing platforms.

E-Commerce Plugin

Support voluntary contributions associated with compatible online stores, products, and digital services without confusing tips with mandatory purchase charges.

Creator Platform Plugin

Provide integrations for independent creator platforms, digital publications, and community services.

Accounting Software Plugin

Export and synchronize compatible financial records with supported bookkeeping and accounting applications.

Tax Jurisdiction Plugin

Extend tax research and estimation capabilities to supported state, local, and international jurisdictions.

IRS Form Update Plugin

Monitor and incorporate validated updates to IRS forms, instructions, publications, and tax-year calculation requirements.

Advanced Tax Research Plugin

Provide expanded tax research, source analysis, regulatory monitoring, and historical tax interpretation.

AI Provider Plugin

Connect compatible hosted or locally operated AI providers for accounting assistance, classification, explanations, and research.

Local AI Plugin

Support locally operated AI models for privacy-focused accounting assistance and financial analysis.

Fraud Detection Plugin

Provide additional transaction monitoring, anomaly detection, suspicious activity identification, and risk analysis.

Recurring Support Plugin

Extend recurring contribution scheduling, payment management, contributor notifications, and subscription-style voluntary support.

Contributor Recognition Plugin

Provide configurable contributor acknowledgments, recognition displays, supporter histories, and optional public contribution badges.

Multi-Recipient Plugin

Allow contributors to distribute a single contribution among multiple recipients or projects according to configured allocation rules.

Donation Classification Plugin

Provide additional classification and documentation support for charitable contributions, donations, gifts, and other payment categories without assuming that a contribution qualifies for a particular tax treatment.

Business Reporting Plugin

Extend financial reporting for organizations, professional practices, businesses, and multiple recipient accounts.

Localization Plugin

Provide additional language support, regional currency formatting, localized interfaces, and jurisdiction-specific display preferences.

Notification Plugin

Integrate email, messaging, and other notification services for contribution activity, payment updates, and financial reporting.

Advanced Analytics Plugin

Provide expanded contribution analytics, content performance analysis, historical comparisons, and financial forecasting.

Identity Verification Plugin

Integrate compatible identity verification services where required by payment providers, financial integrations, or applicable regulations.

Blockchain Audit Plugin

Provide expanded blockchain transaction verification, historical asset tracking, and independently reviewable transaction records.


Specification Branding License (SBL)

Standard

Optional


License & Notice Requirements

MicroPatron is released under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).
By contributing to any Open Arsenal project, you agree that your contributions will also be released under this license.

Please note the following:

  • All contributions must comply with the AGPL-3.0+ terms.
  • Under Section 7 of the license, all redistributions, forks, and derivative works must preserve attribution to:
    Roxanne Ardary and roxanneardary.com.
  • MicroPatron specifications are free to use with attribution. A Specification Branding License can be negotiated upon request.
  • The project’s notice.md file tracks attribution requirements and contributor acknowledgments.
    Any update that adds new contributors or modifies attribution should also update notice.md.
  • When submitting a pull request, ensure that any new files maintain the attribution headers where applicable.
  • Network-deployed versions of this software must also remain fully AGPL-3.0+ compliant, including exposure of source code modifications when applicable under the license.

For full legal details, please refer to the AGPL-3.0+ license and the project’s notice.md file.


Notice – MicroPatron

Attribution Requirement: Under Section 7 of the AGPL 3.0+ license, all redistributions, forks, and derivative works, including network-deployed versions of this project, must provide attribution to Roxanne Ardary and roxanneardary.com.

Contributors

This file tracks contributors and their specific contributions to the project.

  • Roxanne Ardary, roxanneardary.com – November 18, 2026
    Created the repository for MicroPatron. Developed the project concept and specification for an open-source tipping infrastructure featuring embeddable contribution interfaces, multi-currency and cryptocurrency payments, AI-assisted accounting, financial recordkeeping, currency conversion, and automated tax reporting support.
  • Add other contributors here – [Date]
    [Describe contribution in one sentence]

License – MicroPatron

This repository is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0+).

Key Points:

  • You are free to use, modify, and distribute the code.
  • All redistributions, forks, and derivative works or network-deployed versions must also be licensed under AGPL-3.0+ and provide attribution to Roxanne Ardary and roxanneardary.com as required under Section 7 of the license.
  • The software is provided “as is,” without warranty of any kind.

For the full license text, see GNU AGPL-3.0 License.