edahab 2.0.0

Python client for the eDahab payment API

edahab (Python SDK)

Python client for the official eDahab API.

PyPI • n8n Node Package • Status Codes

---

Product Separation

This repository contains two separate libraries:

• Python SDK (this package): edahab
• n8n community node package: n8n-nodes-edahab/

They are versioned and published independently.

---

Quick Start

pip install edahab

from edahab import configure, pay, is_invoice_paid

configure("your-api-key", "your-api-secret")

result = pay(
    customer="65",
    amount=1,
    agent="5555",
    currency="USD",  # required
)

print(result.invoice_id, is_invoice_paid(result.invoice_status))

currency is required on all payment methods and must be USD or SLSH.

---

Core API

Configuration

• configure(api_key, api_secret, ...)
• configure_from_env(...)
• get_client()
• clear_configuration()

Payment helpers

• pay(...) → Issueinvoice
• verify_invoice(...) → CheckInvoiceStatus
• send_credit(...) → agentPayment

Utilities

• normalize_currency("usd") -> "USD"
• is_invoice_paid(status)
• generate_request_hash(serialized_body, api_secret)
• serialize_body(payload)
• describe_status_code(code)

---

Interactive Reference

configure / configure_from_env examples

from edahab import configure, configure_from_env, get_client

# Explicit:
configure("your-api-key", "your-api-secret")

# Or environment-based:
# export EDAHAB_API_KEY=...
# export EDAHAB_API_SECRET=...
configure_from_env()

client = get_client()

pay() and verify_invoice() examples

from edahab import configure, pay, verify_invoice

configure("your-api-key", "your-api-secret")

invoice = pay(customer="65", amount=1, agent="5555", currency="USD")

if invoice.invoice_id:
    verified = verify_invoice(invoice_id=invoice.invoice_id)
    print(verified.invoice_status)

send_credit() example

from edahab import configure, send_credit

configure("your-api-key", "your-api-secret")

credit = send_credit(
    to="252612345678",
    amount=100,
    reference="order-999",
    currency="SLSH",
)
print(credit.transaction_status, credit.transaction_message)

Low-level EdahabClient methods

from edahab import EdahabClient

client = EdahabClient("your-api-key", "your-api-secret")

client.issue_invoice("65", 1, "5555", currency="USD")
client.agent_payment("252612345678", 100, "order-999", currency="SLSH")
client.check_invoice_status("INV123456789")

Error handling pattern

from edahab import (
    EdahabClient,
    EdahabCredentialError,
    EdahabValidationError,
    EdahabAPIStatusError,
    EdahabHTTPError,
)

client = EdahabClient("your-api-key", "your-api-secret")

try:
    client.issue_invoice("65", 1, "5555", currency="USD")
except EdahabCredentialError:
    print("Invalid API key/secret/hash")
except EdahabValidationError as e:
    print(e.validation_errors)
except EdahabAPIStatusError as e:
    print(e.status_code, e.raw_response)
except EdahabHTTPError as e:
    print(e.status_code, e.body)

---

Official Docs

• API introduction
• Purchase / Issueinvoice
• Credit payment / agentPayment
• Verify invoice / CheckInvoiceStatus
• Status codes

---

Exports

configure, configure_from_env, get_client, clear_configuration, pay, verify_invoice, send_credit, is_invoice_paid, normalize_currency, generate_request_hash, serialize_body, describe_status_code, EdahabClient, DEFAULT_BASE_URL, StatusCode, STATUS_DESCRIPTIONS, IssueInvoiceResult, CheckInvoiceStatusResult, AgentPaymentResult, EdahabError, EdahabHTTPError, EdahabDecodeError, EdahabCredentialError, EdahabValidationError, EdahabAPIStatusError.