> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useautumn.com/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/autumn-b9b4c0fb/x4RnTXNx1GGI6nRu/images/vercel-marketplace/step-1-integrations-console.png?fit=max&auto=format&n=x4RnTXNx1GGI6nRu&q=85&s=fa4a38f21f42666f2567a5e920256541" 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/autumn-b9b4c0fb/x4RnTXNx1GGI6nRu/images/vercel-marketplace/step-2-credentials.png?fit=max&auto=format&n=x4RnTXNx1GGI6nRu&q=85&s=44981096f52684cf11b25282f7fac9f1" 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/autumn-b9b4c0fb/x4RnTXNx1GGI6nRu/images/vercel-marketplace/step-3-base-url.png?fit=max&auto=format&n=x4RnTXNx1GGI6nRu&q=85&s=34725ccf25652b9d3241de13d55d034c" 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/autumn-b9b4c0fb/x4RnTXNx1GGI6nRu/images/vercel-marketplace/step-4-webhook-url.png?fit=max&auto=format&n=x4RnTXNx1GGI6nRu&q=85&s=ea21541a7f7ac1f2507eaf49cc776617" 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/autumn-b9b4c0fb/x4RnTXNx1GGI6nRu/images/vercel-marketplace/step-5-marketplace-base-url.png?fit=max&auto=format&n=x4RnTXNx1GGI6nRu&q=85&s=e1bcec43700b34d7ab36c5d605b8368e" 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/autumn-b9b4c0fb/x4RnTXNx1GGI6nRu/images/vercel-marketplace/step-6-custom-payment-methods.png?fit=max&auto=format&n=x4RnTXNx1GGI6nRu&q=85&s=5922c80a551fce7a89a4f0e228aa2b6f" 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/autumn-b9b4c0fb/x4RnTXNx1GGI6nRu/images/vercel-marketplace/step-7-provide-custom-name.png?fit=max&auto=format&n=x4RnTXNx1GGI6nRu&q=85&s=d7d49e9752da20c7451eeeaa9b986e7b" 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/autumn-b9b4c0fb/x4RnTXNx1GGI6nRu/images/vercel-marketplace/step-8-vercel-marketplace-name.png?fit=max&auto=format&n=x4RnTXNx1GGI6nRu&q=85&s=05d4c5c53e2fc113b69a32da62efe7b1" 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/autumn-b9b4c0fb/x4RnTXNx1GGI6nRu/images/vercel-marketplace/step-9-custom-payment-id.png?fit=max&auto=format&n=x4RnTXNx1GGI6nRu&q=85&s=2795995dff1bba32ad25016d45e97168" 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/autumn-b9b4c0fb/x4RnTXNx1GGI6nRu/images/vercel-marketplace/step-10-webhook-events.png?fit=max&auto=format&n=x4RnTXNx1GGI6nRu&q=85&s=037c0102b5cc7c58901b16889bb5134a" 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.
