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

# Common API errors

> Common Meum API and WooCommerce invoice error codes and fixes.

| HTTP | Error                        | Fix                                                                                                                                               |
| ---- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| 401  | Unauthorized                 | Check Bearer token                                                                                                                                |
| 403  | Bootstrap key for invoices   | Use dedicated key after Woo connect                                                                                                               |
| 403  | `CURRENCY_NOT_ALLOWED`       | Allow the shop/invoice currency in Merchant Admin fiat/invoice currency settings, or change the WooCommerce shop currency to a permitted currency |
| 400  | Payout wallet not configured | Configure settlement wallet                                                                                                                       |
| 409  | Order ID conflict            | Use unique external\_order\_id                                                                                                                    |
| 429  | Too many requests            | Back off and retry                                                                                                                                |

<h2 id="currency_not_allowed">
  `CURRENCY_NOT_ALLOWED`
</h2>

Invoice creation returns HTTP **403** with code `CURRENCY_NOT_ALLOWED` when the requested fiat currency is not in the merchant’s allowed invoice fiat currencies.

**Typical WooCommerce case:** the shop currency (for example `EUR`) is sent on `POST /v1/invoices`, but the connected Meum org/store only allows another currency (often `USD` by default).

**Fix (pick one):**

1. In Merchant Admin, allow that currency for invoice fiat currencies (org/store settings), **or**
2. Change **WooCommerce → Settings → General → Currency** to a currency Meum already allows.

The WooCommerce plugin shows a short shopper-safe checkout message; merchants see the full currency hint under **WooCommerce → Settings → Payments → Meum**.

## Related pages

* [Errors](/api-reference/errors)
* [WooCommerce configuration](/woocommerce/configuration)
* [Configure settlement wallet](/getting-started/configure-settlement-wallet)