agenticlypay 0.3.0

Python library for processing agentic payments (ACP, AP2, x402) via Stripe with automated Zelle payouts

AgenticlyPay

A Python library for processing agentic payments (ACP, AP2, x402) via Stripe. Built for agentic developers who need automated payment processing, monthly Zelle payouts, and tax compliance.

Features

• Multi-Protocol Support: Process payments using ACP (Agentic Commerce Protocol), AP2 (Agent Payments Protocol), or x402 protocols
• Stripe Connect Integration: Seamless onboarding and account management for developers
• Automated Zelle Payouts: Monthly automated payouts via Zelle to your email address
• Tax Compliance: Automatic 1099 form generation and filing
• Transparent Pricing: 6.5% + $0.30 per transaction
• Email-Only Configuration: No API keys needed - just use your email address

Important: Email Requirements

Your email address must be Zelle-compatible (US bank account required). Monthly payouts are automatically sent via Zelle to the email address you use when creating your developer account.

Installation

pip install agenticlypay

Quick Start

Basic Usage

from agenticlypay import AgenticlyPayClient

# Initialize the client (no API keys needed!)
client = AgenticlyPayClient(base_url="https://api.agenticlypay.com")  # Optional, defaults to production

# Create a developer account
# IMPORTANT: Use a Zelle-compatible email address (US bank account required)
account = client.create_account(
    email="[e-mail]",  # Must be Zelle-compatible
    country="US"
)

# Process a payment (AUTO protocol)
# IMPORTANT: Include your Zelle-compatible email for usage tracking
payment = client.process_payment(
    email="[e-mail]",  # Must be Zelle-compatible
    protocol="AUTO",
    amount=10000,  # $100.00 in cents
    developer_account_id=account["account"]["account_id"],
    currency="usd",
    description="Payment for service"
    # Include `mandate` for AP2 or `resource_url` for x402
)

Using Convenience Wrappers

from agenticlypay import PaymentProcessor, ConnectManager

# Initialize components (no API keys needed!)
payment_processor = PaymentProcessor()
connect_manager = ConnectManager()

# Create a developer account
account = connect_manager.create_developer_account(
    email="[e-mail]",  # Must be Zelle-compatible
    country="US"
)

# Process a payment
result = payment_processor.process_payment(
    email="[e-mail]",  # Required
    protocol="AUTO",
    amount=10000,  # $100.00 in cents
    developer_account_id=account["account_id"],
    currency="usd"
)

ACP Payment Example

from agenticlypay import AgenticlyPayClient

client = AgenticlyPayClient()

result = client.process_payment(
    email="[e-mail]",  # Required
    protocol="ACP",
    amount=10000,  # $100.00 in cents
    currency="usd",
    developer_account_id="acct_xxxxx",
    description="Payment for service"
)

Note: When creating your developer account, use a Zelle-compatible email address. Monthly payouts will be automatically sent to this email via Zelle.

AP2 Payment Example

result = client.process_payment(
    email="[e-mail]",  # Required
    protocol="AP2",
    amount=10000,
    currency="usd",
    developer_account_id="acct_xxxxx",
    mandate={
        "agent_id": "agent_123",
        "user_id": "user_456",
        "permissions": ["create_payment", "complete_purchase"],
        "expires_at": 1735689600,
        "mandate_id": "mandate_789"
    }
)

x402 Payment Example

result = client.process_payment(
    email="[e-mail]",  # Required
    protocol="x402",
    amount=10000,
    currency="usd",
    developer_account_id="acct_xxxxx",
    resource_url="/api/data/endpoint"
)

Complete Account Setup Example

from agenticlypay import AgenticlyPayClient

client = AgenticlyPayClient()

# 1. Create account
account = client.create_account(
    email="[e-mail]",  # Must be Zelle-compatible
    country="US"
)

# 2. Create onboarding link
onboarding = client.create_onboarding_link(
    account_id=account["account"]["account_id"],
    refresh_url="https://yourapp.com/reauth",
    return_url="https://yourapp.com/success",
    email="[e-mail]"  # Required
)

# 3. Redirect user to onboarding.url
print(f"Onboarding URL: {onboarding['onboarding_link']['url']}")

# 4. Process payments
payment = client.process_payment(
    email="[e-mail]",  # Required
    protocol="AUTO",
    amount=10000,
    developer_account_id=account["account"]["account_id"],
    currency="usd"
)

Monthly Zelle Payouts

Monthly payouts are automatically sent via Zelle to the email address associated with your developer account. No additional configuration needed - just ensure your email is Zelle-compatible (linked to a US bank account).

API Reference

AgenticlyPayClient

The main client class for interacting with the AgenticlyPay API.

Methods

• create_account(email, country="US", metadata=None) - Create a developer account
• get_account(account_id, email) - Get account status
• create_onboarding_link(account_id, refresh_url, return_url, email) - Create onboarding link
• configure_payout_schedule(account_id, interval, email, monthly_anchor=None, weekly_anchor=None) - Configure payout schedule
• process_payment(email, protocol, amount, developer_account_id, currency="usd", ...) - Process a payment
• confirm_payment(email, protocol, payment_id, payment_method=None) - Confirm a payment
• get_payment_status(email, protocol, payment_id) - Get payment status
• get_fee(email, amount) - Calculate fee
• get_monthly_earnings(email, account_id, year, month) - Get monthly earnings
• create_transfer(email, developer_account_id, amount, currency="usd", reference=None) - Create manual transfer
• get_annual_earnings(email, account_id, year) - Get annual earnings for tax reporting

All methods require your email address (must be Zelle-compatible) for usage tracking and payout processing.

Error Handling

from agenticlypay import AgenticlyPayClient, AgenticlyPayError

client = AgenticlyPayClient()

try:
    account = client.create_account(email="[e-mail]", country="US")
except AgenticlyPayError as e:
    print(f"Error: {e}")
    print(f"Status Code: {e.status_code}")

License

MIT License

Support

For issues and questions, please visit our GitHub repository or contact [e-mail]