# Pretium

> API documentation for Pretium payment rails — offramp, onramp, checkout, and MCP for AI agents in Cursor, Claude, and ChatGPT.

## Docs

- [Introduction](https://docs.xwift.africa/index.md): Pretium — move value between stablecoins and African fiat rails.
- [Onboarding process](https://docs.xwift.africa/onboarding.md): Apply for a Pretium partner account and get API credentials.
- [Quickstart](https://docs.xwift.africa/quickstart.md): Authenticate and fetch an exchange rate in a few minutes.
- [Authentication](https://docs.xwift.africa/authentication.md): API keys and checkout keys for Pretium.
- [Errors](https://docs.xwift.africa/errors.md): Standard error envelope and common failure modes.
- [Webhooks](https://docs.xwift.africa/webhooks.md): Outbound callbacks for transaction and checkout status.
- [Networks](https://docs.xwift.africa/networks.md): Blockchain networks and stablecoin assets supported by Pretium.
- [MNOs](https://docs.xwift.africa/mnos.md): Mobile network operators and bank rails supported by Pretium per country.
- [Limits](https://docs.xwift.africa/limits.md): Per-transaction amount limits by country and mobile money for pay (offramp) and onramp.
- [Fee](https://docs.xwift.africa/fee.md): Collect a partner facilitation fee on collection, disbursement, offramp, and onramp requests.
- [Offramp](https://docs.xwift.africa/guides/offramp.md): Convert on-chain stablecoin deposits into local fiat payouts. Amount limits are per transaction.
- [Onramp](https://docs.xwift.africa/guides/onramp.md): Collect local fiat and settle stablecoins to a wallet. Amount limits are per transaction.
- [Checkout](https://docs.xwift.africa/guides/checkout.md): Hosted settlement flow using your checkout key.
- [AI agents (MCP)](https://docs.xwift.africa/guides/agents.md): Add Pretium as an MCP server in Cursor, Claude, or ChatGPT so agents can pay across African rails.
- [Collection & disbursements](https://docs.xwift.africa/guides/collection-and-disbursements.md): Wallet-funded collection and disbursement under currency prefixes.
- [API overview](https://docs.xwift.africa/api-reference/overview.md): Conventions shared across Pretium endpoints.
- [Account detail](https://docs.xwift.africa/api-reference/account/detail.md): Partner profile, wallets, networks, and checkout key.
- [Wallet balance](https://docs.xwift.africa/api-reference/account/wallet.md): Fiat wallet balance for a country.
- [Fund wallet](https://docs.xwift.africa/api-reference/account/fund.md): Get FX rate and settlement wallets for topping up a fiat wallet with crypto.
- [Fund confirm](https://docs.xwift.africa/api-reference/account/fund-confirm.md): Verify an on-chain deposit and credit the partner fiat wallet.
- [Countries](https://docs.xwift.africa/api-reference/account/countries.md): List countries available to the partner.
- [Networks](https://docs.xwift.africa/api-reference/account/networks.md): Supported blockchain networks and assets.
- [Get transaction](https://docs.xwift.africa/api-reference/account/transaction.md): Fetch one transaction by code under a country namespace.
- [List account transactions](https://docs.xwift.africa/api-reference/account/transactions.md): List transactions for a country with optional date filters.
- [Account FX convert](https://docs.xwift.africa/api-reference/account/exchange-rate.md): Convert an amount using selling or buying rate direction.
- [Exchange rate](https://docs.xwift.africa/api-reference/rates/exchange-rate.md): Get buying and selling FX rates for a currency.
- [Exchange rate (v2)](https://docs.xwift.africa/api-reference/rates/exchange-rate-v2.md): FX rates plus onramp/offramp availability flags.
- [Validation](https://docs.xwift.africa/api-reference/payments/validation.md): Validate a mobile money shortcode or bank account before payout.
- [Pay (offramp)](https://docs.xwift.africa/api-reference/payments/pay.md): Verify an on-chain transfer and disburse local fiat. Amount limits are per transaction.
- [Onramp](https://docs.xwift.africa/api-reference/payments/onramp.md): Collect fiat via mobile money and release stablecoins to an address. Amount limits are per transaction.
- [Transaction status](https://docs.xwift.africa/api-reference/payments/status.md): Look up a single transaction by transaction_code.
- [List transactions](https://docs.xwift.africa/api-reference/payments/transactions.md): List recent transactions for a currency (optional date window).
- [Supported banks](https://docs.xwift.africa/api-reference/payments/banks.md): List supported banks for a currency (defaults to NGN).
- [Refund](https://docs.xwift.africa/api-reference/payments/refund.md): Initiate a refund/credit flow against a verified on-chain hash.
- [List banks](https://docs.xwift.africa/api-reference/banks/banks.md): List banks supported for a currency.
- [Bank info](https://docs.xwift.africa/api-reference/banks/bank-info.md): Resolve a bank account number to the registered account name.
- [Bank transfer](https://docs.xwift.africa/api-reference/banks/bank-transfer.md): Settle a wallet-funded disbursement to a recipient bank account.
- [Create checkout](https://docs.xwift.africa/api-reference/checkout/create.md): Create a short-lived settlement order.
- [Checkout status](https://docs.xwift.africa/api-reference/checkout/status.md): Get checkout order status by order_id.
- [Confirm checkout payment](https://docs.xwift.africa/api-reference/checkout/pay.md): Submit the on-chain hash that settles a checkout order.
- [Checkout networks](https://docs.xwift.africa/api-reference/checkout/networks.md): List networks available for checkout settlement.
- [Collection & disbursement](https://docs.xwift.africa/api-reference/countries/collection-and-disbursement.md): Wallet-funded collect and disburse under a currency prefix — same shape as offramp/onramp without transaction_hash.