Python SDK

pip install orcuspay

from orcuspay import OrcusPay

client = OrcusPay(
    access_key="ak_test_xxxxx",
    secret_key="sk_test_xxxxx",
)

session = client.create_checkout_session({
    "success_url": "https://yoursite.com/success?session={CHECKOUT_SESSION_ID}",
    "cancel_url": "https://yoursite.com/cancel",
    "line_items": [
        {
            "quantity": 1,
            "price_data": {
                "unit_amount": 50000,  # 500.00 BDT in paisa
                "product_data": {"name": "Premium Plan"},
            },
        }
    ],
    "currency": "BDT",
    "customer": {
        "name": "Test Customer",
        "email": "customer@example.com",
        "phone": "01700000000",
    },
})

# Redirect customer to session["url"]

session = client.get_checkout_session("pay_abc123")
print(session["payment_status"])  # SUCCEEDED | PENDING | FAILED

payments = client.list_payments(limit=10, status="SUCCEEDED")

for payment in payments["payments"]:
    print(payment["id"], payment["amount"])

link = client.create_payment_link({
    "title": "Donation",
    "amount": 500,
    "is_reusable": True,
    "success_url": "https://yoursite.com/thanks",
})

print(link["url"])

from orcuspay import OrcusPay, OrcusPayError

try:
    payment = client.get_payment("invalid_id")
except OrcusPayError as e:
    print(e.code)     # "not_found"
    print(e.message)  # "Payment not found"
    print(e.status)   # 404

client = OrcusPay(
    access_key="ak_prod_xxxxx",
    secret_key="sk_prod_xxxxx",
    api_url="https://your-instance.com/api/v1",
)