Python

SDK Python menawarkan antarmuka Pythonic untuk API Pembayaran Dodo, menyediakan klien sinkron dan asinkron dengan definisi tipe untuk permintaan dan respons. Ini mendukung Python 3.9+ dan mencakup cakupan pengujian yang komprehensif.

Instalasi

Instal SDK menggunakan pip:

pip install dodopayments

Untuk kinerja async yang lebih baik dengan aiohttp:

pip install dodopayments[aiohttp]

SDK ini membutuhkan Python 3.9 atau lebih tinggi. Kami menyarankan menggunakan versi stabil terbaru dari Python untuk pengalaman terbaik dan pembaruan keamanan.

Memulai dengan Cepat

Klien Sinkron

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
    environment="test_mode",  # defaults to "live_mode"
)

checkout_session_response = client.checkout_sessions.create(
    product_cart=[
        {
            "product_id": "product_id",
            "quantity": 1
        }
    ],
)
print(checkout_session_response.session_id)

Klien Asinkron

import os
import asyncio
from dodopayments import AsyncDodoPayments

client = AsyncDodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

async def main() -> None:
    checkout_session_response = await client.checkout_sessions.create(
        product_cart=[
            {
                "product_id": "product_id",
                "quantity": 1,
            }
        ],
    )
    print(checkout_session_response.session_id)

asyncio.run(main())

Selalu simpan kunci API Anda dengan aman menggunakan variabel lingkungan. Jangan pernah meng-commit-nya ke sistem kontrol versi.

Fitur Utama

Pythonic Interface

Kode Python yang bersih, idiomatik yang mengikuti pedoman PEP 8 dan konvensi Python

Async/Await

Dukungan penuh untuk operasi asinkron dengan asyncio dan integrasi aiohttp opsional

Type Hints

Petunjuk tipe lengkap untuk dukungan IDE yang lebih baik dan pemeriksaan tipe dengan mypy

Auto-Pagination

Paginasi otomatis untuk respons daftar dengan iterasi sederhana

Konfigurasi

Variabel Lingkungan

Konfigurasi menggunakan variabel lingkungan:

.env

DODO_PAYMENTS_API_KEY=your_api_key_here

Timeout

Konfigurasi timeout permintaan secara global atau per permintaan:

import httpx
from dodopayments import DodoPayments

# Configure default for all requests (default is 1 minute)
client = DodoPayments(
    timeout=20.0,  # 20 seconds
)

# More granular control
client = DodoPayments(
    timeout=httpx.Timeout(60.0, read=5.0, write=10.0, connect=2.0),
)

# Override per-request
client.with_options(timeout=5.0).checkout_sessions.create(
    product_cart=[
        {
            "product_id": "product_id",
            "quantity": 1,
        }
    ],
)

Pengulangan

Konfigurasi perilaku pengulangan otomatis:

from dodopayments import DodoPayments

# Configure default for all requests (default is 2)
client = DodoPayments(
    max_retries=0,  # disable retries
)

# Override per-request
client.with_options(max_retries=5).checkout_sessions.create(
    product_cart=[
        {
            "product_id": "product_id",
            "quantity": 1,
        }
    ],
)

Operasi Umum

Buat Sesi Checkout

Hasilkan sesi checkout:

session = client.checkout_sessions.create(
    product_cart=[
        {
            "product_id": "pdt_123",
            "quantity": 1
        }
    ],
    return_url="https://yourdomain.com/return"
)

print(f"Checkout URL: {session.checkout_url}")

Kelola Pelanggan

Buat dan ambil informasi pelanggan:

# Create a customer
customer = client.customers.create(
    email="customer@example.com",
    name="John Doe",
    metadata={
        "user_id": "12345"
    }
)

# Retrieve customer
customer = client.customers.retrieve("cus_123")
print(f"Customer: {customer.name} ({customer.email})")

Tangani Langganan

Buat dan kelola langganan berulang:

POST /subscriptions (the SDK’s subscriptions.create method) sudah deprecated. Metode ini masih berfungsi untuk integrasi yang sudah ada, tetapi integrasi baru sebaiknya membuat subscription melalui Checkout Session.

# Create a subscription
subscription = client.subscriptions.create(
    billing={
        "country": "US",
        "city": "San Francisco",
        "state": "CA",
        "street": "1 Market St",
        "zipcode": "94105",
    },
    customer={"customer_id": "cus_123"},  # or {"email": "...", "name": "..."} for a new customer
    product_id="pdt_456",
    quantity=1,
)

# Charge an on-demand subscription
# product_price is in the lowest currency denomination (e.g., 2500 = $25.00 USD)
charge_response = client.subscriptions.charge(
    subscription_id=subscription.subscription_id,
    product_price=2500,
)

# Retrieve usage history (for metered subscriptions)
usage_history = client.subscriptions.retrieve_usage_history(
    subscription_id=subscription.subscription_id,
    start_date="2024-01-01T00:00:00Z",
)

billing memerlukan setidaknya kode negara ISO dua huruf. customer menerima {"customer_id": ...} untuk menautkan customer yang sudah ada atau {"email": ..., "name": ...} untuk membuat customer baru. product_price menggunakan denominasi mata uang terkecil.

Penagihan Berbasis Penggunaan

Menerima Event Penggunaan

Lacak event kustom untuk penagihan berbasis penggunaan:

response = client.usage_events.ingest(
    events=[
        {
            "event_id": "api_call_12345",
            "customer_id": "cus_abc123",
            "event_name": "api_request",
            "timestamp": "2024-01-15T10:30:00Z",
            "metadata": {
                "endpoint": "/api/v1/users",
                "method": "GET",
                "tokens_used": "150"
            }
        }
    ]
)

Mencantumkan dan Mengambil Event

# Get a specific event
event = client.usage_events.retrieve("api_call_12345")

# List events with filtering
events = client.usage_events.list(
    customer_id="cus_abc123",
    event_name="api_request",
    page_size=20
)

for event in events.items:
    print(f"Event: {event.event_id} at {event.timestamp}")

Pagination

Pagination Otomatis

Iterasikan semua item secara otomatis:

from dodopayments import DodoPayments

client = DodoPayments()
all_payments = []

# Automatically fetches more pages as needed
for payment in client.payments.list():
    all_payments.append(payment)
print(all_payments)

Pagination Asinkron

import asyncio
from dodopayments import AsyncDodoPayments

client = AsyncDodoPayments()

async def main() -> None:
    all_payments = []
    # Iterate through items across all pages
    async for payment in client.payments.list():
        all_payments.append(payment)
    print(all_payments)

asyncio.run(main())

Pagination Manual

Untuk kontrol lebih besar atas pagination:

# Access items from current page
first_page = client.payments.list()
for payment in first_page.items:
    print(payment.brand_id)

# Check for more pages
if first_page.has_next_page():
    next_page = first_page.get_next_page()
    print(f"Fetched {len(next_page.items)} more items")

Konfigurasi HTTP Client

Sesuaikan client httpx yang mendasarinya:

import httpx
from dodopayments import DodoPayments, DefaultHttpxClient

client = DodoPayments(
    base_url="http://my.test.server.example.com:8083",
    http_client=DefaultHttpxClient(
        proxy="http://my.test.proxy.example.com",
        transport=httpx.HTTPTransport(local_address="0.0.0.0"),
    ),
)

Asinkron dengan aiohttp

Gunakan aiohttp untuk performa asinkron yang lebih baik:

import asyncio
from dodopayments import DefaultAioHttpClient
from dodopayments import AsyncDodoPayments

async def main() -> None:
    async with AsyncDodoPayments(
        bearer_token="My Bearer Token",
        http_client=DefaultAioHttpClient(),
    ) as client:
        checkout_session_response = await client.checkout_sessions.create(
            product_cart=[
                {
                    "product_id": "product_id",
                    "quantity": 1,
                }
            ],
        )
        print(checkout_session_response.session_id)

asyncio.run(main())

Logging

Aktifkan logging dengan menetapkan environment variable:

export DODO_PAYMENTS_LOG=info

Atau untuk logging tingkat debug:

export DODO_PAYMENTS_LOG=debug

Integrasi Framework

FastAPI

from fastapi import FastAPI, HTTPException
from dodopayments import AsyncDodoPayments
from pydantic import BaseModel
import os

app = FastAPI()
dodo = AsyncDodoPayments(bearer_token=os.getenv("DODO_API_KEY"))

class CheckoutRequest(BaseModel):
    product_id: str
    quantity: int

@app.post("/create-checkout")
async def create_checkout(request: CheckoutRequest):
    try:
        session = await dodo.checkout_sessions.create(
            product_cart=[{
                "product_id": request.product_id,
                "quantity": request.quantity
            }],
            return_url="https://yourdomain.com/return"
        )
        return {"checkout_url": session.checkout_url}
    except Exception as e:
        raise HTTPException(status_code=400, detail=str(e))

Django

from django.http import JsonResponse
from django.views.decorators.http import require_POST
from django.views.decorators.csrf import csrf_exempt
from dodopayments import DodoPayments
import os
import json

client = DodoPayments(bearer_token=os.getenv("DODO_PAYMENTS_API_KEY"))

@csrf_exempt
@require_POST
def create_checkout(request):
    try:
        data = json.loads(request.body)
        session = client.checkout_sessions.create(
            product_cart=[{
                "product_id": data.get("product_id"),
                "quantity": data.get("quantity", 1)
            }],
            return_url="https://yourdomain.com/return"
        )
        return JsonResponse({
            "status": "success",
            "checkout_url": session.checkout_url,
            "session_id": session.session_id
        })
    except Exception as e:
        return JsonResponse({
            "status": "error",
            "message": str(e)
        }, status=400)

Sumber Daya

GitHub Repository

Lihat source code dan berkontribusilah

API Reference

Dokumentasi API lengkap

Discord Community

Dapatkan bantuan dan terhubung dengan developer

Report Issues

Laporkan bug atau minta fitur

Dukungan

Butuh bantuan dengan Python SDK?

Discord: Bergabunglah dengan server komunitas kami untuk mendapatkan dukungan secara real-time
Email: Hubungi kami di support@dodopayments.com
GitHub: Buka issue di repository

Berkontribusi

Kami menyambut kontribusi! Lihat panduan kontribusi untuk memulai.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Instalasi

Memulai dengan Cepat

Klien Sinkron

Klien Asinkron

Fitur Utama

Pythonic Interface

Async/Await

Type Hints

Auto-Pagination

Konfigurasi

Variabel Lingkungan

Timeout

Pengulangan

Operasi Umum

Buat Sesi Checkout

Kelola Pelanggan

Tangani Langganan

Penagihan Berbasis Penggunaan

Menerima Event Penggunaan

Mencantumkan dan Mengambil Event

Konfigurasi HTTP Client

Asinkron dengan aiohttp

Logging

Integrasi Framework

FastAPI

Django

Sumber Daya

GitHub Repository

API Reference

Discord Community

Report Issues

Dukungan

Berkontribusi

​Instalasi

​Memulai dengan Cepat

​Klien Sinkron

​Klien Asinkron

​Fitur Utama

Pythonic Interface

Async/Await

Type Hints

Auto-Pagination

​Konfigurasi

​Variabel Lingkungan

​Timeout

​Pengulangan

​Operasi Umum

​Buat Sesi Checkout

​Kelola Pelanggan

​Tangani Langganan

​Penagihan Berbasis Penggunaan

​Menerima Event Penggunaan

​Mencantumkan dan Mengambil Event

​Pagination

​Pagination Otomatis

​Pagination Asinkron

​Pagination Manual

​Konfigurasi HTTP Client

​Asinkron dengan aiohttp

​Logging

​Integrasi Framework

​FastAPI

​Django

​Sumber Daya

GitHub Repository

API Reference

Discord Community

Report Issues

​Dukungan

​Berkontribusi

Instalasi

Memulai dengan Cepat

Klien Sinkron

Klien Asinkron

Fitur Utama

Konfigurasi

Variabel Lingkungan

Timeout

Pengulangan

Operasi Umum

Buat Sesi Checkout

Kelola Pelanggan

Tangani Langganan

Penagihan Berbasis Penggunaan

Menerima Event Penggunaan

Mencantumkan dan Mengambil Event

Pagination

Pagination Otomatis

Pagination Asinkron

Pagination Manual

Konfigurasi HTTP Client

Asinkron dengan aiohttp

Logging

Integrasi Framework

FastAPI

Django

Sumber Daya

Dukungan

Berkontribusi