# Axis

## Docs

- [Axis: Payment Infrastructure for Autonomous AI Agents](https://ifemafia.mintlify.app/introduction.md): Axis gives your AI agents a scoped wallet with real spend authority — per-transaction limits, period caps, merchant allowlists, and a full audit trail.
- [Axis Quickstart: From Signup to Live Payment in 5 Steps](https://ifemafia.mintlify.app/quickstart.md): Create a business account, provision a wallet, fund it, issue an API key, and fire your first payment — end-to-end in under 10 minutes.
- [Axis API Base URL, Request Format, and Error Handling](https://ifemafia.mintlify.app/guides/base-url-and-errors.md): Every Axis API request targets a versioned base URL. Learn the two route namespaces, standard error shape, and how to handle common HTTP status codes.
- [Authentication in Axis: Session Tokens vs. API Keys](https://ifemafia.mintlify.app/guides/auth-overview.md): Axis uses JWT session tokens for dashboard and developer UI flows, and API keys for agent-to-backend calls. Learn which to use and when.
- [Session Token Authentication for the Axis API (JWT)](https://ifemafia.mintlify.app/guides/session-auth.md): Sign up or log in to receive a 7-day JWT. Include it in the Authorization header to access all protected Axis endpoints from your frontend.
- [Axis API Keys: Authenticate Agent Payment Requests](https://ifemafia.mintlify.app/guides/api-key-auth.md): Each Axis wallet ships with a unique API key prefixed ax_live_. Pass it in the x-api-key header to authenticate payment intent requests.
- [Register your business entity with the Axis payment API](https://ifemafia.mintlify.app/guides/onboarding.md): Register a business entity to unlock wallet creation and full API access. One POST request is all it takes — or skip it if you signed up as a business.
- [How to create and manage Axis wallets for your AI agents](https://ifemafia.mintlify.app/guides/wallets.md): A wallet is a scoped spending account for one AI agent. Set per-transaction limits, period caps, expiry, and optional merchant allowlists at creation time.
- [Authorize and send payments with Axis payment intents](https://ifemafia.mintlify.app/guides/payment-intents.md): POST /api/payment-intent to debit a wallet and settle funds to a bank account. Axis checks limits, expiry, allowlist, and balance before any money moves.
- [Fund Axis wallets via dedicated virtual bank accounts](https://ifemafia.mintlify.app/guides/virtual-accounts.md): Every Axis wallet has a dedicated virtual account number. Send NGN to it to credit the wallet balance. Funding is detected via inbound webhooks.
- [Handle inbound Korapay charge.success webhooks in Axis](https://ifemafia.mintlify.app/guides/webhooks.md): Axis receives Korapay charge.success events at POST /api/webhooks to credit wallet balances. Learn the expected payload shape and how Axis processes it.
- [Fetch and display paginated wallet transaction history](https://ifemafia.mintlify.app/guides/transactions.md): Retrieve paginated transaction records for any wallet — both approved and blocked attempts — to display in your dashboard or agent activity log.
- [Query the Axis ledger for a full balance change history](https://ifemafia.mintlify.app/guides/ledger.md): The Axis ledger is an append-only record of every balance change. Each entry shows type (topup, debit, refund), amount, and running balance.
- [Inspect authorization audit events per transaction](https://ifemafia.mintlify.app/guides/audit-events.md): For every payment attempt, Axis records which authorization checks passed or failed. Use audit events to explain blocked transactions in your UI.
- [Get live wallet statistics, balance, and spend limits](https://ifemafia.mintlify.app/guides/wallet-stats.md): The stats endpoint returns a wallet's current balance, per-transaction spend limit, period spend limit, amount spent this period, and remaining allowance.
- [POST /v1/auth/signup — create a new Axis account](https://ifemafia.mintlify.app/api-reference/auth/signup.md): Create a developer or business account. Returns a JWT session token used to authenticate subsequent requests from your frontend.
- [POST /v1/auth/login — authenticate and receive a token](https://ifemafia.mintlify.app/api-reference/auth/login.md): Authenticate with email and password. Returns a JWT session token to use in the Authorization header for protected API calls.
- [POST /v1/auth/logout — end the current session](https://ifemafia.mintlify.app/api-reference/auth/logout.md): End a user session. Returns a success confirmation. Discard the JWT token on the client side after calling this endpoint.
- [POST /v1/onboarding — register a business entity](https://ifemafia.mintlify.app/api-reference/onboarding/register-business.md): Register a business to unlock wallet creation. Accepts businessName, contactEmail, and contactPhone. Returns a businessId for subsequent API calls.
- [POST /api/wallets — provision a new agent wallet](https://ifemafia.mintlify.app/api-reference/wallets/create-wallet.md): Create a scoped wallet for an AI agent. Sets per-transaction and period spend limits, expiry, and optional merchant allowlist. Returns an API key and virtual account.
- [GET /api/wallets/:walletId — fetch a single wallet](https://ifemafia.mintlify.app/api-reference/wallets/get-wallet.md): Retrieve a wallet by ID including its virtual account details, API key prefixes, and associated merchants. Useful for displaying wallet configuration.
- [GET /api/wallets/user/:userId — list all wallets for a user](https://ifemafia.mintlify.app/api-reference/wallets/get-user-wallets.md): List every wallet belonging to a user. Returns wallet configurations, virtual account details, and API key prefixes. Useful for populating a wallet management dashboard.
- [GET /api/wallets/:walletId/transactions — transaction history](https://ifemafia.mintlify.app/api-reference/wallets/wallet-transactions.md): Fetch paginated transaction records for a wallet, sorted newest first. Includes both approved and blocked attempts with decision reason fields.
- [GET /api/wallets/:walletId/ledgers — wallet ledger entries](https://ifemafia.mintlify.app/api-reference/wallets/wallet-ledger.md): Retrieve paginated ledger entries for a wallet. Each entry records a topup, debit, or refund with the resulting balance after the change.
- [GET /v1/wallets/:id/stats — wallet spending summary](https://ifemafia.mintlify.app/api-reference/wallets/wallet-stats.md): Retrieve a real-time snapshot of a wallet's balance, spend limits, and rolling-period usage. Pair with the transactions endpoint for a live agent dashboard.
- [POST /api/payment-intent — authorize and settle a payment](https://ifemafia.mintlify.app/api-reference/payments/create-payment-intent.md): Submit a payment intent to debit a wallet. Requires x-api-key header. Runs 6 authorization checks before debiting. Returns transaction and settlement details.
- [POST /api/webhooks — inbound Korapay funding events](https://ifemafia.mintlify.app/api-reference/webhooks/inbound-webhook.md): Axis receives Korapay charge.success events at this endpoint to credit wallet balances after a virtual account receives a bank transfer.