Pagar.me Python SDK

Modern Python SDK for integration with the Pagar.me payment gateway (v5).

Features

• Asynchronous: Built on httpx for high-performance async calls.
• Type-safe: Powered by Pydantic v2 for data validation and IDE support.
• Complete: Support for Customers, Cards, Orders, Charges, and more.

Installation

# Using uv
uv add pagarme-python-sdk

# Using pip
pip install pagarme-python-sdk

Quick Start

Asynchronous (Default)

import asyncio
from pagarme_py import PagarMeClient

async def main():
    async with PagarMeClient(api_key="sk_test_...") as client:
        # Create a customer
        customer = await client.customers.create({
            "name": "Tony Stark",
            "email": "tony@stark.com",
            "document": "12345678909",
            "type": "individual"
        })
        print(f"Created customer: {customer.id}")

if __name__ == "__main__":
    asyncio.run(main())

Synchronous

from pagarme_py import PagarMeSyncClient

def main():
    with PagarMeSyncClient(api_key="sk_test_...") as client:
        # Create a customer
        customer = client.customers.create({
            "name": "Tony Stark",
            "email": "tony@stark.com",
            "document": "12345678909",
            "type": "individual"
        })
        print(f"Created customer: {customer.id}")

if __name__ == "__main__":
    main()

Technologies

• Python 3.13+
• uv for package and virtual environment management
• Pydantic v2 for data validation
• HTTPX for asynchronous requests
• Ruff, Pyright, isort for code quality
• Pytest for automated tests

Development

To install development dependencies:

uv sync --all-extras

Refer to .junie/guidelines.md for contribution guidelines.