Earn: Donation Block

[gwwar]

This task is to add a new Block to FSE that allows users to collect donations, so that I can raise money for a specific cause, or event. Since there are existing recurring payment APIs (that can handle one time payments), this issue will mostly cover the needed block code/registration.

This is part of #42825

Acceptance Criteria

Free Users – As a free plan user, I should be able to add the donation block, but I will need to upgrade to a paid plan before I can use it.
All paid plans – As a paid plan (including the Personal plan) customer I should be able to add the donation block, be prompted set up my Stripe account and start accepting donations.
Preset amounts – As a customer, when I add the donation block for the first time donation plans should be generated for me
Default to USD – For the v1 we will default to USD. This can be manually changed for each donation subscription. In the future we may consider centralizing this based on customer feedback. (Handled by #43030 )
Manage Donations subscriptions – As a customer, I should see a link in the block sidebar which takes me to the screen in Calypso where I can manage my donation subscriptions – which are separate from the other customizable subscriptions:
Toggle Payment Options – As a customer, I should be able to toggle monthly, annual, and “Other” payment options on or off.
Reuse Donation Subscriptions – If multiple donation blocks are added, they will use the same set of subscriptions

Additional Scoping Notes

• The donation block text should be editable
• Unless there are major objections, we're opting to go with the simpler preference of 3 pay-what-you want plans (one time, monthly, yearly) per-currency.
• Noted amounts in the blocks are "suggestions", meaning that we can serialize these values within the blocks. (They aren't saved to the product).
• All new Calypso management screens will be dropped. The auto-generated subscription plans will still be filtered out from the list view.
• "Manage donation subscriptions" link in the block-editor will turn into "View Donation Earnings"
• We'll need to audit all communications (emails/notifications) etc and make sure copy is modified, or seperate emails/notifications are generated.
• A nice to have would be modifying the number of tiers, but we can always revisit in a v2

Technical Notes:

• Please feature gate this if work takes longer, we appear to publish FSE roughly every two weeks.
• This is a new block that will be added to the FSE plugin
• One time payment customers still need a wpcom account
• This is backed by the recurring payments API, which already has support for one time payments
• We should add this block to the new category. We will likely need to bump out another block into a different collection. Add Premium Content block to "Earn" collection in inserter #41579
• Please reuse Newspack UX or defer to @danhauk's designs

Not In Scope

Editing the Number of Tiers – Customers will not be able to edit the number of donation tiers that they show. We will default to 3 tiers plus the optional “Other” payment.

see also pbMlHh-hA-p2

[gwwar]

Quick notes from today's scoping chat. I'll update the summary of the issue in a bit:

• The donation block text should be editable
• Unless there are major objections, we're opting to go with the simpler preference of 3 pay-what-you want plans (one time, monthly, yearly) per-currency.
• Noted amounts in the blocks are "suggestions", meaning that we can serialize these values within the blocks. (They aren't saved to the product).
• All new Calypso management screens will be dropped. The auto-generated subscription plans will still be filtered out from the list view.
• "Manage donation subscriptions" link in the block-editor will turn into "View Donation Earnings"
• We'll need to audit all communications (emails/notifications) etc and make sure copy is modified, or seperate emails/notifications are generated.
• A nice to have would be modifying the number of tiers, but we can always revisit in a v2