> 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/api-quick-start.md).

# API Quick Start

### Bridge 1 USDC from Base to Stellar

Base chain ID: `8453`

Stellar chain ID: `1500`

App ID (please join our discord)

API Host : <https://intentapiv4.rozo.ai/functions/v1>

<figure><img src="https://2103448998-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhuTMWMzO32xbGDjNWeOa%2Fuploads%2Fgit-blob-a0478790c537e7fe151e3d68def84e4594d5449d%2FScreenshot%202025-12-02%20at%2010.38.32%E2%80%AFAM.png?alt=media" alt=""><figcaption></figcaption></figure>

### Request

```
// Curl
curl --location --request POST 'https://intentapiv4.rozo.ai/functions/v1/payment-api' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "rozodevDemo",
    "orderId": "order_12345",
    "type": "exactIn",
    "display": {
        "title": "Order #12345",
        "currency": "USD"
    },
    "source": {
        "chainId": "8453",
        "tokenSymbol": "USDC",
        "amount": "1.00"
    },
    "destination": {
        "chainId": "1500",
        "receiverAddress": "GDFLZTLVMLR3OVO4VSODYB7SGVIOI2AS652WODBCGBUQAMXXXXXXXXXX",
        "tokenSymbol": "USDC"
    }
}'
```

### Response

```json
{
  "id": "c3564ae8-74e0-4007-a8f9-91a1d3e3c81d",
  "appId": "rozodevDemo",
  "orderId": "order_12345",
  "status": "payment_unpaid",
  "errorCode": null,
  "type": "exactIn",
  "createdAt": "2025-12-02T02:23:31.743+00:00",
  "updatedAt": "2025-12-02T02:23:31.743+00:00",
  "expiresAt": "2025-12-02T03:23:31.743+00:00",
  "display": {
    "title": "Order #12345",
    "description": null,
    "currency": "USD"
  },
  "source": {
    "chainId": "8453",
    "tokenSymbol": "USDC",
    "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1.00",
    "receiverAddress": "0x5B63758b0954fFc9D803dEC550eCB485C9c15861",
    "receiverMemo": null,
    "fee": "0.01",
    "senderAddress": null,
    "txHash": null,
    "amountReceived": null,
    "confirmedAt": null
  },
  "destination": {
    "chainId": "1500",
    "receiverAddress": "GDFLZTLVMLR3OVO4VSODYB7SGVIOI2AS652WODBCGBUQAMXXXXXXXXXX",
    "receiverMemo": null,
    "tokenSymbol": "USDC",
    "tokenAddress": "USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
    "amount": "0.99",
    "txHash": null,
    "confirmedAt": null
  }
}
```

### Routing provider (optional)

Every payment is executed on one of two rails. You can leave the choice to Rozo or ask for a rail by name with the optional `provider` field:

```json
{
  "appId": "rozodevDemo",
  "type": "exactIn",
  "provider": "auto",
  "source": { "chainId": "42161", "tokenSymbol": "USDC", "amount": "20.00" },
  "destination": { "chainId": "8453", "tokenSymbol": "USDC", "receiverAddress": "0x..." }
}
```

| `provider`       | Meaning                                                                                                      | Fee                                 |
| ---------------- | ------------------------------------------------------------------------------------------------------------ | ----------------------------------- |
| `auto` (default) | Rozo picks: our own rails for every route we serve, NEAR Intents only for routes our own rails do not cover. | whichever rail is chosen            |
| `rozo`           | Rozo's own rails.                                                                                            | your app tier (public default 0.1%) |
| `near`           | Routed through [NEAR Intents](https://near-intents.org).                                                     | flat 0.3%                           |

Notes:

* Omitting `provider` behaves exactly as before — existing integrations need no change.
* The response always echoes the **resolved** rail in `provider` (never `auto`) and in `feeInfo.provider`, so you can show users which rail and fee applied (e.g. "0.1% via Rozo" / "0.3% via NEAR Intents").
* `near` orders can currently settle only on Base (`8453`), Solana (`900`) and Stellar (`1500`). Asking for `near` on a route it cannot serve returns `400 ROUTE_NOT_SUPPORTED_BY_PROVIDER` — it is never silently downgraded.
* `near` deposit addresses are single-use and expire; never reuse one.
* Use [`GET /payment-api/payments/supported`](/start/supported-tokens-and-chains.md#live-supported-matrix) to discover which rails serve which chains and tokens.

Every create and dry-run response includes a `feeInfo` block:

```json
"feeInfo": {
  "feePercentage": "0.3%",
  "minimumFee": "$0.01",
  "provider": "near",
  "feeTier": "near-routing"
}
```