v27.1

panel.md

@@ -72,6 +72,7 @@ This page is public operator documentation. It describes panel capabilities, rou
 - Configure Telegram bot token.
 - Configure the user IP information provider: IPinfo.io with an API token, or ip-api.com with Russian or English result language. English is the default for ip-api.com.
 - Configure a DonationAlerts OAuth application with its client ID, client secret, generated callback URL, public donation page URL, and commission percentage. After saving, authorize it through DonationAlerts; access and refresh tokens are stored and refreshed automatically.
+- Configure DonatePay with an API token, public donation page URL, and an optional commission percentage.
 
 ### DonationAlerts Payments
 
@@ -82,6 +83,13 @@ This page is public operator documentation. It describes panel capabilities, rou
 - Only positive whole-RUB donations are processed. The configured commission is deducted and the credited result is rounded down to whole RUB; other currencies and fractional gross amounts are skipped.
 - Donation IDs are stored as unique external transaction references, preventing duplicate credits.
 
+### DonatePay Payments
+
+- Core checks successful DonatePay donations every 5 minutes, scanning the previous hour.
+- The user UUID is read from the transaction `comment`; donations without exactly one valid UUID remain unassigned.
+- Only positive whole-RUB donations are credited. The optional configured commission is deducted and rounded down.
+- DonatePay transaction IDs are stored as provider-specific external references to prevent duplicate credits.
+
 ### User IP History
 
 - View the number of recorded IP addresses on the admin user overview.