# Chargebee

Source: https://kart.bnomei.com/docs/providers/chargebee
Updated: 2025-12-07T20:52:50+00:00
Summary: 

> \[ALPHA\] This provider for Chargebee is in alpha stage. Use at your own risk. Any feedback is very welcome.

## Using the provider

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

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

  
## API Credentials

[https://apidocs.chargebee.com/docs/api/hosted\_pages](https://apidocs.chargebee.com/docs/api/hosted_pages)  
... config values or via an `.env` file ([plugin](https://github.com/bnomei/kirby3-dotenv)).

Path: .env  
Code (plaintext):  
```
CHARGEBEE_API_KEY=XXX
CHARGEBEE_SITE=ZZZ
# CHARGEBEE_API_VERSION=
```

  
## Customzing the Checkout

You can use callbacks to customise both the checkout process and each line item. The returned arrays from your callbacks will be merged with the defaults created by the plugin for this provider, allowing you to override those defaults. Check the relevant PHP class and the linked online documentation for the provider to learn more about the expected data structure.

Code (php):  
```
<?php

return [
    'bnomei.kart.providers.chargebee.checkout_options' => function (\Bnomei\Kart\Kart $kart) {
        // configure the checkout based on current kart instance
        // ...
        return [];
    },
    'bnomei.kart.providers.chargebee.checkout_line' => function (\Bnomei\Kart\Kart $kart, \Bnomei\Kart\CartLine $line) {
        // add custom data to the current checkout line
        // ...
        return [];
    },
    // other options
];
```