Mojo SDK (preview)

pixi init my-app -c https://conda.modular.com/max -c conda-forge
cd my-app
pixi add "mojo>=1.2.0,<2" "python>=3.10"
git clone https://github.com/kraftonnotgar-spec/teepay-mojo vendor/teepay-mojo
pixi run mojo run -I vendor/teepay-mojo/src main.mojo

from teepay import TeePay

def main() raises:
    var teepay = TeePay()   # reads TEEPAY_API_KEY; or TeePay("tp_test_...")
    var caps = teepay.capabilities()
    print(caps.string("environment"), caps.boolean("features.collection_create"))

from teepay import CollectionCustomer, Money, TeePay

def main() raises:
    var teepay = TeePay()
    var payment = teepay.collections.create(
        Money("500000", "TZS"),                    # TZS 5,000.00 in minor units
        CollectionCustomer("TZ", "+255712345678", name="Asha Juma"),
        description="Order 1001",
        idempotency_key="order-1001",
    )
    print(payment.string("public_reference"), payment.string("status"))   # TP8K2M4QZ1 pending

    # 202 means the prompt was sent, not that the customer paid.
    # Wait for the payment.completed webhook, or poll:
    var latest = teepay.collections.retrieve(payment.string("public_reference"))
    if latest.string("status") == "succeeded":
        print("paid")

from std.collections import Dict
from teepay import TeePay

def main() raises:
    var teepay = TeePay()
    var metadata = Dict[String, String]()
    metadata["cart"] = "c-77"
    var session = teepay.checkout_sessions.create(
        "Order 1001", "500000", "TZS",
        description="2 x Coffee bag",
        reference="order-1001",
        metadata=metadata,
        idempotency_key="checkout-order-1001",
    )
    print(session.string("checkout_url"))   # redirect the customer here

    # Later: status becomes "paid" only after TeePay verified the payment.
    var latest = teepay.checkout_sessions.retrieve(session.string("id"))
    if latest.string("status") == "paid":
        print(latest.string("payment.reference"))

from teepay import ControlNumberCustomer, PayoutDestination, PayoutMoney, TeePay

def main() raises:
    var teepay = TeePay()
    var number = teepay.control_numbers.create(
        "bill",
        ControlNumberCustomer(name="Asha Juma", phone="0712345678"),
        description="School fees, term 1",
        amount_minor="5000000",
        idempotency_key="invoice-2026-0077",
    )
    if number.last_response.status == 202:   # still being issued
        pass  # call create again later with the SAME idempotency_key

    var quote = teepay.disbursements.quote(
        PayoutMoney(2500000, "TZS"),           # payout quotes take an integer amount
        PayoutDestination.mobile("Juma Ali", "255712345678"),
        "Supplier payment October",
    )
    var payout = teepay.disbursements.create(quote.string("id"), idempotency_key="payout-2026-10-0001")
    print(payout.string("status"))

payment.string("money.currency")           # "TZS" ("" if missing)
payment.integer("money.amount_minor")      # 500000 (JSON numbers or digit strings)
caps.boolean("features.checkout_sessions") # True only for JSON true
page.string("items.0.public_reference")    # list indexes work too
payment.has("fee")                         # present and not null
payment["status"]                          # the raw PythonObject
payment.get("money")                       # raw value at a path
payment.to_json()                          # the whole object as JSON text

var page = teepay.collections.list(limit=50, status="succeeded")
for item in page.items():                     # `items`, or `data` for Control Numbers
    print(item["public_reference"])
var cursor = page.next_cursor()               # "" on the last page

for row in teepay.collections.list_all(status="succeeded"):   # follows next_cursor
    print(row["public_reference"])

from std.collections import Dict
from teepay import verify_webhook

def handle(raw_body: String, headers: Dict[String, String], secret: String) -> Int:
    try:
        var event = verify_webhook(raw_body, headers, secret)
        if event.event == "payment.completed":
            print("paid:", event.string("data.reference"))   # de-duplicate on event.id
        return 200
    except e:
        return 400   # e.kind == "webhook_verification_error"

try:
    _ = teepay.collections.create(...)
except e:                        # e is a TeePayError
    if e.is_validation():        # 400/422: e.code is invalid_request, unsupported_market, ...
        print(e.code, e.message)
    elif e.is_account_restricted():
        print("contact TeePay support")
    elif e.is_permission():      # 403 scope_denied / access_denied
        ...
    elif e.is_rate_limit():      # 429 after retries; wait e.retry_after seconds
        ...
    elif e.is_connection():      # network error or timeout: the payment may still exist
        ...                      # retry with the SAME idempotency key, or read it
    else:
        print(e.status, e.code, e.request_id)

var teepay = TeePay(timeout=20.0, max_retries=3)
_ = teepay.collections.retrieve("TP8K2M4QZ1", timeout=5.0, max_retries=0)   # per request

var info = payment.last_response
info.status                # 202
info.request_id            # for support
info.has_rate_limit        # True when RateLimit-* headers were sent
info.rate_limit.remaining  # e.g. 117 (-1 when a header was absent)
info.idempotent_replayed   # True when TeePay replayed an earlier result
info.api_version           # TeePay-Version response header
info.headers               # all headers (Python dict, lowercase names)