Currency code error while using chargebee.UnbilledCharge.create API call

Problem Statement

You encounter the error chargebee.api_error.InvalidRequestError: currency_code : Not applicable when subscription_id is specified when using the UnbilledCharge.create API call.

Related Scenarios

• Error when passing currency_code for Charges in Latest Product Catalog

Solution

This error normally occurs when you pass the currency_code for Charges in Latest Product Catalog. Currency_code is applicable only when raising unbilled charges for Quick Charges, and it must be the same as the subscription currency.

Referring to the API documentation for Create unbilled charges for item subscription, the 'currency_code' under Input parameters is 'Required' and not Optional.

Charges:

If you would like to add Charges, you need to pass on 'item_prices[item_price_id][0..n]' and while doing so, you don't have to add 'currency_code' though you have multi-currency enabled. Chargebee will automatically consider the Subscription's currency.

Quick Charges:

Quick charges require currency codes as they are charges that aren't pre-defined and created manually. You will also see this parameter on the Chargebee UI.

Sample Screenshot of Quick Charges in Chargebee UI:

Hence, in the case of Quick Charges (or one-time charges), it is required to pass the 'currency_code' parameter, and the currency code must be the same as the subscription's currency.

To know more about API docs

Related Links:

What is the difference between Charges and Quick Charges in Latest Product Catalog?

How to view the details of changes to the unbilled charges via the API?

[Error: "This API operation is not enabled for this site. Please contact support to get this enabled"](https://chargebee.freshdesk.com/a/solutions/articles/250245)