# MoonPay Enterprise > MoonPay Enterprise is a set of Stablecoin APIs for on-chain banking, payments, money transfers, and treasury management. Fiat-to-stablecoin and stablecoin-to-fiat infrastructure for businesses. MoonPay Enterprise runs several banking partners in the background, providing redundancy and fallback if a bank cannot process a customer or an industry. A customer onboarded with a banking partner always keeps their named account. MoonPay Enterprise is a MoonPay company. - **Authentication**: All API requests require a valid API key included in the `X-API-Key` header. Keys are created and managed in the Partner Dashboard under Developer → API Keys. - **Rate Limits**: MoonPay Enterprise implements per-API-key rate limits and infrastructure-level protections. Exceeding limits returns HTTP 429. Use exponential backoff for retries. Contact support for high-volume needs. - **Environments**: Two environments are available. Sandbox (`api.sandbox.iron.xyz`) for testing and Production (`api.iron.xyz`) for live operations. - **Idempotency**: Every `POST` under `/api` requires an `Idempotency-Key` header with a unique UUID. A missing key returns 400. `PUT`, `PATCH`, and `DELETE` are not deduplicated. MoonPay Enterprise stores successful responses only, so a retry after an error runs the request again. Same key with a different body or path returns 409. Keys never expire. - **Versioning**: The API is versioned by date via the optional `X-API-Version` header (for example `2026-07-01`). Routes are not versioned. Omitting the header serves the default version, `2025-03-13`. `GET /spec/versions` lists supported versions and where to fetch each version's OpenAPI spec. Spec routes are unauthenticated and served from both environments. ## Authentication & Setup - [Introduction](https://dev.enterprise.moonpay.com/overview.md): MoonPay Enterprise developer portal landing page. Overview of products (Onramp, Offramp, Stable to Stable, Stablecoin Issuance, Wallets) and how to start integrating. Several banking partners in the background provide redundancy and fallback. - [Authentication](https://dev.enterprise.moonpay.com/authentication.md): Authenticate MoonPay Enterprise API requests using the X-API-Key header. Includes example requests, 401 error handling, and common troubleshooting steps. - [API Access](https://dev.enterprise.moonpay.com/api-access.md): Obtain and manage API keys for authenticating with the MoonPay Enterprise API. Covers Sandbox and Production environments, key creation, and permissions. - [Idempotency](https://dev.enterprise.moonpay.com/idempotency.md): Use the Idempotency-Key header to replay a POST safely. Covers what MoonPay Enterprise caches, what it does not, and why a retry after an error runs again. - [API Versions](https://dev.enterprise.moonpay.com/versioning.md): Select an API version with the X-API-Version header. Covers the default version, supported versions, per-version OpenAPI specs, and version rejection errors. - [Changelog](https://dev.enterprise.moonpay.com/changelog.md): What changed in each API version, newest first. Endpoints affected, whether request or response, and migration notes. - [CLI](https://dev.enterprise.moonpay.com/cli.md): Access MoonPay Enterprise via the MoonPay CLI (mp). Manage virtual accounts, onramps, KYC verification, wallets, and more from the terminal. ## Dashboard - [Dashboard Overview](https://dev.enterprise.moonpay.com/partner-dashboard.md): Web UI for managing partners, customers, API keys, webhooks, routes, and compliance workflows at app.enterprise.moonpay.com. Covers the Dashboard and App views and what each screen does. - [Sandbox](https://dev.enterprise.moonpay.com/sandbox.md): Test your MoonPay Enterprise integration against api.sandbox.iron.xyz. Covers sandbox access, differences from production, and simulating transactions. - [Ops and Customer Service](https://dev.enterprise.moonpay.com/ops-and-customer-service.md): Unblock a stalled customer from the dashboard Compliance Review panel: read outstanding requirements and reject reasons, share a KYC and terms link, upload replacement documents, trigger EDD. Includes the endpoint behind each action. ## Core API (Autoramp) - [Autoramp](https://dev.enterprise.moonpay.com/autoramp.md): Create standing conversion rules between fiat, crypto, and cross-chain assets. The core primitive powering onramp, offramp, and swap flows. - [Autoramp Status](https://dev.enterprise.moonpay.com/autoramp-status.md): Interpret autoramp lifecycle statuses: Created, EditPending, Authorized, DepositAccountAdded, Approved, Rejected, Cancelled. Deposit rails are populated at DepositAccountAdded but only verified at Approved. - [Quotes](https://dev.enterprise.moonpay.com/quotes.md): Lock an exchange rate before creating an Autoramp, and attach further quotes to a running one via `POST /api/autoramps/{autoramp_id}/quotes`. Covers rate locks, the `Return` and `Slippage` expiry policies, `slippage_tolerance_in_bips`, and `amount_in`/`amount_out` semantics. - [Transaction Status](https://dev.enterprise.moonpay.com/transaction-status.md): Track transaction lifecycle from FundsReviewInProgress through Completed or Failed. - [Limits and Minimums](https://dev.enterprise.moonpay.com/limits-and-minimum.md): Transaction spending limits and minimum amounts per risk tier. Tier 1 limits are 52-week rolling and apply per direction, tracked separately for fiat onramp and crypto offramp. Business customers (KYB) have no enforced limit. Covers verification requirements and minimum transaction sizes. ## Tutorials - [Onramp](https://dev.enterprise.moonpay.com/onramp.md): Create a named virtual fiat account in USD, EUR, or GBP that settles into stablecoins in your wallet. Covers onboarding, autoramp routes, quotes, deposit rails, and webhook monitoring. - [Offramp](https://dev.enterprise.moonpay.com/offramp.md): Create a liquidation address that accepts stablecoins and settles in fiat into a bank account. Covers exact-out quotes and standing autoramp routes. - [Stable to Stable](https://dev.enterprise.moonpay.com/stable-to-stable.md): Setup a stables swap channel. Send Stablecoin 1 and receive Stablecoin 2 across chains, via a standing autoramp or an exact-out quote. ## Issuance - [Create your Stablecoin](https://dev.enterprise.moonpay.com/issuance/create-your-stablecoin.md): Launch, manage, and scale a branded stablecoin with MoonPay as a fully regulated US issuer. - [Mint, Redeem and Swap](https://dev.enterprise.moonpay.com/issuance/mint-redeem-swap.md): Move between your stablecoin and USD, USDC, and USDT. - [Reserve Management and Rewards](https://dev.enterprise.moonpay.com/issuance/reserves-and-rewards.md): How MoonPay manages stablecoin reserves and how to claim reserves for your stablecoin. - [PYUSDx](https://dev.enterprise.moonpay.com/issuance/pyusdx.md): DeFi-oriented issuance platform from MoonPay and M0, built with PayPal. Launch a stablecoin backed 1:1 by PYUSD, with programmable rewards and shared liquidity. - [Stablecoin FAQ](https://dev.enterprise.moonpay.com/issuance/faq.md): Common questions about issuance, reserves, rewards, and conversions. ## Wallets - [Wallet as a Service](https://dev.enterprise.moonpay.com/wallet/wallet-as-a-service.md): MoonPay WaaS, self-custodial embedded wallets with 2-of-2 MPC signing. Create wallets on Ethereum/EVM, Solana, and Tron, import and export keys, delegate signing to scoped agents, and fund via card onramp or cash out to fiat. A separate integration with its own SDK and credentials, not part of the MoonPay Enterprise API. SDK docs at https://x-docs.moonpay.com. ## Onboarding & Compliance - [Onboarding Lifecycle](https://dev.enterprise.moonpay.com/onboarding.md): End-to-end onboarding flow for partners and customers. Covers customer creation, terms and conditions, identification, status tracking, and activation. - [Roles & Entities](https://dev.enterprise.moonpay.com/roles-entities.md): Organizational roles and entity types within MoonPay Enterprise. Covers partners, customers, users, and their relationships and permissions. - [Individual KYC](https://dev.enterprise.moonpay.com/kyc.md): KYC requirements for onboarding individual customers. Covers standard, enhanced, and high-risk verification tiers with required documents. - [Business KYB](https://dev.enterprise.moonpay.com/kyb.md): Onboard business customers using MoonPay Enterprise's hosted Link flow or the programmatic Business API. - [Hosted Identification](https://dev.enterprise.moonpay.com/hosted.md): The simplest identification method. Create an identification with type Link and receive a URL to pass to your customer for completing verification. - [Outsourcing Identification](https://dev.enterprise.moonpay.com/outsourcing.md): Provide identification data on your customers directly to MoonPay Enterprise's API instead of using our verification providers. - [SumSub Token Sharing](https://dev.enterprise.moonpay.com/reliance-kyc-token-sharing.md): Share existing SumSub KYC data with MoonPay Enterprise to onboard verified applicants in seconds. - [Identification Errors](https://dev.enterprise.moonpay.com/errors.md): Machine-readable error codes returned by `POST /api/customers/{id}/identifications/v2` when a Business, Person, or Token submission fails validation. A structured array under `X-API-Version: 2026-08-01` or later; earlier versions return the plain error string. - [Proof of Address](https://dev.enterprise.moonpay.com/proof-of-address.md): When proof of address (POA) is required, accepted documents, and criteria. All documents must be under 3 months old; IDs are not accepted for proof of address. - [Source of Wealth](https://dev.enterprise.moonpay.com/source-of-wealth.md): When source of wealth (SOW) is required, accepted documents by source, and acceptance criteria. - [2FA](https://dev.enterprise.moonpay.com/2fa.md): Email-based two-factor authentication for sensitive operations: editing an Autoramp destination address, registering a fiat address that needs authorization, reusing an existing vIBAN, and changing a customer's email. The entity enters `AuthorizationRequired` until the customer confirms. ## Addresses & Travel Rule - [Crypto Addresses](https://dev.enterprise.moonpay.com/crypto-addresses.md): Register wallet addresses for Travel Rule compliance before using them in any Autoramp flow. Supports self-hosted and hosted wallets. - [Fiat Addresses](https://dev.enterprise.moonpay.com/fiat-addresses.md): Register and manage bank accounts for payouts. Supports multiple payment rails including SEPA, ACH, Wire, and SWIFT. - [Travel Rule](https://dev.enterprise.moonpay.com/travel-rule.md): Overview of the Travel Rule, when it applies, and steps to ensure compliance for crypto transfers. ## Webhooks & Events - [Webhooks](https://dev.enterprise.moonpay.com/webhooks.md): Subscribe to event notifications for transactions, autoramp status, customer status, customer fiat abilities, and identification changes. HMAC-SHA256 signature verification following the Standard Webhooks spec. ## Billing & Settlement - [Fees and Invoices](https://dev.enterprise.moonpay.com/fees-and-invoices.md): Fee structures for MoonPay Enterprise transactions including transaction fees, banking fees, and network fees. Covers fee profiles and invoicing. - [End of Day Settlement](https://dev.enterprise.moonpay.com/end-of-day-settlement.md): Batch fiat payouts into a single daily settlement instead of paying out each transaction individually. ## Coverage & Supported Assets - [Countries](https://dev.enterprise.moonpay.com/country.md): Supported onboarding countries organized by risk tier. Covers OFAC restrictions, country risk ratings, fiat rail availability, and virtual account eligibility. - [Currencies](https://dev.enterprise.moonpay.com/currencies.md): Supported currencies and their availability for onramp, offramp, and swap transactions. - [Blockchains](https://dev.enterprise.moonpay.com/stablecoins-and-blockchains.md): Supported blockchains and stablecoins including Ethereum, Solana, Arbitrum, Base, Polygon, and tokens like USDC, USDT, EURC. - [Payment Methods](https://dev.enterprise.moonpay.com/fiat-payment-methods.md): Supported payment rails and virtual accounts including SEPA, ACH, FedNow, Wire, and SWIFT. Several banking partners in the background provide redundancy and fallback. - [Integration Models](https://dev.enterprise.moonpay.com/integration-models.md): MoonPay Enterprise supports B2B, B2B2B, and B2B2C setups. Integrate via API, the Partner Dashboard, or offer MoonPay Enterprise App as a whitelabel frontend. ## API Reference - [OpenAPI Specification (YAML)](https://dev.enterprise.moonpay.com/spec.yaml): Full MoonPay Enterprise API OpenAPI specification, latest surface. All endpoints, schemas, and authentication. - Spec routes (`/spec`, `/spec/`, `/spec/versions`) are served unauthenticated from **both** environments: `https://api.sandbox.iron.xyz` and `https://api.iron.xyz`. The per-version links below use sandbox; swap the host for the production document, which declares the production server and omits the `/sandbox/*` simulation endpoints. - [OpenAPI Specification, version 2026-08-01](https://api.sandbox.iron.xyz/spec/2026-08-01): Frozen OpenAPI specification for API version 2026-08-01. Request it with the header `X-API-Version: 2026-08-01`. - [OpenAPI Specification, version 2026-07-01](https://api.sandbox.iron.xyz/spec/2026-07-01): Frozen OpenAPI specification for API version 2026-07-01. Request it with the header `X-API-Version: 2026-07-01`. - [OpenAPI Specification, version 2025-03-13](https://api.sandbox.iron.xyz/spec/2025-03-13): Frozen OpenAPI specification for API version 2025-03-13. Request it with the header `X-API-Version: 2025-03-13`. This is the default version, served when no `X-API-Version` header is sent. ## Support - [Support](https://dev.enterprise.moonpay.com/support.md): Contact information, support channels, and how to get help with MoonPay Enterprise integration.