cptpayment 1.0.1

CPTPayment SDK for Python

cptpayment

Official CPTPayment SDK for Python

Installation

pip install cptpayment

Or install from source:

pip install -e .

Quick Start

from cptpayment import CPTPayment

cpt = CPTPayment('your-api-key')

# Test connection
auth = cpt.auth_test()
print(f"Store ID: {auth['store_id']}")

# Create an order
order = cpt.create_order(
    order_id='ORDER_123',
    price_amount=29.99,
    price_currency='USD',
    title='Product Name',
    description='Product description',
    success_url='https://yourstore.com/success',
    cancel_url='https://yourstore.com/cancel',
)

# Get checkout URL for redirect
checkout_url = cpt.get_checkout_url(order['order_id'], order['store_id'])
# Redirect user to: checkout_url

API Reference

Constructor

cpt = CPTPayment(
    api_key='your-api-key',
    base_url='https://api.cptpayment.com'  # optional
)

Methods

auth_test()

Test API connection and get store info.

auth = cpt.auth_test()
# Returns: {'status', 'store_id', 'mode', 'credits'}

create_order(...)

Create an order on CPTPayment.

order = cpt.create_order(
    order_id='ORDER_123',
    price_amount=29.99,
    price_currency='USD',
    success_url='https://yourstore.com/success',
    cancel_url='https://yourstore.com/cancel',
    purchaser_email='[e-mail]',  # optional
    description='Order description',          # optional
    title='Order title',                      # optional
)
# Returns: {'order_id', 'store_id', 'status', 'invoice', 'payment_url'}

get_order_status(order_id)

Get order status.

status = cpt.get_order_status('ORDER_123')
# Returns: {'order_id', 'status', 'invoice'}

get_checkout_url(order_id, store_id)

Generate checkout URL for redirect flow.

url = cpt.get_checkout_url('ORDER_123', 42)
# Returns: 'https://cptpayment.com/checkout/?plugins=1&order_id=ORDER_123&store_id=42'

verify_webhook(payload, signature)

Verify webhook signature.

is_valid = cpt.verify_webhook(request.json, request.headers.get('X-Signature'))

Advanced Methods (Custom UI)

get_wallets(order_id, store_id, reservation_id=None)

Get available wallets for an order.

create_invoice(...)

Create an invoice after wallet selection.

get_invoice_status(invoice_id)

Get invoice status for polling.

Error Handling

from cptpayment import CPTPayment, CPTError, CPTAuthError

try:
    order = cpt.create_order(...)
except CPTAuthError:
    print('Invalid API key')
except CPTError as e:
    print(f'API Error: {e.message} (status: {e.status_code})')

Flask Example

from flask import Flask, request, jsonify
from cptpayment import CPTPayment
import os

app = Flask(__name__)
cpt = CPTPayment(os.environ['CPT_API_KEY'])

@app.route('/checkout', methods=['POST'])
def checkout():
    data = request.json

    order = cpt.create_order(
        order_id=f"ORDER_{data['product_id']}",
        price_amount=data['price'],
        price_currency='USD',
        title=data['product_name'],
        success_url='http://localhost:5000/success',
        cancel_url='http://localhost:5000/cancel',
    )

    checkout_url = cpt.get_checkout_url(order['order_id'], order['store_id'])
    return jsonify({'checkout_url': checkout_url})

@app.route('/webhook', methods=['POST'])
def webhook():
    payload = request.json

    if payload.get('status') == 'paid':
        print(f"Payment confirmed for order: {payload.get('order_id')}")
        # Fulfill order here

    return jsonify({'status': 'received'})

License

MIT