> For the complete documentation index, see [llms.txt](https://docs.rozo.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rozo.ai/integration/api-doc/bridge-api.md).

# Bridge & Wallet API

Bridge & Wallet API. Move funds cross-chain by specifying the destination address yourself: bridging, wallet top-up, and smart account payments.

Use this API when **you provide the destination address on every request**: bridging your own funds, topping up a wallet, or paying an arbitrary on-chain address.

Every payment request includes a `destination.receiverAddress`, and ROZO routes the funds cross-chain to it.

Register a Wallet app and use its Orders API key from your backend. [Make Your First API Request](/integration/api-doc/first-request.md) covers setup and the example client.

## Pages

* [API Quick Start](/integration/api-doc/bridge-api/api-quick-start.md): quote, create and track a Base USDC to Stellar transfer.
* [Wallet Top-up](/integration/api-doc/bridge-api/wallet-topup.md): `anyAmount` deposits: send any amount, the system detects it automatically.
* [Get Fees](/integration/api-doc/bridge-api/get-fees.md): preview fees with `dryrun=true` before creating a payment.
* [Stellar Smart Account Payments](/integration/api-doc/bridge-api/stellar-contract-payments.md): pay from Soroban contract addresses (C-addresses) to EVM and Solana.
* [Funding API](/integration/api-doc/bridge-api/funding.md): one USDC or USDT payment opens a Stellar wallet with USDC and XLM in one signature ([Open a Stellar Wallet](/integration/api-doc/bridge-api/funding/stellar-wallet-onboarding.md)) or buys XLM gas ([Buy Gas Tokens](/integration/api-doc/bridge-api/funding/buy-gas-tokens.md)). No API key needed. Gas plus a stablecoin on other chains ([Gas + Stablecoin Funding](/integration/api-doc/bridge-api/funding/gas-plus-stablecoin.md)) is available on request.

## Webhooks

Bridge and wallet apps get the same [Webhook](/integration/api-doc/merchant-api/webhook.md) notifications (`payment_payin_completed`, `payment_payout_completed`) as merchants: register your app on [partners.rozo.ai](https://partners.rozo.ai) (you'll get a `wallet_<slug>` appId) and configure your webhook URL there. Without a registered appId, poll the payment status instead.

## Looking to accept payments instead?

If you are a merchant with a **preconfigured receiving wallet** (no destination address needed per request), use the [Merchant API](/integration/api-doc/merchant-api.md).