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

# Setting Up and Managing Your Stripe Payout Account

> Agents on MOGL receive payouts through Stripe Express. Learn how to complete onboarding, understand your payout status, and resolve account issues.

To receive payments on MOGL, agents need a connected Stripe Express account. Stripe handles identity verification, banking details, and payout readiness — MOGL connects to Stripe so your earnings are deposited directly to your bank account. This guide walks you through setting up your payout account, understanding your current status, and resolving any issues that come up.

## Setting up your Stripe Express account

If you haven't connected a payout account yet, you'll be prompted to complete Stripe onboarding before your first payout can be processed.

<Steps>
  <Step title="Start Stripe onboarding">
    In your MOGL account settings, navigate to **Payouts** or **Payment Settings**. Select the option to connect or set up your Stripe account. MOGL will create a Stripe Express account linked to your profile and generate a secure onboarding link.

    ```http theme={"dark"}
    POST /ConnectExpressAccount
    ```

    No request body is needed — MOGL uses your account profile to set up the Stripe Express account automatically.
  </Step>

  <Step title="Complete Stripe's hosted onboarding">
    You'll be redirected to a Stripe-hosted page where you'll provide:

    * Legal name and date of birth
    * Social Security Number (last four digits or full, depending on Stripe's requirements)
    * Bank account details for payouts (routing and account numbers)
    * Any additional identity or compliance information Stripe requests

    Stripe's onboarding is secure and encrypted — MOGL does not store your banking credentials or SSN directly.
  </Step>

  <Step title="Return to MOGL">
    Once you've completed the Stripe flow, you'll be redirected back to MOGL. Your payout status will update to reflect whether onboarding is complete or if additional steps are needed.
  </Step>
</Steps>

<Note>
  Stripe Express onboarding is required before any payout can be processed. If you skip or don't finish onboarding, your earnings will be held until the account is ready.
</Note>

## Understanding your payout status

Your Stripe account can be in one of several states. You can check your current status at any time:

```http theme={"dark"}
GET /StripeAccountRetrieve
```

<CardGroup cols={3}>
  <Card title="Onboarding Incomplete" icon="circle-dashed">
    You've started but haven't finished Stripe's onboarding flow. No payouts can be processed until onboarding is complete. You'll need to return to the onboarding link and finish all required steps.
  </Card>

  <Card title="Requirements Due" icon="triangle-exclamation">
    Stripe has verified your account but is requesting additional information — often updated identity documents or tax information. Payouts may be paused until you address the outstanding requirements.
  </Card>

  <Card title="Payouts Enabled" icon="circle-check">
    Your Stripe Express account is fully set up and payouts are active. Earnings will be deposited to your linked bank account on MOGL's payout schedule.
  </Card>
</CardGroup>

## Updating your payout method

You can update your payout preference between Stripe and PayPal at any time:

```http theme={"dark"}
POST /updatePayment
```

| Field            | Description                                                      |
| ---------------- | ---------------------------------------------------------------- |
| `default_method` | `"S"` for Stripe, `"P"` for PayPal                               |
| `paypal_id`      | Your PayPal email or ID (only required when switching to PayPal) |

## Managing Stripe payment methods

You can manage the payment methods linked to your Stripe account directly from MOGL:

| Action                                 | Endpoint                                                                   |
| -------------------------------------- | -------------------------------------------------------------------------- |
| View payment methods                   | `GET /agent/stripe/payment-methods`                                        |
| Add a payment method                   | `POST /agent/stripe/payment-methods`                                       |
| Set a default method                   | `POST /agent/stripe/payment-methods/{paymentMethodId}/set-as-default`      |
| Verify a bank account (micro-deposits) | `POST /agent/stripe/payment-methods/{paymentMethodId}/verify-bank-account` |
| Remove a payment method                | `DELETE /agent/stripe/payment-methods/{paymentMethodId}`                   |

## What to do if there's an issue with your payout account

<Tabs>
  <Tab title="Onboarding not finishing">
    If you started Stripe onboarding but didn't complete it, or if you were redirected back to MOGL before finishing, your account link may have expired. Account links are time-limited for security reasons and cannot be reused after they expire.

    To get a new onboarding link, return to your **Payouts** settings in MOGL and start the setup process again. MOGL will generate a fresh link pointing to where you left off in Stripe's flow.

    <Warning>
      Do not attempt to reuse an expired Stripe onboarding link — it will not work. Always generate a new link from your MOGL account settings.
    </Warning>
  </Tab>

  <Tab title="Requirements due / verification needed">
    If Stripe has flagged your account with outstanding requirements (such as updated identity documents or additional verification), you need to log back into your Stripe Express account to address them.

    Go to **Payouts** in your MOGL settings and select the option to update your Stripe account. You'll be redirected to Stripe's hosted interface where you can see exactly what's needed and submit the required information.
  </Tab>

  <Tab title="Payouts paused or delayed">
    If payouts are enabled but you haven't received an expected payment, check your **Billing** section in MOGL for invoice and payout history:

    ```http theme={"dark"}
    GET /agent/stripe/invoices
    ```

    If invoices show as issued but funds haven't arrived, common causes include:

    * Bank processing time (typically 2–5 business days)
    * A mismatch in your bank account details
    * A temporary Stripe hold pending additional verification

    If the issue persists after checking these, contact MOGL support with your deal ID and invoice reference so the team can investigate your payout status directly.
  </Tab>
</Tabs>

## Refreshing an expired account link

Stripe account links are single-use and expire after a short period. If you try to open an onboarding or update link and it no longer works:

<Steps>
  <Step title="Return to your MOGL payout settings">
    Navigate to **Account Settings → Payouts** in MOGL.
  </Step>

  <Step title="Request a new link">
    Select **Set up Stripe account** or **Update Stripe account** — this generates a fresh, valid link tied to your current Stripe account state.
  </Step>

  <Step title="Complete the Stripe flow">
    Follow the prompts in Stripe's hosted interface. You'll be picked up at the step you need to complete rather than starting from scratch.
  </Step>
</Steps>

<Tip>
  Complete Stripe onboarding in a single session when possible. If you need to stop partway through, make sure to request a new link from MOGL rather than bookmarking the Stripe URL — bookmarked links will not work after expiry.
</Tip>

## Viewing billing and subscription details

Once your Stripe account is set up, you can access your full billing history and subscription status:

| Information          | Endpoint                          |
| -------------------- | --------------------------------- |
| Billing invoices     | `GET /agent/stripe/invoices`      |
| Active subscriptions | `GET /agent/stripe/subscriptions` |