> For the complete documentation index, see [llms.txt](https://docs.swapper.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.swapper.finance/getting-started/glossary.md).

# Glossary

Quick reference for the terms you'll meet across these docs and the SDK.

### Integrator

Any app embedding the Swapper widget. Identified by an `integratorId`.

### `integratorId`

Your registered integrator identity. Public: it identifies you, it doesn't authenticate you. Scopes a widget session to your config. Required by the widget, and by `/v1/quote` when you don't send an API key.

### API key

A secret key (`swp_…`) for calling [API v1](/api-v1/overview.md) from your servers, sent in the `x-swapper-api-key` header. Optional; unlocks higher rate limits and integrator fees. Created in the Integrator Dashboard. See [Authentication](/api-v1/authentication.md).

### Integrator Dashboard

The self-service portal at `https://swapper.finance/dashboard` for API keys, webhooks, allowed origins, fee payouts, usage, and your team. See [Integrator Dashboard](/integrator-dashboard/overview.md).

### Allowed origins

An opt-in list of your sites. Once set, keyless browser requests that use your `integratorId` from any other origin are rejected (`ORIGIN_NOT_ALLOWED`). See [Authentication](/api-v1/authentication.md#browser-requests-and-allowed-origins).

### Integrator fee

Your own fee on top of Swapper's, set with `fee` on `/v1/quote` (API key required) and paid out to you periodically. See [Integrator Fees](/api-v1/integrator-fees.md).

### Request id

The `X-Request-Id` header on every API response (also `requestId` in error bodies). Quote it when contacting support.

### Destination

The `dstChainId` + `dstTokenAddr` + `depositWalletAddress` triple describing what you want to receive and where. See [Core Concepts](/getting-started/core-concepts.md#destination).

### Source

Whatever the user funds with — a card payment or a token on some chain — before Swapper converts it to your destination token.

### Deposit method / deposit option

One of the funding flows: `depositWithCash` (card, "…with Fiat"), `transferCrypto` (QR, "…with QR"), or `walletDeposit` (connected wallet, "…with Wallet"). Controlled with `supportedDepositOptions`. Not to be confused with a deposit record's `method` — see [Deposit Methods](/deposit-methods/overview.md).

### Route

The computed swap/bridge path from a source to the destination, returned with the transactions to sign and the fee breakdown — by [`POST /v1/quote`](/api-v1/endpoints/quote.md).

### Deposit (record)

The unified record of a completed funding: source & destination assets, tx hashes, and lifecycle `status`. Its `method` is `onramp`, `smart_wallet`, `dex_swap`, or `relay_deposit_address` (a QR deposit address, or an API deposit address). See [Webhooks → Deposit methods](/tracking-deposits/webhooks.md#deposit-methods).

### On-ramp

A fiat-to-crypto payment (card, Apple Pay, bank transfer) provided through Swapper's on-ramp partner. Backs the `depositWithCash` method.

### Smart wallet

A per-user account-abstraction wallet (deployed via ZeroDev / EIP-7702) whose address the QR flow can show. The user holds its owner key (with a 12-word recovery phrase); Swapper holds only a scoped session key to swap what arrives (`method: smart_wallet`). It also receives card on-ramp purchases that are swept onward.

### Deposit address

An address the QR flow can show instead of a smart wallet. Funds sent there are swept and delivered to your destination (`method: relay_deposit_address`).

### Custom contract call

An extra on-chain action executed after the swap — approve, stake, wrap, provide liquidity — configured with `customContractCalls`. See [Custom Contract Calls](/widget-integration/custom-contract-calls.md).

### `ContractCallType`

How a custom call treats amounts: `DEFAULT` (0), `FULL_TOKEN_BALANCE` (1), `FULL_NATIVE_BALANCE` (2), `COLLECT_TOKEN_BALANCE` (3).

### Widget event

A `postMessage` the iframe fires to the parent page (envelope `type: "SWAPPER_EVENT"`). Names: `transaction_success`, `resize`, `close_request`. See [Widget Events](/tracking-deposits/widget-events.md).

### Webhook

A signed server-to-server HTTP callback fired when a deposit completes (`eventType: transaction.completed`). See [Webhooks](/tracking-deposits/webhooks.md).

### `X-Webhook-Signature`

The HMAC-SHA256 (Base64) signature header on webhook requests, computed over the raw body with your signing secret (set in the Integrator Dashboard). Verify it before trusting a payload.

### Base unit

The smallest integer unit of a token (wei, lamports, `1e6` for USDC). All amounts in events and webhooks are base-unit **strings**.

### Ecosystem

A family of chains that share an address/transaction format: `evm`, `solana`, `starknet`, `fast`.

### Iframe SDK — `@swapper-finance/deposit-sdk`

The package that embeds the hosted widget as an iframe, modal, or inline embed. The only package you install to integrate Swapper.

### `actionLabel`

UI wording mode: `"buy"` (default — "Buy with Fiat") or `"deposit"` ("Deposit with Fiat").

### `depositWalletAddress`

The wallet that receives the destination token. Not a Swapper-custodied account — it's yours.