nekuda 0.2.1

Python SDK for Nekuda payment processing

Quickstart

Welcome to the rapid-fire tour of the Nekuda Python SDK. In less than five minutes you will:

1. install the package,
2. authenticate with your API key, and
3. run your first card-reveal workflow.

TL;DR – copy the snippets below into a file called hello.py, export your API key, run it, done.

💡 Don't forget! This Python SDK handles the backend payment processing. You'll also need to integrate our wallet collection SDK on your frontend to securely collect credit card details from users.

---

1. Installation

We recommend using UV (fast Rust-based pip replacement), but plain pip works just as well:

uv pip install nekuda
#-or-
pip install nekuda

The SDK ships as a single, pure-python wheel with zero heavy dependencies – install is ~1 s.

---

2. Authenticate

Grab your secret key from the Nekuda dashboard and export it as an environment variable:

export NEKUDA_API_KEY="sk_live_…"  # required
# Optional – point the SDK to staging / localmock
export NEKUDA_BASE_URL="https://staging-api.nekuda.ai"

That's all the configuration you need for the quickstart.

---

3. Hello World

from nekuda import NekudaClient

client = NekudaClient.from_env()
print("🚀 Authenticated! Your account ID is:", client.api_key[:8] + "…")

python hello.py

If everything is set-up correctly you should see:

🚀 Authenticated! Your account ID is: sk_live_12…

---

4. End-to-end flow in <40 lines

The snippet below walks through the full payment flow using mock data:

from nekuda import MandateData, NekudaClient

client = NekudaClient.from_env()
user = client.user("user_123")

# 1) Describe what the user is about to purchase
mandate = MandateData(product="Premium Subscription", price=49.99, currency="USD", merchant="Nekuda Corp")
mandate_id = user.create_mandate(mandate)["mandate_id"]

# 2) Ask for a short-lived *reveal token*
token = user.request_card_reveal_token(mandate_id)["reveal_token"]

# 3) Exchange the token for the raw card details (one-time operation)
card = user.reveal_card_details(token)
print("💳 **** **** ****", card.card_number[-4:])

Run it and you should see the last four digits of the test card printed to stdout.

🔗 Complete Integration: Remember that in a real application, steps 1-2 happen on your backend (using this Python SDK), while the actual card collection happens on your frontend using our React wallet SDK.

---

What's next?

• 📚 Full Documentation – comprehensive guides, API reference, and integration examples
• Guides – dive into the Payment & Card Reveal Flow for a deeper explanation of each step
• Core Concepts – get familiar with NekudaClient, UserContext, and our data models
• API Reference – see every parameter & response in detail (auto-generated from docstrings)

Happy hacking! 🎉