# Gumroad

Source: https://kart.bnomei.com/docs/providers/gumroad
Updated: 2025-08-08T14:18:32+00:00
Summary: Use Gumroad with Kirby Kart: fetch single products, define virtual fields, redirect to hosted checkout, and configure API credentials via config or .env.

> This provider is limited to fetching products from Gumroad.  
> You can only sell a single item at once and direclty via Gumroad.  
> It will not create orders within Kirby.

## Using the provider

Path: site/config/config.php  
Code (php):  
```
<?php

return [
   'bnomei.kart.provider' => 'gumroad',
   // other options
];
```

  
## Virtual Fields

You can define which fields are treated as purely virtual and fetched from the provider ignoring any changes you make within the panel.

Code (php):  
```
<?php

return [
 'bnomei.kart.providers.gumroad.virtual' => true,
 // 'bnomei.kart.providers.gumroad.virtual' => ['raw', 'description', 'gallery', 'price', 'tags', 'title'],

 // other options
];
```

  
## No Hosted Checkout

Gumroad does not support forwarding a list of items in a shopping cart and letting them handle the checkout. Instead, you are limited to redirecting to their product page.

Path: site/templates/product.php  
Code (php):  
```
<?php /** @var ProductPage $page **/ ?>

<a href="<?= $page->gumroadUrl() ?>"><?= $page->title() ?></a>
```

  
## API Credentials

Create a new application and click the "*Generate access token*"-button. Copy that value to your [config file](https://kart.bnomei.com/docs/setup/configuration) or use a `.env`-file ([plugin](https://github.com/bnomei/kirby3-dotenv)). You can set the `Redirect URI = 127.0.0.1`.

![](https://kart.bnomei.com/media/pages/media/a0668d3119-1746706063/gumroad-1920x.webp)  
Path: .env  
Code (plaintext):  
```
GUMROAD_ACCESS_TOKEN=XXX
```