Support this app

You can ask users to contribute to your app’s development by adding the “support this app” feature. This allows users to support your app with Reddit Gold in exchange for some kind of award or recognition.

Requirements

1. The “Support this App” purchase button must meet the Developer Platform’s design guidelines.
2. You can choose to give something in return to users who support your app. This could be unique custom user flair, an honorable mention in a thank you post, or another creative way to show your appreciation.
3. If you choose to not give the user anything for supporting your app, ensure that it's clear to the user that they are contributing to a "tip jar" without receiving anything in return.

How to integrate app support

Create the product

Use the Devvit CLI to generate the product configuration.

devvit products add support-app

Add a payment handler

The payment handler is where you award the promised incentive to your supporters. For example, this is how you can award custom user flair:

addPaymentHandler({
  fulfillOrder: async (order, context) => {
    const username = await context.reddit.getCurrentUsername();
    if (!username) {
      throw new Error('User not found');
    }

    const subredditName = await context.reddit.getCurrentSubredditName();

    await context.reddit.setUserFlair({
      text: 'Super Duper User',
      subredditName,
      username,
      backgroundColor: '#ffbea6',
      textColor: 'dark',
    });
  },
});

Initiate purchases

Next you need to provide a way for users to support your app:

• If you use Devvit blocks, you can use the ProductButton helper to render a purchase button.
• If you use webviews, make sure that your design follows the design guidelines to initiate purchases.

Here's how you create a ProductButton in blocks:

import { usePayments, useProducts } from '@devvit/payments';
import { ProductButton } from '@devvit/payments/helpers/ProductButton';
import { Devvit } from '@devvit/public-api';

// addCustomPostType() is deprecated and will be unsupported. It will not work after June 30. View the announcement below this example.
Devvit.addCustomPostType({
  render: (context) => {
    const { products } = useProducts(context);
    const payments = usePayments((result: OnPurchaseResult) => {
      if (result.status === OrderResultStatus.Success) {
        context.ui.showToast({
          appearance: 'success',
          text: 'Thanks for your support!',
        });
      } else {
        context.ui.showToast(
          `Purchase failed! Please try again.`
        );
      }
    });
   const supportProduct = products.find(products.find((p) => p.sku === 'support-app');
   return (
     <ProductButton
       product={supportProduct}
       onPress={(p) => payments.purchase(p.sku)}
     />
   );
})

View addCustomPostType deprecation announcement.

Example

At r/BirbGame, they created the Birb Club. Members can join the club and get exclusive flair to support the app.