SDKs

pip install naturalpay
# or
uv add naturalpay

from naturalpay import Natural

client = Natural()  # API key from NATURAL_API_KEY

# Create a payment on behalf of a customer
payment = client.payments.create(
    amount=10000,  # cents - $100.00
    currency="USD",
    counterparty={"type": "email", "value": "contractor@example.com"},
    description="Invoice #1234",
    customer_party_id="pty_019cd34e27c179bfbbe6870486b11b67",
    x_agent_id="agt_019cd1798d637a4da75dce386343931d",
    x_instance_id="invoice-run-1234",
    idempotency_key="pay-invoice-1234",
)

print(payment.data.id)
print(payment.data.attributes.status)

# Payment using agent context
payment = client.payments.create(
    counterparty={"type": "email", "value": "vendor@example.com"},
    amount=50000,  # cents — $500.00
    description="Vendor payment",
    customer_party_id="pty_019cd34e27c27605a92edc2c7d1a5b34",  # Customer who delegated
    x_agent_id="agt_019cd1798d637a4da75dce386343931d",  # Your agent
    x_instance_id="vendor-payouts-q1",  # Workflow/session ID
    idempotency_key="vendor_payment_001",
)