> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: eCommerce Integration with Donation Campaigns

## Article: eCommerce Integration with Donation Campaigns

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/donations/donation-campaigns/e-commerce-integration-with-donation-campaigns.md

## Article Content:

# About eCommerce Integration with Donation Campaigns

The Donation Campaigns API creates campaign entities but doesn't process payments. To accept donations, integrate with the eCommerce Cart and Checkout APIs.

Use the Wix eCommerce APIs when you want to customize the donation process, control the checkout experience, or create custom donation flows. This approach provides the same donation features as the built-in **Wix Donations app form** but with greater flexibility.

Use the eCommerce APIs as much or as little as you need. For example, you can call [Add To Cart](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart/cart/add-to-cart.md) to add a donation to the cart and let Wix eCommerce handle the rest of the checkout flow by calling [Navigate To Cart Page](https://dev.wix.com/docs/sdk/frontend-modules/ecom/navigate-to-cart-page.md), or you can build a fully custom experience.

To integrate donation campaigns into an eCommerce cart, checkout, or order, use the `catalogReference` object structure as part of the `lineItems` array in the following eCommerce API methods:

* [Create Cart](https://dev.wix.com/docs/rest/business-solutions/e-commerce/purchase-flow/cart/cart/create-cart.md), [Add To Cart](https://dev.wix.com/docs/rest/business-solutions/e-commerce/purchase-flow/cart/cart/add-to-cart.md), and [Add To Current Cart](https://dev.wix.com/docs/rest/business-solutions/e-commerce/purchase-flow/cart/cart/add-to-current-cart.md)
* [Create Checkout](https://dev.wix.com/docs/rest/business-solutions/e-commerce/purchase-flow/checkout/checkout/create-checkout.md) and [Add To Checkout](https://dev.wix.com/docs/rest/business-solutions/e-commerce/purchase-flow/checkout/checkout/add-to-checkout.md)
* [Create Order](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/orders/create-order.md)

## Catalog reference object structure

The `catalogReference` object for donation campaigns includes the following fields:

| Field           | Type   | Description                                                                                   |
|-----------------|--------|-----------------------------------------------------------------------------------------------|
| `catalogItemId` | String | Required. This is the `donationCampaignId`.                                  |
| `appId`         | String | Required. Use the Wix Donations app ID: `"333b456e-dd48-4d6b-b32b-9fd48d74e163"` |
| `options`       | [Object](#options-object-structure) | Required. Contains donation-specific settings.             |

### Options object structure

The `options` object contains the following fields:

| Field               | Type    | Description                                                                                                                              |
|---------------------|---------|------------------------------------------------------------------------------------------------------------------------------------------|
| `amount`            | Number  | Required. The donation amount. Must be greater than `0`.                                                                                 |
| `frequency`         | String  | Optional. The recurring donation frequency. Omit this field for one-time donations. See supported [frequency values](#frequency-values). |
| `donorCoveringFees` | Boolean | Optional. Whether the donor wishes to add a 2.9% fee to the donation amount to cover fees. Defaults to `false`.                         |

### Frequency values

For recurring donations, use 1 of the following frequency values:

| Value   | Description                           |
|---------|---------------------------------------|
| `WEEK`  | A weekly recurring donation.  |
| `MONTH` | A monthly recurring donation. |
| `YEAR`  | A yearly recurring donation.  |

## Examples

### One-time donation

```json
{
  "catalogItemId": "12345678-90ab-cdef-1234-567890abcdef",
  "appId": "333b456e-dd48-4d6b-b32b-9fd48d74e163",
  "options": {
    "amount": 25.00
  }
}
```

### Monthly recurring donation

```json
{
  "catalogItemId": "12345678-90ab-cdef-1234-567890abcdef",
  "appId": "333b456e-dd48-4d6b-b32b-9fd48d74e163",
  "options": {
    "amount": 25.00,
    "frequency": "MONTH"
  }
}
```

### Donation with donor covering fees

```json
{
  "catalogItemId": "12345678-90ab-cdef-1234-567890abcdef",
  "appId": "333b456e-dd48-4d6b-b32b-9fd48d74e163",
  "options": {
    "amount": 50.00,
    "donorCoveringFees": true
  }
}
```