Python wrapper around the Paddle.com API
Project description
Paddle Client
A python (3.5+) wrapper around the Paddle.com API
If you are looking at integrating Paddle with Django check out dj-paddle
The full documentation is available at: https://paddle-client.readthedocs.io
Note: Several of the Paddle Endpoints are currently not working as expected. See Failing endpoints below.
Quick start
Installation
pip install paddle-client
Basic Usage
To use the Paddle API you will need a Paddle Vendor ID and API key which can be found on Paddle's authentication page
from paddle import PaddleClient
paddle = PaddleClient(vendor_id=12345, api_key='myapikey')
paddle.list_products()
If vendor_id
and api_key
are not passed through when initialising Paddle will fall back and try and use environmental variables called PADDLE_VENDOR_ID
and PADDLE_API_KEY
export PADDLE_VENDOR_ID=12345
export PADDLE_API_KEY="myapikey"
from paddle import PaddleClient
paddle = PaddleClient()
paddle.list_products()
Paddle sandbox environment
The Paddle sandbox environment is a separate Paddle environment which can be used for development and testing. You are required to create a new account in this environment, different to your production account.
Once you have this account setup and configured you can user the sandbox account by passing sandbox=True
when initialising the Paddle Client. This will send all API calls to the Paddle sandbox URLs instead of the production URLs
from paddle import PaddleClient
paddle = PaddleClient(vendor_id=12345, api_key='myapikey', sandbox=True)
It is also possible to turn the sandbox environment on using an environmental variable called PADDLE_SANDBOX
:
export PADDLE_SANDBOX="true"
from paddle import PaddleClient
paddle = PaddleClient(vendor_id=12345, api_key='myapikey')
Documentation
The full documentation is available on Read the Docs: https://paddle-client.readthedocs.io
Contributing
All contributions are welcome and appreciated. Please see CONTRIBUTING.md for more details including details on how to run tests etc.
Paddle Endpoints
The below endpoints from the Paddle API Reference have been implemented
For full details see the API Reference in the docs. This includes details on parameters and return types for all the different methods as well as other helper methods around the Paddle.com API.
See Usage
below for quick examples.
Checkout API
Product API
- List Coupons
- Create Coupon
- Delete Coupon
- Update Coupon
- List Products
- List Transactions
- Refund Payment
Subscription API
- List Plans
- Create Plan
- List Subscription Users
- Cancel Subscription
- Update Subscription
- Add Modifier
- Delete Modifier
- List Modifiers
- List Payments
- Reschedule Payment
- Create One-off Charge
Alert API
Usage
See the API Reference in the docs for full usage with param are return details.
# Checkout API
paddle.get_order_details(checkout_id='aaaa-bbbb-cccc-1234')
paddle.get_user_history(email='test@example.com')
paddle.get_prices(product_ids=[1234])
# Product API
paddle.list_coupons(product_id=1234)
paddle.create_coupon(
coupon_type='product',
discount_type='percentage',
discount_amount=50,
allowed_uses=1,
recurring=False,
currency='USD',
product_ids=[1234],
coupon_code='50%OFF',
description='50% off coupon over $10',
expires='2030-01-01 10:00:00',
minimum_threshold=10,
group='paddle-python',
)
paddle.delete_coupon(coupon_code='mycoupon', product_id=1234)
paddle.update_coupon(
coupon_code='mycoupon',
new_coupon_code='40%OFF',
new_group='paddle-python-test',
product_ids=[1234],
expires='2030-01-01 10:00:00',
allowed_uses=1,
currency='USD',
minimum_threshold=10,
discount_amount=40,
recurring=True
)
paddle.list_products()
paddle.list_transactions(entity='subscription', entity_id=1234)
paddle.refund_product_payment(order_id=1234, amount=0.01, reason='reason')
# Subscription API
paddle.list_plans()
paddle.get_plan(plan=123)
paddle.create_plan(
plan_name='plan_name',
plan_trial_days=14,
plan_length=1,
plan_type='month',
main_currency_code='USD',
initial_price_usd=50,
recurring_price_usd=50,
)
paddle.list_subscription_users()
paddle.cancel_subscription(subscription_id=1234)
paddle.update_subscription(subscription_id=1234, pause=True)
paddle.update_subscription(
subscription_id=1234,
quantity=10.00,
currency='USD',
recurring_price=10.00,
bill_immediately=False,
plan_id=123,
prorate=True,
keep_modifiers=True,
passthrough='passthrough',
)
paddle.pause_subscription(subscription_id=1234)
paddle.resume_subscription(subscription_id=1234)
paddle.add_modifier(subscription_id=1234, modifier_amount=10.5)
paddle.delete_modifier(modifier_id=10)
paddle.list_modifiers()
paddle.list_subscription_payments()
paddle.reschedule_subscription_payment(payment_id=4567, date='2030-01-01')
paddle.create_one_off_charge(
subscription_id=1234,
amount=0.0,
charge_name="Add X on top of subscription"
)
# Alert API
paddle.get_webhook_history()
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for paddle_client-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 232ff0430da685646a756447a7f15cd66a554dde20f04dec626526a79d2e0dda |
|
MD5 | e980e30b7e632f19e694837eeef4b4e4 |
|
BLAKE2b-256 | 8df425e6d57961e985163fc4a0f6d48ed1acf6a8feaf46db604d15bedfd5f4c6 |