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

# Vercel Marketplace

> Set up the Vercel Marketplace integration in Autumn

Autumn lets you add your product to [Vercel's Marketplace](https://vercel.com/marketplace) without any additional code. This guide walks through connecting the Autumn partner API and webhooks to Vercel, and setting up Stripe's custom payment method for accurate billing.

<Note>
  This is currently in beta. Reach out on [Discord](https://discord.gg/STqxY92zuS) or email [hey@useautumn.com](mailto:hey@useautumn.com) to get access.
</Note>

## Prerequisites

* An Autumn account with a connected Stripe account
* A Vercel integration entry in the [Vercel Integration Console](https://vercel.com/dashboard/integrations)

## Setup

<Steps>
  <Step>
    ### Open the Integration Console

    Navigate to the Vercel dashboard, then go to **Integrations → Browse Marketplace → Integration Console**.

    <Frame>
      <img src="https://mintcdn.com/leylandscompany/90P_ewflNoopxCjY/images/vercel-marketplace/step-1-integrations-console.png?fit=max&auto=format&n=90P_ewflNoopxCjY&q=85&s=0ba7e81aa2b6d49cce8ff589dddc65e3" alt="Vercel Integration Console" width="2324" height="490" data-path="images/vercel-marketplace/step-1-integrations-console.png" />
    </Frame>
  </Step>

  <Step>
    ### Copy your Vercel credentials

    Scroll to the bottom of the Integration Console page to find your **Client (Integration) ID** and **Client (Integration) Secret**. You'll need both of these for the Autumn dashboard.

    <Frame>
      <img src="https://mintcdn.com/leylandscompany/90P_ewflNoopxCjY/images/vercel-marketplace/step-2-credentials.png?fit=max&auto=format&n=90P_ewflNoopxCjY&q=85&s=9a48a4d374fcb4e8dc70f96825aade4e" alt="Vercel Client ID and Secret" width="1244" height="646" data-path="images/vercel-marketplace/step-2-credentials.png" />
    </Frame>
  </Step>

  <Step>
    ### Copy the Base URL from Autumn

    In the Autumn dashboard, open **Developer → Vercel**. Enter the Client ID and Client Secret from the previous step, then copy the **Base URL** that Autumn generates for you.

    <Frame>
      <img src="https://mintcdn.com/leylandscompany/90P_ewflNoopxCjY/images/vercel-marketplace/step-3-base-url.png?fit=max&auto=format&n=90P_ewflNoopxCjY&q=85&s=f4c32098cb532020a036837ab47b1dda" alt="Autumn Base URL" width="2014" height="474" data-path="images/vercel-marketplace/step-3-base-url.png" />
    </Frame>
  </Step>

  <Step>
    ### Set the Webhook URL in Vercel

    Back in the Vercel Integration Console, paste the Autumn Base URL into the **External Integration Settings → Webhook URL** field.

    <Frame>
      <img src="https://mintcdn.com/leylandscompany/90P_ewflNoopxCjY/images/vercel-marketplace/step-4-webhook-url.png?fit=max&auto=format&n=90P_ewflNoopxCjY&q=85&s=f3b24b53c04a5804e0a8bc20695d232a" alt="Vercel Webhook URL" width="1724" height="497" data-path="images/vercel-marketplace/step-4-webhook-url.png" />
    </Frame>
  </Step>

  <Step>
    ### Set the Marketplace Base URL in Vercel

    Paste the same Autumn Base URL into **Marketplace Integration Settings → Base URL**.

    <Frame>
      <img src="https://mintcdn.com/leylandscompany/90P_ewflNoopxCjY/images/vercel-marketplace/step-5-marketplace-base-url.png?fit=max&auto=format&n=90P_ewflNoopxCjY&q=85&s=9c31ada99ef432bf0e467d6be024d6a6" alt="Vercel Marketplace Base URL" width="1298" height="572" data-path="images/vercel-marketplace/step-5-marketplace-base-url.png" />
    </Frame>
  </Step>

  <Step>
    ### Create a Stripe custom payment method

    Autumn uses Stripe's billing clock for accurate billing cycles and invoice reporting via the **Custom Payment Methods** system. In the Stripe dashboard, go to **Settings → Payments → Custom payment methods**, then click **Create a custom payment method**.

    <Frame>
      <img src="https://mintcdn.com/leylandscompany/90P_ewflNoopxCjY/images/vercel-marketplace/step-6-custom-payment-methods.png?fit=max&auto=format&n=90P_ewflNoopxCjY&q=85&s=cf150008face97484f973d55b85311bd" alt="Stripe Custom Payment Methods" width="2630" height="1560" data-path="images/vercel-marketplace/step-6-custom-payment-methods.png" />
    </Frame>
  </Step>

  <Step>
    ### Provide a custom name and icon

    Select **Provide a custom name and icon** at the bottom of the payment method selection dialog.

    <Frame>
      <img src="https://mintcdn.com/leylandscompany/90P_ewflNoopxCjY/images/vercel-marketplace/step-7-provide-custom-name.png?fit=max&auto=format&n=90P_ewflNoopxCjY&q=85&s=5de29ff5fc949d2c7b734cac8db8aec4" alt="Provide custom name and icon" width="1718" height="854" data-path="images/vercel-marketplace/step-7-provide-custom-name.png" />
    </Frame>
  </Step>

  <Step>
    ### Name the payment method

    Enter **Vercel Marketplace** as the display name and upload the Vercel logo.

    <Frame>
      <img src="https://mintcdn.com/leylandscompany/90P_ewflNoopxCjY/images/vercel-marketplace/step-8-vercel-marketplace-name.png?fit=max&auto=format&n=90P_ewflNoopxCjY&q=85&s=d0d91ddf3c858718b8ec8f5a349cfed9" alt="Vercel Marketplace payment method name and logo" width="1176" height="722" data-path="images/vercel-marketplace/step-8-vercel-marketplace-name.png" />
    </Frame>
  </Step>

  <Step>
    ### Copy the custom payment method ID

    After creating the payment method, Stripe will display a `custom.type ID` (starting with `cpmt_`). Copy this ID and paste it into the **Custom Payment Method ID** field in the Autumn dashboard.

    <Frame>
      <img src="https://mintcdn.com/leylandscompany/90P_ewflNoopxCjY/images/vercel-marketplace/step-9-custom-payment-id.png?fit=max&auto=format&n=90P_ewflNoopxCjY&q=85&s=9708d5fad896ae21e7bd7e7e252cf0df" alt="Custom payment method ID" width="1726" height="778" data-path="images/vercel-marketplace/step-9-custom-payment-id.png" />
    </Frame>
  </Step>

  <Step>
    ### Configure webhook events

    Finally, set up the webhook endpoint for events that Autumn sends to your application. In the Autumn dashboard under **Developer → Vercel**, use the Svix webhook iframe to create a new endpoint. Set your endpoint URL and subscribe to all **Vercel** events. You can ignore the standalone "Webhook URL" setting and leave it empty — the Svix iframe handles this instead.

    <Frame>
      <img src="https://mintcdn.com/leylandscompany/90P_ewflNoopxCjY/images/vercel-marketplace/step-10-webhook-events.png?fit=max&auto=format&n=90P_ewflNoopxCjY&q=85&s=fc88f3c5bd64ee63636b9aec80902a86" alt="Webhook event configuration" width="1930" height="1510" data-path="images/vercel-marketplace/step-10-webhook-events.png" />
    </Frame>
  </Step>
</Steps>

## Validation

Once everything is configured, trigger a test event flow in Vercel to confirm end-to-end delivery. Verify that:

* Vercel receives callback requests for key lifecycle events
* Autumn logs the incoming payload and processes it correctly
* Your application receives the forwarded webhook events

If events aren't being delivered, double-check that the Base URL is identical in both the Webhook URL and Marketplace Base URL fields in Vercel.