Create Charge

Create "One-Off" charges that are not linked to a subscription.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
❗️

These charges do not affect MRR. They only impact Net Revenue and Other Revenue.

❗️

If you are managing subscription charges manually, please note that this will not impact the subscription state or MRR. For example, if you stop sending charges, the subscription will stay active until you cancel it. This feature is purely designed to allow people to control the timing of charges, and for people who have custom proration methods.

If you want to manually manage subscription charges, then please contact support.

Otherwise, we will automatically create charges.

❗️

Zero-decimal currencies

Our API expects currencies to be submitted in their smallest unit. The value 100 USD, for example, should be submitted to our API as 10,000 (i.e. 10,000 cents).

We consider the following currencies to be zero-decimal:
BIF, DJF, JPY, KRW, PYG, VND, XAF, XPF, CLP, GNF, KMF, MGA, RWF, VUV, XOF, ISK, HUF

Special Exceptions

Although the Hungarian Forint (HUF) is sometimes considered to have an exponent of 2, our API treats HUF as a zero-decimal currency. All HUF values should therefore be rounded to the nearest whole number (e.g. a charge of HUF 100.95 should be submitted to our API as 101).

Path Params
string
required

Please see Sources

Body Params
string
required

Your unique reference for this charge

int32
required

The charge amount (in cents)

string
required

The ISO code of the currency of this plan. E.G: usd

string
required

Your unique ID for the customer

date-time
Defaults to NOW

Unix timestamp of when this was created

string
Defaults to paid

The status of this charge. Can be paid or failed. Defaults to paid.

int32
Defaults to 0
string

This can only be supplied when Subscription Auto Charging is disabled. Please contact support if you want to handle your subscription charges manually.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json