From a4b623b2cdf7d8c2e7dc289908d37b2e70a4c1f9 Mon Sep 17 00:00:00 2001 From: GigaHierz Date: Fri, 29 May 2026 17:10:54 +0100 Subject: [PATCH 1/2] Add Build with Bridge guide and ramps directory entry Adds build-on-celo/build-with-bridge.mdx covering Bridge's stablecoin orchestration APIs on Celo (transfers, virtual accounts, liquidation addresses, wallets, card issuing). Adds a Bridge entry to the ramps directory flagged as developer infrastructure rather than a consumer ramp, and registers the new page in the docs sidebar. Co-Authored-By: Claude Opus 4.7 --- build-on-celo/build-with-bridge.mdx | 93 +++++++++++++++++++++++++++++ docs.json | 1 + home/ramps.mdx | 27 +++++++++ 3 files changed, 121 insertions(+) create mode 100644 build-on-celo/build-with-bridge.mdx diff --git a/build-on-celo/build-with-bridge.mdx b/build-on-celo/build-with-bridge.mdx new file mode 100644 index 000000000..39ba79063 --- /dev/null +++ b/build-on-celo/build-with-bridge.mdx @@ -0,0 +1,93 @@ +--- +title: Build with Bridge +description: Use Bridge's stablecoin orchestration APIs to add fiat on/off ramps, virtual bank accounts, custodial wallets, and card issuance to your Celo app — without becoming a regulated financial institution yourself. +--- + +# Build with Bridge + +[Bridge](https://www.bridge.xyz) is a stablecoin orchestration platform that lets you move money between fiat and stablecoins programmatically. Acquired by Stripe in 2024, Bridge handles the regulated parts of payments — KYC/KYB, money transmission, banking relationships, fiat rails — so you can ship products on Celo without standing up that infrastructure yourself. + +Celo is a supported chain across Bridge's APIs. That means USD, EUR, MXN, BRL, GBP, and COP deposits can land as stablecoins directly on Celo, and Celo stablecoin balances can be sent out as fiat to bank accounts worldwide. + +> **Bridge is developer infrastructure, not a consumer ramp.** If you're a user looking to buy CELO or stablecoins with a card, see the [ramps directory](/home/ramps). If you're a developer building a product that needs to move fiat in or out of Celo at scale, Bridge is built for you. + +## What Bridge gives you + +Bridge exposes a composable set of APIs. Most Celo apps will use one or two of these — picking up the others as the product grows. + +* **Orchestration** — One-time and recurring transfers between fiat and stablecoins. Convert USD → USDT on Celo, USDT on Celo → MXN, USDT on Celo → USDT on another chain, etc. +* **Virtual accounts** — Issue real bank account numbers (US ACH/Wire, EUR IBAN, MXN CLABE, BRL Pix, GBP Faster Payments) to your users. Deposits auto-convert and land as stablecoins on a Celo address you specify. +* **Liquidation addresses** — Link a Celo address to a fiat destination. Stablecoins sent to that address are automatically converted and paid out to a bank account. +* **Custodial wallets** — Bridge-managed stablecoin wallets per customer, for apps that don't want to handle key management. +* **Card issuing** — Visa-powered virtual and physical cards backed by a customer's stablecoin balance, via Bridge's integration with Stripe Issuing. +* **Stablecoin issuance** — Launch your own branded stablecoin, or hold balances in **USDB** (Bridge's native stablecoin) to earn yield automatically. + +Full reference: [apidocs.bridge.xyz](https://apidocs.bridge.xyz). + +## Why this matters for Celo developers + +Three things make Bridge particularly useful in the Celo ecosystem: + +**Stablecoin-first API design.** Bridge's API is purpose-built for stablecoin flows. You don't get a generic payments API with crypto bolted on — you get primitives (transfers, virtual accounts, liquidation addresses) that match how Celo apps actually move money. + +**Compliance is a moat.** KYC/KYB, sanctions screening, transaction monitoring, and bank partnerships are the parts of payments that are slow and expensive to build. For a Celo team focused on shipping product, Bridge's biggest value isn't the API surface — it's the year of regulatory work you don't have to do yourself. + +**Pairs cleanly with Celo's fee abstraction.** If you're paying users in USDT on Celo, they can also pay gas in USDT via [fee abstraction](/build-on-celo/fee-abstraction/overview). The combination is a fully USD-denominated UX — your user never sees a native gas token, never sees a conversion step, never thinks about which chain they're on. + +## Supported assets and rails on Celo + +Refer to Bridge's [Route Explorer](https://apidocs.bridge.xyz/get-started/introduction/what-we-support/payment-routes) for the current source/destination matrix. At a high level, the assets Bridge supports on Celo are the stablecoins your users are most likely to hold — USDT, USDC, and USDB. + +**Fiat rails currently supported:** + +* ACH and Wire (USD) +* SEPA Instant and SEPA Credit (EUR) +* SPEI (MXN) +* Pix (BRL) +* Faster Payments (GBP) +* Bre-B and Bank Transfer PSE/ACH (COP, beta) + +**Important caveats:** + +* **USDT and Bridge-issued stablecoins are not available to users in the EEA** due to MiCA-related restrictions. USDC is the practical choice for EU consumer flows. +* Sending an unsupported asset to a Bridge deposit address can result in permanent loss. Always confirm the route in the Route Explorer before integrating. +* Bridge enforces per-route transaction minimums. Check them before quoting amounts to your users. + +## Common Celo developer use cases + +The patterns below map Bridge's primitives to scenarios that show up regularly in Celo product work. + +### Cross-border payments (B2B) + +A Celo-based supplier-payment app lets businesses in the US pay vendors in Mexico in MXN. Bridge issues a USD virtual account to the business. USD deposits convert to stablecoin balances on Celo. The Transfers API sends those stablecoins out as MXN via SPEI to the vendor's bank account. The business never touches crypto; the vendor receives local currency. Full walkthrough: [Cross-border payments guide](https://apidocs.bridge.xyz/get-started/guides/common-use-cases/cross-border-payments). + +### Stablecoin payouts (remittances, payroll, creator payments) + +A Celo-based app pays contractors in 20+ countries. Funds sit as stablecoins on Celo. When a contractor is paid, the app calls Transfers to convert and deliver to that contractor's local fiat rail — Pix in Brazil, SEPA in Europe, ACH in the US. + +### On-ramps for Celo dApps + +A DeFi or savings app on Celo wants users to fund their position with a bank transfer instead of forcing them through a card-based ramp. The app provisions a virtual account per user via Bridge. The user sees their own bank details inside the app, sends funds via local rails, and the deposit lands as USDT or USDC on their Celo address. + +### Treasury management for Celo-native businesses + +A Celo-based business holds operational reserves in USDT on Celo. Bridge's Transfers API lets the business move funds to fiat for vendor payments, to USDB to earn yield on idle balances, or to USDC on another chain when needed. + +## Getting started + +1. **Read the [platform overview](https://apidocs.bridge.xyz/get-started/introduction/quick-start/overview).** It explains how the Orchestration, Wallets, Issuance, Cards, and Customers APIs fit together. +2. **[Set up a sandbox environment](https://apidocs.bridge.xyz/get-started/introduction/quick-start/setting-up-sandbox).** All endpoints are available in sandbox before you need any production access. +3. **Pick the right entry point** based on what you're building: + * Moving money between fiat and stablecoins → [Transfers](https://apidocs.bridge.xyz/platform/orchestration/transfers/transfer) + * Issuing fiat deposit addresses → [Virtual Accounts](https://apidocs.bridge.xyz/platform/orchestration/virtual_accounts/virtual-account) + * Auto-converting incoming crypto → [Liquidation Addresses](https://apidocs.bridge.xyz/platform/orchestration/liquidation_address/liquidation_address) + * Holding stablecoin balances for users → [Wallets](https://apidocs.bridge.xyz/platform/wallets/overview) + * Spending from stablecoin balances with a card → [Cards](https://apidocs.bridge.xyz/platform/cards/overview/overview) + +For production access or account questions, contact [support@bridge.xyz](mailto:support@bridge.xyz). + +## Related Celo resources + +* [Build with local stablecoins](/build-on-celo/build-with-local-stablecoin) — Working with Mento's local-currency stablecoins on Celo. +* [Celo Global Ramps Ecosystem](/home/ramps) — Consumer-facing on/off ramps that already support Celo. +* [Fee Abstraction](/build-on-celo/fee-abstraction/overview) — Letting users pay gas in stablecoins on Celo. diff --git a/docs.json b/docs.json index de7bb58c3..85e2d1c62 100644 --- a/docs.json +++ b/docs.json @@ -168,6 +168,7 @@ "build-on-celo/build-with-farcaster", "build-on-celo/build-with-self", "build-on-celo/build-with-local-stablecoin", + "build-on-celo/build-with-bridge", "build-on-celo/build-with-defi" ] }, diff --git a/home/ramps.mdx b/home/ramps.mdx index d7d2b0fa4..3dcf1a822 100644 --- a/home/ramps.mdx +++ b/home/ramps.mdx @@ -250,6 +250,33 @@ Below you'll find our complete network of 21+ integrated ramp providers, coverin --- +## [Bridge](https://www.bridge.xyz/) (Developer API) + +> **Developer infrastructure, not a consumer ramp.** Bridge powers other apps to add fiat on/off ramps via API rather than letting end users buy crypto directly. See [Build with Bridge](/build-on-celo/build-with-bridge) for the developer guide. + +**Countries** + +Global coverage via supported fiat rails. See the [Bridge supported countries list](https://apidocs.bridge.xyz/platform/customers/compliance/supported-countries-list). + +**Payment Method** + +- ACH and Wire (USD) +- SEPA (EUR) +- SPEI (MXN) +- Pix (BRL) +- Faster Payments (GBP) +- Bre-B and Bank Transfer PSE/ACH (COP, beta) + +**Currency** + +- USDT +- USDC +- USDB (Bridge-issued, yield-bearing) + +> USDT and Bridge-issued stablecoins are **not available to EEA users** due to MiCA restrictions. USDC is the practical choice for EU consumer flows. + +--- + ## [Cashramp](https://cashramp.co/) **Countries** From f83f9fbcd09dd8699ceadff83e2a6b074c977c00 Mon Sep 17 00:00:00 2001 From: GigaHierz Date: Mon, 1 Jun 2026 21:41:28 +0100 Subject: [PATCH 2/2] Match repo conventions: og:description frontmatter and Mintlify callouts - build-with-bridge.mdx: switch frontmatter to og:description and convert the lead-in blockquote to an callout. - home/ramps.mdx: convert the Bridge entry's two blockquotes to (developer-infrastructure note) and (EEA/MiCA caveat). Co-Authored-By: Claude Opus 4.7 --- build-on-celo/build-with-bridge.mdx | 6 ++++-- home/ramps.mdx | 8 ++++++-- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/build-on-celo/build-with-bridge.mdx b/build-on-celo/build-with-bridge.mdx index 39ba79063..e03228087 100644 --- a/build-on-celo/build-with-bridge.mdx +++ b/build-on-celo/build-with-bridge.mdx @@ -1,6 +1,6 @@ --- title: Build with Bridge -description: Use Bridge's stablecoin orchestration APIs to add fiat on/off ramps, virtual bank accounts, custodial wallets, and card issuance to your Celo app — without becoming a regulated financial institution yourself. +og:description: Use Bridge's stablecoin orchestration APIs to add fiat on/off ramps, virtual bank accounts, custodial wallets, and card issuance to your Celo app — without becoming a regulated financial institution yourself. --- # Build with Bridge @@ -9,7 +9,9 @@ description: Use Bridge's stablecoin orchestration APIs to add fiat on/off ramps Celo is a supported chain across Bridge's APIs. That means USD, EUR, MXN, BRL, GBP, and COP deposits can land as stablecoins directly on Celo, and Celo stablecoin balances can be sent out as fiat to bank accounts worldwide. -> **Bridge is developer infrastructure, not a consumer ramp.** If you're a user looking to buy CELO or stablecoins with a card, see the [ramps directory](/home/ramps). If you're a developer building a product that needs to move fiat in or out of Celo at scale, Bridge is built for you. + + **Bridge is developer infrastructure, not a consumer ramp.** If you're a user looking to buy CELO or stablecoins with a card, see the [ramps directory](/home/ramps). If you're a developer building a product that needs to move fiat in or out of Celo at scale, Bridge is built for you. + ## What Bridge gives you diff --git a/home/ramps.mdx b/home/ramps.mdx index 3dcf1a822..9ecff7788 100644 --- a/home/ramps.mdx +++ b/home/ramps.mdx @@ -252,7 +252,9 @@ Below you'll find our complete network of 21+ integrated ramp providers, coverin ## [Bridge](https://www.bridge.xyz/) (Developer API) -> **Developer infrastructure, not a consumer ramp.** Bridge powers other apps to add fiat on/off ramps via API rather than letting end users buy crypto directly. See [Build with Bridge](/build-on-celo/build-with-bridge) for the developer guide. + + **Developer infrastructure, not a consumer ramp.** Bridge powers other apps to add fiat on/off ramps via API rather than letting end users buy crypto directly. See [Build with Bridge](/build-on-celo/build-with-bridge) for the developer guide. + **Countries** @@ -273,7 +275,9 @@ Global coverage via supported fiat rails. See the [Bridge supported countries li - USDC - USDB (Bridge-issued, yield-bearing) -> USDT and Bridge-issued stablecoins are **not available to EEA users** due to MiCA restrictions. USDC is the practical choice for EU consumer flows. + + USDT and Bridge-issued stablecoins are **not available to EEA users** due to MiCA restrictions. USDC is the practical choice for EU consumer flows. + ---