> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.suby.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord Overview

> Accept payments and manage paid access for your Discord server with Suby.

The Suby bot acts as an access controller for your Discord community. It grants, manages, and revokes access to private channels automatically based on payment status, no custom code required.

## How It Works

Discord access is controlled through roles. A paid role unlocks private channels, and losing that role immediately removes access. Suby automates the entire lifecycle.

<CardGroup cols={2}>
  <Card title="Granting Access" icon="user-plus">
    Once a payment is confirmed, the Suby bot assigns the paid role instantly, even if the user is not yet a member of your server. New members are invited automatically.
  </Card>

  <Card title="Removing Access" icon="user-minus">
    Access is revoked automatically when a payment fails, a card subscription fails to renew, or a crypto subscription is not renewed after the reminder period.
  </Card>

  <Card title="Notifications" icon="bell">
    The bot notifies members of successful payments, upcoming renewal reminders (crypto subscriptions), and access removal, reducing churn and confusion.
  </Card>

  <Card title="Free Days" icon="calendar">
    Grant temporary access to any user using the `/freedays` command. The role is assigned for a fixed period and removed automatically when it expires. Useful for trials, giveaways, or manual exceptions.
  </Card>
</CardGroup>

## Access Lifecycle

<Steps>
  <Step title="Customer pays">
    The customer completes payment via your PayLink or native Discord checkout.

    <Frame>
      <img src="https://mintcdn.com/suby/763qk24TXoTgmPpN/images/newcheckout.png?fit=max&auto=format&n=763qk24TXoTgmPpN&q=85&s=10f4cbea254826c3433b2dcda3c5e7bc" alt="Newcheckout" width="2900" height="1644" data-path="images/newcheckout.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/suby/MlQ-3ihQ2peJdeu_/images/checkoutdiscord.png?fit=max&auto=format&n=MlQ-3ihQ2peJdeu_&q=85&s=363eef641701e66498e10f322d88c06d" alt="Checkoutdiscord" title="Checkoutdiscord" style={{ width:"59%" }} width="826" height="612" data-path="images/checkoutdiscord.png" />
    </Frame>
  </Step>

  <Step title="Role assigned">
    The Suby bot assigns the paid role instantly. If the customer is not yet in your server, they receive an invite automatically.

    <Frame>
      <img src="https://mintcdn.com/suby/MlQ-3ihQ2peJdeu_/images/ne.png?fit=max&auto=format&n=MlQ-3ihQ2peJdeu_&q=85&s=8eaf6a56ad14231f9b13835ce2ea0315" alt="Ne" title="Ne" style={{ width:"59%" }} width="808" height="554" data-path="images/ne.png" />
    </Frame>
  </Step>

  <Step title="Subscription active">
    Access is maintained automatically for the duration of the subscription. No manual action required.
  </Step>

  <Step title="Renewal">
    On renewal, nothing changes, the role stays assigned and access continues uninterrupted.

    <Frame>
      <img src="https://mintcdn.com/suby/MlQ-3ihQ2peJdeu_/images/renew.png?fit=max&auto=format&n=MlQ-3ihQ2peJdeu_&q=85&s=51131fa6c74bcb082927d282e631a8dc" alt="Renew" title="Renew" style={{ width:"62%" }} width="912" height="520" data-path="images/renew.png" />
    </Frame>
  </Step>

  <Step title="Cancellation or failed payment">
    The role is revoked automatically. The member is notified inside Discord.

    <Frame>
      <img src="https://mintcdn.com/suby/B8kUXdge2GTpJJsP/images/remove.png?fit=max&auto=format&n=B8kUXdge2GTpJJsP&q=85&s=ae86337527637632e31e2a9ac2b39c5c" alt="Remove" title="Remove" style={{ width:"68%" }} width="1114" height="636" data-path="images/remove.png" />
    </Frame>
  </Step>
</Steps>

## Renewal & Access Removal

<AccordionGroup>
  <Accordion title="Card subscriptions">
    If a card renewal fails, Suby retries the charge over the following days. If the payment remains unresolved, the role is revoked and the member is notified.
  </Accordion>

  <Accordion title="Crypto subscriptions">
    Suby sends a renewal reminder to the member before their access period ends. If the subscription is not renewed, the role is removed automatically after the reminder period.

    <Frame>
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/suby/images/renepng" alt="Renepng" title="Renepng" style={{ width:"58%" }} />
    </Frame>
  </Accordion>

  <Accordion title="Manual removal">
    You can manually revoke or grant access at any time from your Suby dashboard, independently of the subscription state.
  </Accordion>
</AccordionGroup>

## Free Days

Use the `/freedays` command to grant temporary access to any user without requiring a payment.

<Note>
  The role is assigned for a fixed number of days and removed automatically when the free period ends. Useful for trials, giveaways, or manual exceptions.
</Note>

<CardGroup cols={2} />
