Skip to content

Commit 6046d45

Browse files
committed
[Portal] Universal Bridge Docs (#6421)
CORE-0000 <!-- start pr-codex --> --- ## PR-Codex overview This PR focuses on renaming and updating the documentation related to `thirdweb Pay`, transitioning to the `Universal Bridge` terminology. It enhances clarity and alignment with the new features and guides for web3 payments. ### Detailed summary - Updated titles and descriptions in various `.mdx` files to reflect `Universal Bridge`. - Changed sidebar navigation names and links to align with `Universal Bridge`. - Revised content in `page.mdx` files to include new functionalities and guides. - Added sections on fee sharing and supported chains in the `Overview` documentation. - Modified FAQ entries to clarify `Universal Bridge` specifics. > ✨ Ask PR-Codex anything about this PR by commenting with `/codex {your question}` <!-- end pr-codex -->
1 parent f1d3226 commit 6046d45

File tree

6 files changed

+112
-114
lines changed

6 files changed

+112
-114
lines changed

apps/portal/src/app/connect/pay/faqs/page.mdx

Lines changed: 28 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,39 @@
1-
import { createMetadata } from "@doc";
1+
import { createMetadata, Details } from "@doc";
22

33
export const metadata = createMetadata({
44
image: {
5-
title: "thirdweb Pay - FAQs",
5+
title: "thirdweb Universal Bridge - FAQs",
66
icon: "thirdweb",
77
},
8-
title: "thirdweb Pay - FAQs - thirdweb",
9-
description: "thirdweb Pay - Frequently Asked Questions",
8+
title: "thirdweb Universal Bridge - FAQs - thirdweb",
9+
description: "thirdweb Universal Bridge - Frequently Asked Questions",
1010
});
1111

1212
# FAQs
1313

14-
### What are the fees for Buy With Fiat?
15-
14+
<Details summary="What are the fees for Buy With Fiat?">
1615
thirdweb takes a 1% fee on all Buy With Fiat transactions. Additional processing fees will depend on the selected onramp vendor.
16+
</Details>
1717

18-
### What are the fees for Buy With Crypto?
19-
18+
<Details summary="What are the fees for Buy With Crypto?">
2019
thirdweb takes a 1% fee on all Buy With Crypto transactions.
20+
</Details>
2121

22-
### How does fee sharing work for Buy With Crypto?
23-
22+
<Details summary="How does fee sharing work for Buy With Crypto?">
2423
thirdweb shares 70% of all fees collected through Buy With Crypto with our developers. Fee sharing is not currently available for Buy With Fiat transactions.
24+
</Details>
2525

26-
### What does the term “network fees” refer to?
27-
26+
<Details summary="What does the term “network fees” refer to?">
2827
Network fees, also referred to as miner fees, are paid to the miner for processing crypto transactions and securing the respective network. These fees do not go to thirdweb.
28+
</Details>
2929

30-
### What are your transaction limits for Buy With Fiat?
31-
30+
<Details summary="What are your transaction limits for Buy With Fiat?">
3231
We currently require a $1 minimum purchase for both stablecoin and non-stablecoin purchases through Buy With Fiat.
3332

3433
Our transaction maximum starts from $1500 per week for new users and can increase over time to $10,000 per week.
34+
</Details>
3535

36-
### What countries does Buy With Fiat support?
37-
36+
<Details summary="What countries does Buy With Fiat support?">
3837
**Buy With Fiat** is available 130+ countries. The following countries are _UNSUPPORTED_:
3938

4039
- Afghanistan
@@ -60,9 +59,9 @@ Our transaction maximum starts from $1500 per week for new users and can increas
6059
- Yemen
6160

6261
All United States are supported, excluding Hawaii.
62+
</Details>
6363

64-
### Does thirdweb offer direct onramping to tokens through Buy With Fiat?
65-
64+
<Details summary="Does thirdweb offer direct onramping to tokens through Buy With Fiat?">
6665
We offer direct onramping **internationally** to the following tokens:
6766

6867
- Mainnet (Ethereum)
@@ -80,19 +79,22 @@ We offer direct onramping to the following tokens in the **US only**:
8079
All other tokens will require an additional Buy With Crypto step.
8180

8281
\* Not available in New York or the EU.
82+
</Details>
8383

84-
### How does KYC work with Buy With Fiat
85-
84+
<Details summary="How does KYC work with Buy With Fiat">
8685
Users will be required to complete KYC verification for their first purchase using 'Buy with Fiat.' After that, no further KYC will be needed for future purchases on the same platform.
86+
</Details>
8787

88-
### What cryptocurrencies does Pay support?
89-
88+
<Details summary="What cryptocurrencies does Pay support?">
9089
Pay can support any currency on our [supported chains](/connect/pay/supported-chains).
90+
</Details>
9191

92-
### How are cryptocurrency prices set in thirdweb Pay?
93-
92+
<Details summary="How are cryptocurrency prices set in thirdweb Pay?">
9493
Prices are set depending on the liquidity provider used to route your transaction.
94+
</Details>
9595

96-
### Does thirdweb Pay offer fiat payouts?
97-
96+
<Details summary="Does thirdweb Pay offer fiat payouts?">
9897
Fiat payouts are not currently available.
98+
</Details>
99+
100+

apps/portal/src/app/connect/pay/get-started/page.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,12 @@ import GetStartedSend from "../assets/get-started-send.png";
1010
import GetStartedEmbed from "../assets/get-started-embed.png";
1111
export const metadata = createMetadata({
1212
image: {
13-
title: "thirdweb Pay - Get Started",
13+
title: "thirdweb Universal Bridge - Get Started",
1414
icon: "thirdweb",
1515
},
16-
title: "thirdweb Pay - Buy With Fiat - thirdweb",
16+
title: "Universal Bridge Implementation Guide — thirdweb docs",
1717
description:
18-
"Get Started with Pay - Onchain Purchases Directly From Credit or Debit Card",
18+
"Learn how to implement all-in-one web3 payment solution, Universal bridge: the technical step-by-step process",
1919
});
2020

2121
# Get Started

apps/portal/src/app/connect/pay/overview/page.mdx

Lines changed: 28 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,20 @@
11
import { createMetadata, DocImage, Grid, SDKCard, FeatureCard } from "@doc";
22
import PayOverviewImage from "../assets/pay-overview.png";
3+
import SupportedChains from "../../../_images/supported-chains.png";
34

45
export const metadata = createMetadata({
56
image: {
6-
title: "thirdweb Pay",
7+
title: "thirdweb Universal Bridge",
78
icon: "thirdweb",
89
},
9-
title: "thirdweb Pay - thirdweb",
10+
title: "thirdweb Universal Bridge Docs: Web3 Payments, On-ramping, bridging & swapping",
1011
description:
11-
"thirdweb Pay - Fast, flexible credit card and crypto point of sale",
12+
"Learn everything about thirdweb’s web3 payments solution, Universal Bridge. Technical docs on onramping, bridging + swapping.",
1213
});
1314

1415
# Overview
1516

16-
Pay allows your users to purchase cryptocurrencies and execute transactions with their credit card or debit card, or with any token via cross-chain routing.
17+
Universal Bridge allows your users to bridge, swap, and purchase cryptocurrencies and execute transactions with any fiat options or tokens via cross-chain routing.
1718

1819
<DocImage src={PayOverviewImage} />
1920

@@ -67,14 +68,30 @@ Pay allows your users to purchase cryptocurrencies and execute transactions with
6768

6869
</div>
6970

70-
### Use Cases
71+
## Supported Chains
7172

72-
- **Onramp funds directly into any transaction,** perfect for any of the following use cases:
73-
- **Games** selling in-game assets onchain.
74-
- **DEXes** looking to help users deposit funds.
75-
- **Staking apps** onboarding new users to their pools.
76-
- **Social apps** looking to add tipping or other paid functionality to their application.
77-
- **Non-profits** accepting donations in crypto.
73+
Universal Bridge is supported on select EVM compatible chain. To view the full list, visit [thirdweb chainlist](https://thirdweb.com/chainlist?service=pay).
74+
75+
<DocImage src={SupportedChains} />
76+
77+
## Fee Sharing
78+
79+
Thirdweb collects a 1% fee per end-user transaction and shares 70% of that fee with you. For example, on a $100 Polygon purchase, a $1.00 fee is charged—of which $0.30 is retained by thirdweb and $0.70 is remitted to you.
80+
81+
Note: Fee sharing applies only to fees from swaps and bridges; fiat purchases are excluded.
82+
83+
To enable fee sharing, simply set a recipient address in your dashboard under Team > Project > Connect > Pay in the thirdweb dashboard.
84+
85+
## Onramp providers
86+
87+
| Provider | Supported Countries |
88+
| -------- | ------------------------------------------------------------------------------------------------------- |
89+
| Transak | https://transak.notion.site/On-Ramp-Payment-Methods-Fees-Other-Details-b0761634feed4b338a69f4f186d906a5 |
90+
| Kado | https://www.kado.money/supported-countries |
91+
| Stripe | https://docs.stripe.com/crypto/onramp |
92+
93+
Specify a preferred onramp provider by setting the preferredProvider parameter in ConnectButton, PayEmbed, or Headless Integration. For details, refer to
94+
[customization](../pay/customization/connectbutton#preferredProvider) or the [API Reference for preferredProvider](/references/typescript/v5/GetBuyWithFiatQuoteParams).
7895

7996
## Integration Options
8097

apps/portal/src/app/connect/pay/testing-pay/page.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ export const metadata = createMetadata({
66
title: "thirdweb Pay - Test Mode",
77
icon: "thirdweb",
88
},
9-
title: "thirdweb Pay - Test Mode - thirdweb",
10-
description: "thirdweb Pay - Test Mode",
9+
title: "Enable Test Mode for Universal bridge — thirdweb docs",
10+
description: "Learn how to enable test mode for web3 payments with the thirdweb Universal bridge feature in our technical docs",
1111
});
1212

1313
# Enable Test Mode

apps/portal/src/app/connect/pay/webhooks/page.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@ import { createMetadata, DocImage } from "@doc";
22
import { Tabs, TabsList, TabsTrigger, TabsContent } from "@/components/ui/tabs";
33

44
export const metadata = createMetadata({
5-
title: "Webhooks | thirdweb Pay",
5+
title: "Universal Bridge Webhooks Implementation Guide — thirdweb Docs",
66
description:
7-
"Configure Pay webhooks to get notified at any point during a transaction's lifecycle.",
7+
"Learn how to set up webhooks for web3 payments with thirdweb’s Universal bridge feature: the technical docs",
88
});
99

1010
# Webhooks

apps/portal/src/app/connect/sidebar.tsx

Lines changed: 49 additions & 70 deletions
Original file line numberDiff line numberDiff line change
@@ -270,99 +270,78 @@ export const sidebar: SideBar = {
270270
// Blockchain API
271271
// TODO Overview page?
272272
{
273-
name: "Onchain Interactions",
273+
name: "Universal Bridge",
274274
isCollapsible: false,
275275
links: [
276-
// Pay
277276
{
278-
name: "Bridge & Swap",
277+
name: "Overview",
278+
href: `${paySlug}/overview`,
279+
},
280+
{
281+
name: "Get Started",
282+
href: `${paySlug}/get-started`,
283+
expanded: true,
279284
links: [
280285
{
281-
name: "Overview",
282-
href: `${paySlug}/overview`,
286+
name: "ConnectButton",
287+
href: `${paySlug}/get-started#option-1-connectbutton`,
283288
},
284289
{
285-
name: "Get Started",
286-
href: `${paySlug}/get-started`,
287-
expanded: true,
288-
links: [
289-
{
290-
name: "ConnectButton",
291-
href: `${paySlug}/get-started#option-1-connectbutton`,
292-
},
293-
{
294-
name: "Embed Pay",
295-
href: `${paySlug}/get-started#option-2-embed-pay`,
296-
},
297-
{
298-
name: "Send a Transaction",
299-
href: `${paySlug}/get-started#option-3-send-a-transaction-with-pay`,
300-
},
301-
],
290+
name: "Embed Pay",
291+
href: `${paySlug}/get-started#option-2-embed-pay`,
302292
},
303293
{
304-
name: "Supported Chains",
305-
href: `${paySlug}/supported-chains`,
306-
},
307-
{
308-
name: "Onramp Providers",
309-
href: `${paySlug}/onramp-providers`,
310-
},
311-
312-
{
313-
name: "Fee Sharing",
314-
href: `${paySlug}/fee-sharing`,
294+
name: "Send a Transaction",
295+
href: `${paySlug}/get-started#option-3-send-a-transaction-with-pay`,
315296
},
297+
],
298+
},
299+
{
300+
name: "Webhooks",
301+
href: `${paySlug}/webhooks`,
302+
},
303+
{
304+
name: "Testing Pay",
305+
href: `${paySlug}/testing-pay`,
306+
},
307+
{
308+
name: "Guides",
309+
isCollapsible: true,
316310

311+
links: [
317312
{
318-
name: "Webhooks",
319-
href: `${paySlug}/webhooks`,
313+
name: "Accept Direct Payments",
314+
href: `${paySlug}/guides/accept-direct-payments`,
320315
},
321316
{
322-
name: "Testing Pay",
323-
href: `${paySlug}/testing-pay`,
317+
name: "Build a Custom Experience",
318+
href: `${paySlug}/guides/build-a-custom-experience`,
324319
},
325-
{
326-
name: "Guides",
327-
isCollapsible: true,
320+
],
321+
},
322+
{
323+
name: "Customization",
324+
isCollapsible: true,
328325

329-
links: [
330-
{
331-
name: "Accept Direct Payments",
332-
href: `${paySlug}/guides/accept-direct-payments`,
333-
},
334-
{
335-
name: "Build a Custom Experience",
336-
href: `${paySlug}/guides/build-a-custom-experience`,
337-
},
338-
],
326+
links: [
327+
{
328+
name: "ConnectButton",
329+
href: `${paySlug}/customization/connectbutton`,
339330
},
340-
341331
{
342-
name: "Customization",
343-
isCollapsible: true,
344-
345-
links: [
346-
{
347-
name: "ConnectButton",
348-
href: `${paySlug}/customization/connectbutton`,
349-
},
350-
{
351-
name: "PayEmbed",
352-
href: `${paySlug}/customization/payembed`,
353-
},
354-
{
355-
name: "useSendTransaction",
356-
href: `${paySlug}/customization/send-transaction`,
357-
},
358-
],
332+
name: "PayEmbed",
333+
href: `${paySlug}/customization/payembed`,
359334
},
360335
{
361-
name: "FAQs",
362-
href: `${paySlug}/faqs`,
336+
name: "useSendTransaction",
337+
href: `${paySlug}/customization/send-transaction`,
363338
},
364339
],
365340
},
341+
{
342+
name: "FAQs",
343+
href: `${paySlug}/faqs`,
344+
},
366345
],
367346
},
368347
{ separator: true },

0 commit comments

Comments
 (0)