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

# Tempo integration guide

## Overview

[Tempo](https://docs.tempo.xyz/) is a general-purpose blockchain optimized for payments - designed for consistent gas fees, high throughput, and developer-first features that modern payment systems demand. Tempo has been built alongside design partners including **DoorDash**, **Anthropic**, and **Klarna**, shaping the chain around the needs of high-scale, real-world payment products.

Bridge provides native Tempo support across our full product suite. If you're building on Tempo and need fiat on/off-ramps, stablecoin issuance, wallets, or payment infrastructure, you're in the right place.

## What we support

* [Virtual Accounts](https://apidocs.bridge.xyz/platform/orchestration/virtual_accounts/virtual-account) - Set up fiat accounts that settle directly to Tempo.
* [Transfers](https://apidocs.bridge.xyz/platform/orchestration/transfers/transfer) - Onramp via multiple fiat rails as a 1st party or from 3rd party businesses, offramp to any recipient.
* [Liquidation Addresses](https://apidocs.bridge.xyz/platform/orchestration/liquidation_address/liquidation_address) - Auto-convert Tempo stablecoin deposits to fiat or other crypto
* [Wallets](https://apidocs.bridge.xyz/platform/wallets/overview) - Provision and manage Tempo wallets for your users.
* [Issuance](https://apidocs.bridge.xyz/platform/issuance/overview) - Mint and redeem custom stablecoins on Tempo.
* [Cards](https://apidocs.bridge.xyz/platform/cards/overview/overview) (WIP) - Issue virtual and physical cards funded by Tempo stablecoin balances

<Note>
  Cards on Tempo are currently in development. Reach out to [sales@bridge.xyz](mailto:sales@bridge.xyz) to join the early access list!
</Note>

## Request/Response Examples

<Tabs>
  <Tab title="Wallet Creation">
    ```text Request theme={null}
    curl --request POST \
      --url https://api.bridge.xyz/v0/customers/INSERT_CUSTOMER_ID/wallets \
      --header 'Api-Key: INSERT_TEST_KEY' \
      --header 'Content-Type: application/json' \
      --header 'Idempotency-Key: INSERT_IDEMPOTENCY_KEY' \
      --data '
    {
      "chain": "tempo"
    }
    ```

    ```json Response theme={null}
    {
      "id": "40332a94-768d-495f-9f18-07286e6666666",
      "tags": [],
      "chain": "tempo",
      "address": "0xd31d9a3e463cb2e97678f3c1f88720b7c7eb01dd",
      "balances": [
        {
          "chain": "tempo",
          "balance": "0.0",
          "currency": "eurc",
          "contract_address": "0x20c0000000000000000000001621e21f71cf12fb"
        },
        {
          "chain": "tempo",
          "balance": "0.0",
          "currency": "usdc",
          "contract_address": "0x20c000000000000000000000b9537d11c60e8b50"
        }
      ],
      "created_at": "2026-03-09T19:06:40.805Z",
      "updated_at": "2026-03-09T19:06:40.805Z",
      "customer_id": "1e9ca0e3-f5d4-45d2-bfa5-07286e6665666"
    }
    ```
  </Tab>

  <Tab title="Virtual Account Creation">
    ```text Request theme={null}
    curl --request POST \
      --url https://api.bridge.xyz/v0/customers/INSERT_CUSTOMER_ID/virtual_accounts \
      --header 'Api-Key: INSERT_API_KEY' \
      --header 'Content-Type: application/json' \
      --header 'Idempotency-Key: INSERT_IDEMPOTENCY_KEY' \
      --data '
    {
      "developer_fee_percent": "0.0",
      "source": {
        "currency": "usd"
      },
      "destination": {
        "currency": "usdc",
        "payment_rail": "tempo",
        "bridge_wallet_id": "INSERT_BRIDGE_WALLET_ID"
      }
    }'
    ```

    ```json Response theme={null}
    {
      "id": "ee5dfe8b-da6e-4ef9-694e-8d4a5ac68d81",
      "status": "activated",
      "developer_fee_percent": "0.0",
      "customer_id": "1e9ca0e3-f5d4-45d2-bfa5-28682fc5cccc",
      "created_at": "2026-03-09T19:39:02.803Z",
      "source_deposit_instructions": {
        "currency": "usd",
        "bank_name": "Lead Bank",
        "bank_address": "1234 Main St., Kansas City, MO 64108",
        "bank_routing_number": "777777777",
        "bank_account_number": "777777777310",
        "bank_beneficiary_name": "John Doe",
        "bank_beneficiary_address": "123 White House, San Jose, California 951310000, US",
        "payment_rail": "ach_push",
        "payment_rails": [
          "ach_push",
          "wire"
        ]
      },
      "destination": {
        "currency": "usdc",
        "payment_rail": "tempo",
        "address": "0xe31d9a3e463cb2e97678f3c1f88720b7c7eb01ed"
      }
    }
    ```
  </Tab>

  <Tab title="Transfer Onramp">
    ```text Request theme={null}
    curl --request POST \
      --url https://api.bridge.xyz/v0/transfers \
      --header 'Api-Key: INSERT_API_KEY' \
      --header 'Content-Type: application/json' \
      --header 'Idempotency-Key: INSERT_IDEMPOTENCY_KEY' \
      --data '
    {
      "developer_fee_percent": "0.0",
      "on_behalf_of": "INSERT_CUSTOMER_ID",
      "amount": "2.01",
      "source": {
        "currency": "usd",
        "payment_rail": "ach"
      },
      "destination": {
        "currency": "usdc",
        "payment_rail": "tempo",
        "bridge_wallet_id": "#{request.bridge_wallet_id}"
      }
    }'
    ```

    ```json Response theme={null}
    {
      "id": "6ccbd781-8859-4944-8d88-66d8a0ff277b",
      "client_reference_id": null,
      "state": "awaiting_funds",
      "on_behalf_of": "485c2b50-949c-412b-928a-f56fce42330d",
      "currency": "usd",
      "amount": "2.01",
      "developer_fee": "0.0",
      "source": {
        "payment_rail": "ach",
        "currency": "usd",
        "external_account_id": null
      },
      "created_at": "2026-01-09T19:38:43.480Z",
      "updated_at": "2026-01-09T19:38:43.780Z",
      "destination": {
        "payment_rail": "tempo",
        "currency": "usdc",
        "to_address": "0xd0f43e6c8ee12ae4fe9d892c66c80dcb925f5d7c"
      },
      "receipt": {
        "initial_amount": "2.01",
        "developer_fee": "0.0",
        "exchange_fee": "0.0",
        "subtotal_amount": "2.01",
        "gas_fee": "0.0"
      },
      "developer_fee_percent": "0.0",
      "source_deposit_instructions": {
        "payment_rail": "ach_push",
        "amount": "2.01",
        "currency": "usd",
        "deposit_message": "YRRIJHASDJFOO",
        "bank_name": "Bank name",
        "bank_address": "Bank address",
        "bank_routing_number": "123456789",
        "bank_account_number": "1234567890",
        "bank_beneficiary_name": "Bank beneficiary",
        "bank_beneficiary_address": "Bank beneficiary address"
      }
    }
    ```
  </Tab>

  <Tab title="Transfer Offramp">
    ```text Request theme={null}
    curl --request POST \
      --url https://api.bridge.xyz/v0/transfers \
      --header 'Api-Key: INSERT_API_KEY' \
      --header 'Content-Type: application/json' \
      --header 'Idempotency-Key: INSERT_IDEMPOTENCY_KEY' \
      --data '
    {
      "developer_fee_percent": "0.0",
      "on_behalf_of": "INSERT_CUSTOMER_ID",
      "source": {
        "currency": "usdc",
        "payment_rail": "bridge_wallet",
        "bridge_wallet_id": "INSERT_WALLET_ID"
      },
      "destination": {
        "amount": "3.14",
        "currency": "usd",
        "payment_rail": "ach",
        "external_account_id": "INSERT_EXTERNAL_ACCOUNT_ID"
        "reference": "abcdefghijklmnopqr" // maximum 18 characters 
      }
    }'
    ```

    ```json Response theme={null}
    {
      "id": "e94b1961-cf77-44db-a66f-07981f03fb1f",
      "client_reference_id": null,
      "state": "payment_submitted",
      "on_behalf_of": "485c2b50-949c-412b-928a-f56fce42330d",
      "currency": "usd",
      "amount": "3.14",
      "developer_fee": "0.0",
      "source": {
        "payment_rail": "bridge_wallet",
        "currency": "usdc",
        "amount": "3.14",
        "from_address": "0xd0f43e6c8ee12ae4fe9d892c66c80dcb925f5d7c",
        "bridge_wallet_id": "d017bf1d-8372-4294-94ac-afd0cbc6357d"
      },
      "created_at": "2026-01-06T17:29:22.796Z",
      "updated_at": "2026-01-06T17:29:22.874Z",
      "destination": {
        "payment_rail": "ach",
        "currency": "usd",
        "amount": "3.14",
        "external_account_id": "bce9dbe4-bca7-42e0-9cc1-7482069019f1"
      },
      "receipt": {
        "initial_amount": "3.14",
        "developer_fee": "0.0",
        "exchange_fee": "0.0",
        "subtotal_amount": "3.14",
        "gas_fee": "0.0"
      },
      "developer_fee_percent": "0.0"
    }
    ```
  </Tab>

  <Tab title="Liquidation Address Creation">
    ```text Request theme={null}
      curl --request POST \
      --url https://api.bridge.xyz/v0/customers/INSERT_CUSTOMER_ID/liquidation_addresses \
      --header 'Api-Key: INSERT_API_KEY' \
      --header 'Content-Type: application/json' \
      --header 'Idempotency-Key: INSERT_IDEMPOTENCY_KEY' \
      --data '
    {
      "currency": "usdc",
      "chain": "tempo",
      "external_account_id": "INSERT_EXTERNAL_ACCOUNT_ID",
      "destination_ach_reference": "test",
      "destination_payment_rail": "ach",
      "destination_currency": "usd",
      "custom_developer_fee_percent": "0.1"
    }
    '

    ```

    ```json Response theme={null}

      {
        "id": "la_123",
        "chain": "tempo",
        "customer_id": "cust_123",
        "external_account_id": "ext_123",
        "address": "0x4d0280da2f2fDA5103914bCc5aad114743152A9c",
        "currency": "usdc",
        "state": "active",
        "created_at": "2025-11-22T21:31:30.515Z",
        "updated_at": "2025-11-22T21:31:30.515Z"
      }

    ```
  </Tab>
</Tabs>

## Complimentary Integration Support

<Tip>
  We're offering **complimentary hands-on integration assistance** to a select cohort of developers building on Tempo. Our solutions engineering team will pair with you to get from zero to production as quickly as possible.

  [**Reach out to sales@bridge.xyz**](mailto:sales@bridge.xyz) to reserve your spot — space is limited.
</Tip>

## FAQ

<AccordionGroup>
  <Accordion title="Do I need a separate Tempo account to use Bridge?">
    No. Bridge manages the Tempo network connection on your behalf. You interact exclusively with Bridge's dashboard and APIs.
  </Accordion>

  <Accordion title="I'm already integrated with Bridge on another network. How much work is Tempo?">
    Minimal. Set blockchain as `tempo` in your API calls. Webhooks, error handling, idempotency — everything else stays the same.
  </Accordion>

  <Accordion title="What currencies and stablecoins are supported on Tempo?">
    Explore supported payment routes [here](https://apidocs.bridge.xyz/get-started/introduction/what-we-support/payment-routes#route-explorer) in our docs!
  </Accordion>

  <Accordion title="When will Cards be available on Tempo?">
    Cards on Tempo are coming soon. Contact [sales@bridge.xyz](mailto:sales@bridge.xyz) to join the early access list.
  </Accordion>
</AccordionGroup>

***