> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polygon.technology/llms.txt
> Use this file to discover all available pages before exploring further.

# Cross-chain payments, swaps, bridging, deposits, and actions

> One Open Money Stack API for cross-chain payments, swaps, bridging, deposits, and composable onchain actions. Route customer funds from any token on any chain to any destination in one user action.

OMS includes a cross-chain orchestration layer that handles payments, swaps, bridging, deposits, and composable onchain actions through a single API. It solves a coordination problem that appears in nearly every modern fintech product: the funds a customer has available are rarely on the same network, in the same token, or at the same address as the destination where they need to land.

Without orchestration, your team builds per-corridor integrations, manual bridging steps, or asks users to acquire the right asset before they can use your product. Cross-chain replaces that with a single API that handles routing, conversion, and execution automatically.

## The routing problem

A customer might hold dollars in their bank, USDC on Ethereum, or a balance on Coinbase. Your product might require funds in USDC on Polygon, or in a yield vault on Base, or in stablecoins settling on Arbitrum. Getting from one to the other typically requires multiple transactions, multiple approvals, and manual coordination.

Cross-chain payment orchestration handles the entire path in a single customer action. The customer expresses what they want to do; the routing layer figures out how to do it.

## What it handles automatically

* **Routing**: finding the best path across chains and liquidity sources
* **Conversion**: exchanging tokens at the route level, not as a separate user step
* **Gas**: abstracting network fee payment so users never need native gas tokens
* **Fiat on-ramps**: accepting card, bank transfer, and Apple Pay as funding sources alongside crypto

## Supported funding sources

| Source               | Description                                                  |
| -------------------- | ------------------------------------------------------------ |
| Bank account / ACH   | Direct bank transfer via ACH or wire                         |
| Debit or credit card | Visa and Mastercard, globally                                |
| Apple Pay            | One-tap payment from the Apple Pay sheet                     |
| Exchange account     | Fund directly from a Coinbase, Binance, or Kraken balance    |
| Crypto wallet        | Any EVM wallet; any supported token on any supported network |

## How a payment flows

1. Your product calls `QuoteIntent` with the customer's funding source and the desired destination.
2. The API returns a route with fees. The customer reviews and confirms.
3. You call `CommitIntent` to lock the quote, then `ExecuteIntent` to initiate the transfer.
4. Funds route across networks, convert tokens as needed, and deliver to the destination address.
5. If a destination action is encoded (for example, a vault deposit), that action executes automatically when funds arrive.

The customer sees one confirmation. Your product sees one API call per payment.

## What this enables

**Neobanks and fintechs**: let customers open a yield account by funding from a card or bank transfer. The conversion and deposit happen in the background.

**Banks and cross-border payments**: issue payouts to counterparties on different networks through a single orchestration layer, without building per-corridor integrations.

**Marketplaces**: pay sellers in any token on any chain through one integration, regardless of where the seller holds funds.

**Consumer apps**: onboard new users in their first session by accepting card or bank funding directly, without requiring prior crypto acquisition.

<Note>
  Cross-chain payments use a separate API key from the OMS Payments API. Get yours from the [Trails Dashboard](https://dashboard.trails.build) while the two systems share authentication.
</Note>

## Integration options

| Option         | Best for                                                       |
| -------------- | -------------------------------------------------------------- |
| Drop-in widget | Fastest integration; customizable UI with minimal code         |
| Headless SDK   | Custom UI with full routing logic and state management         |
| Direct API     | Full server-side control; build your own experience end to end |

<CardGroup cols={2}>
  <Card title="SDK quickstart" icon="bolt" href="/cross-chain/sdk/index">
    Install the SDK and drop in a payment component in under five minutes.
  </Card>

  <Card title="Accept funds from anywhere" icon="wallet" href="/cross-chain/fund">
    Configure funding sources: card, bank, exchange, and wallet.
  </Card>

  <Card title="Programmable destinations" icon="arrow-right-arrow-left" href="/cross-chain/money-actions">
    Encode a vault deposit, stake, or any product action that executes when funds arrive.
  </Card>

  <Card title="Use cases" icon="building-columns" href="/cross-chain/use-cases">
    How fintechs, neobanks, banks, and marketplaces use cross-chain payments.
  </Card>

  <Card title="Live demo" icon="play" href="https://demo.trails.build/">
    Try the widget in the sandbox.
  </Card>

  <Card title="API reference" icon="code" href="/cross-chain/api-reference/overview">
    Authentication, endpoints, and the cross-chain payment lifecycle.
  </Card>
</CardGroup>
