Version history

0.5.0

V2-only bill payments. Total 95 non-deprecated endpoints across 14 resource groups. Breaking: all *_v2 methods drop the suffix and the 11 deprecated v1 endpoints are removed.

• Removed the 11 deprecated v1 calls (bill-vend topup/data/electricity/cabletv/betting + v1 electricity lookup). The v2 replacements keep the plain names, e.g. vend_data_bundles_via_parent_account → POST /v2/bill/data.
• Added cabletv.fetch_cable_tv_plans (GET /v1/bill/cableTvProduct) and moved electricity_customer_lookup to GET /v2/bill/electricity/lookup.
• Generator now skips deprecated: true operations automatically.

0.4.0

Re-synced the SDK with Nomba's live OpenAPI spec. Total 104 endpoints across 14 resource groups.

• Added the 10 new /v2/bill/... vend endpoints as *_v2 methods: airtime topup + data (+4), betting (+2), cabletv (+2), electricity (+2). Nomba marks the v1 bill-vend endpoints as deprecated — both are kept, prefer *_v2 for new integrations.
• Picked up additive upstream drift in Global Payout: optional idempotencyKey on authorize_transfer/authorize_exchange, and destinationCountryIsoCode/destinationCurrency filters on fetch_payment_methods.
• Hardened the generator against the recurring spec bug where a path declares a {param} placeholder but omits it from parameters (still present for POST /v1/terminals/payment-request/{terminalId}).
• Packaging: pytest/twine moved to the dev group (runtime is httpx only); fixed deprecated SPDX license identifier so uv run/uv build work.

0.3.0

Re-synced the SDK with Nomba's published OpenAPI spec. Total 94 endpoints across 14 resource groups.

• Added the 4 missing Global Payout account endpoints: fetch_global_payout_accounts, fetch_global_payout_account, fetch_global_payout_accounts_sandbox, fetch_global_payout_account_sandbox.
• Added Nomba.revoke_token() / AsyncNomba.revoke_token() to revoke the active access token via POST /v1/auth/token/revoke.
• Added accounts.fetch_terminals_assigned_to_a_sub_account and virtual_accounts.create_virtual_account_for_a_sub_account.
• Added terminals.send_payment_request_to_terminal.
• Renamed transactions.filter_account_transactions → filter_sub_account_transactions and transfers.perform_bank_account_transfer_the_parent_account → perform_bank_account_transfer_from_the_parent_account.
• Breaking signature changes to match the current spec: airtime_data.vend_data_bundles_* now take a required product_id (amount optional); global_payout.authorize_transfer/authorize_exchange dropped auth_code; global_payout.convert_money dropped source_country_iso_code; virtual_accounts.update_a_virtual_account dropped callback_url.
• Regenerated all resource modules and response models from the bundled spec.

0.2.1

Minor improvements and bug fixes.

• Added warning when sandbox mode is enabled to inform users about disabled SSL verification.
• Updated token refresh timing (refresh 50 seconds before expiry instead of 60).
• Cleaned up literal strings in resource modules (removed unnecessary f-string prefixes).

0.2.0

New resource groups added. Total 87 endpoints across 14 resource groups.

• Added Betting resource: fetch providers, customer lookup, vend via parent/sub accounts (4 endpoints).
• Added Direct Debits resource: mandate creation, filtering, status management, and collection (6 endpoints).
• Added Global Collections resource: mobile money inflow and DRC providers (4 endpoints).
• Added Global Payout resource: cross-border transfers, currency exchange, payment methods, and institution providers (7 endpoints).
• Added missing Checkout endpoints: refund_checkout_transaction and cancel_checkout_order.
• SDK version updated to v0.2.0.

0.1.0

Initial release.

• All 64 endpoints from Nomba's OpenAPI spec, generated across 10 resource groups.
• Sync (Nomba) and async (AsyncNomba) clients.
• Typed responses via generated TypedDict models.
• Cursor pagination helpers (paginate / apaginate).
• Guided card-payment OTP/3DS flow (CardPaymentFlow).
• Webhook signature verification with replay-window protection.
• Token-fetch locking and retry-with-backoff on 429/5xx.
• Local nested request-body validation against the bundled spec.
• Bounded-concurrency helper for async fan-out calls.