Creating a one-time charge
curl -X POST
-d'charge_name=Product Add-On One'\
You can find the
vendor_auth_code from the Authentication page in your Paddle dashboard.
subscription_id is the existing subscription ID recorded from the webhook. The
charge_name will be the name on the invoice they receive for the one-time charge.
||Seller authentication code
||The amount for the one-time charge. This amount will be charged in the currency of the subscription. If you have set your account to add charge tax in addition to the product price, then sales tax (if appropriate) will be added to the charge amount.
||The name of the one-time charge. This will be visible to buyers and will show up in the receipt as a line item, so the buyer knows how much they were charged and what for. The maximum length of this field is 50 characters.
||Returns a boolean value of true or false, based on whether the API was able to make the charge successfully
||ID of the invoice
||ID of the subscription
||Amount charged (including tax, if appropriate)
||Currency the amount was charged in (same as the currency of the subscription)
||Date the charge was made
||URL to access the post-payment receipt
As with all Paddle services, the Charges API must only be used to sell digital products and services - not physical products, human services, or other items forbidden from being sold on Paddle - see a full list here.
Sellers must ensure that:
- Buyers are informed about the charge description and amount in advance, whether through an interface or via email.
charge_name is descriptive: for example:
- [name] x [quantity] - e.g. Design Plugin x 1
- [number of credits] credits for [subscription plan] - e.g. 200 credits for monthly talk time
- [quantity] [units] [product description] - e.g. 124 MB data usage