Paddle API

What authentication does the Paddle API use?

The Paddle API uses Bearer token authentication. Pass your API key in the Authorization header as 'Bearer {api_key}'. Keys are generated in the Paddle dashboard under Developer Tools > Authentication. Through Jentic, your Paddle API key is stored encrypted in your Jentic One instance - agents receive scoped access without seeing the raw token.

How does Paddle handle sales tax and VAT?

As merchant of record, Paddle automatically calculates sales tax and VAT for 200+ countries based on the customer's location and your product's tax category. The tax amount is included in transaction totals and Paddle remits directly to tax authorities. You receive net revenue after tax. Transaction details via GET /transactions/{transaction_id} show the full tax breakdown.

What are the rate limits for the Paddle API?

Paddle applies rate limits of 100 requests per minute for write operations (POST, PUT, PATCH, DELETE) and 200 requests per minute for read operations (GET). If exceeded, the API returns HTTP 429 with a Retry-After header. Higher limits are available on enterprise plans.

How do I create a subscription through the Paddle API via Jentic?

Search Jentic for 'create a Paddle subscription' to find the subscription creation flow. You need a customer ID and price ID (create these first via POST /customers and POST /prices). The subscription links the customer to a recurring price with automatic billing. Jentic loads the full schema so your agent knows which fields are required. Run it through Jentic One, the self-hosted execution layer.

Can I issue refunds through the Paddle API?

Yes. Create an adjustment via POST /adjustments with action 'refund', the original transaction_id, and the items to refund. You can refund full or partial amounts. Paddle processes the refund to the customer's original payment method and deducts the amount from your next payout. The adjustment response includes the refund status and breakdown.

Does the Paddle API support multiple currencies?

Yes. Prices can be configured in multiple currencies (USD, EUR, GBP, and 20+ others). Each price object specifies the currency and amount. When a customer subscribes, the transaction is processed in the price's currency. Paddle handles currency conversion for payouts to your bank account if your payout currency differs.

Can I limit what my agent is allowed to do with the Paddle API?

Yes. Because Jentic One is self-hosted, you decide which Paddle operations your agent may call, so it can create products, prices, and customers or list subscriptions without ever being able to run a cancel or a refund unless you explicitly add those. Paddle puts the subscription id in the URL path, as in POST /subscriptions/{subscription_id}/cancel, so your own rules can pin the agent to just the subscription operations you approve. Destructive actions like POST /adjustments stay out of reach until you grant them, and the encrypted Paddle key is injected only for the calls you allow.