Revamp wallet and payments API docs and endpoints

Updated wallet and payments documentation to reflect new authentication and user management endpoints, including /v1/auth/initiate and /v1/auth/complete. Improved API reference sections, added OpenApiEndpoint usage, clarified pregeneration and user listing flows, and enhanced code samples for Unity and .NET SDKs. Refactored APIEndpoint component to show query parameters and examples, and updated AuthMethodsTabs to use new auth endpoints.

Author: 0xFirekeeper

apps/portal/src/app/contracts/page.mdx

@@ -69,10 +69,22 @@ Read, write, and deploy smart contracts on any EVM compatible blockchain.
 
   <TabsContent value="http">
 
+    ### Read from Contracts
+
     <OpenApiEndpoint path="/v1/contracts/read" method="POST" />
 
+    ### Write to Contracts
+
 	<OpenApiEndpoint path="/v1/contracts/write" method="POST" />
 
+    ### Deploy Contracts
+
+    <OpenApiEndpoint path="/v1/contracts" method="POST" />
+
+    ### List Contracts
+
+    <OpenApiEndpoint path="/v1/contracts" method="GET" />
+
   </TabsContent>
 
   <TabsContent value="typescript">

apps/portal/src/app/payments/page.mdx

@@ -10,7 +10,8 @@ import {
   TabsList,
   TabsTrigger,
   TabsContent,
-  Badge
+  Badge,
+  OpenApiEndpoint,
 } from "@doc";
 import {
   ReactIcon,
@@ -181,7 +182,27 @@ const preparedQuote = await Bridge.Buy.prepare({
   </TabsContent>
 
   <TabsContent value="http">
-    The thirdweb Payments REST API is available at `https://payments.thirdweb.com/`. See the full [API Reference](https://payments.thirdweb.com/reference) for details.
+    Use the thirdweb payments API to create and manage payments programmatically.
+
+    ### Create Payment
+
+    Create a payment for your product or service:
+
+    <OpenApiEndpoint path="/v1/payments" method="POST" />
+
+    ### Complete Payment
+
+    Complete a payment using the product ID:
+
+    <OpenApiEndpoint path="/v1/payments/{id}" method="POST" />
+
+    ### Swap Tokens
+
+    Swap tokens for optimal payment processing:
+
+    <OpenApiEndpoint path="/v1/payments/swap" method="POST" />
+
+    For more details, see the full [API Reference](https://api.thirdweb.com/reference).
   </TabsContent>
 </Tabs>
 

apps/portal/src/app/wallets/custom-auth/page.mdx

@@ -68,7 +68,7 @@ You will be asked to enter the following values
 
 <TabsContent value="http">
 
-<OpenApiEndpoint path="/v1/wallets/user/generic-auth" method="POST" />
+<OpenApiEndpoint path="/v1/auth/initiate" method="POST" />
 
 </TabsContent>
 
@@ -188,7 +188,7 @@ Once you've logged in with your own auth, you can pass the user's JWT to the in-
 
 <TabsContent value="http">
 
-<OpenApiEndpoint path="/v1/wallets/user/generic-auth" method="POST" requestBodyOverride={{
+<OpenApiEndpoint path="/v1/auth/complete" method="POST" requestBodyOverride={{
 	type: "auth-payload",
 	payload: "<your-auth-payload>",
 }} />

apps/portal/src/app/wallets/get-users/page.mdx

@@ -20,191 +20,104 @@ From your backend, you can list all your users and fetch the details of any user
 	<TabsList>
 		<TabsTrigger value="single">Single User</TabsTrigger>
 		<TabsTrigger value="all">All Users</TabsTrigger>
+		<TabsTrigger value="create">Create User</TabsTrigger>
 	</TabsList>
 
 <TabsContent value="single">
 
-### Endpoint
+## Get Single User
 
-`GET` request to the following endpoint:
-
-```http
-GET /v1/wallets/[email protected]
-Host: api.thirdweb.com
-x-secret-key: <your-secret-key>
-```
-
-<OpenApiEndpoint path="/v1/wallets/user" method="GET" />
+Fetch details for a specific user by email, phone, wallet address, or user ID.
 
 ### Query Parameters
 
-You can then query by different user identifiers:
+You can query by any of these user identifiers:
 
-- `address`: The user's wallet address that thirdweb has generated for them
+- `address`: The user's wallet address that thirdweb generated
 - `email`: The user's email address
 - `phone`: The user's phone number
-- `externalWalletAddress`: The user's wallet address that used to login via SIWE
+- `externalWalletAddress`: The user's external wallet address (SIWE login)
 - `id`: The user's ID (for custom auth)
 
 ### Authentication
 
-You need to include the following headers:
-
+Required headers:
 - `x-secret-key`: Your secret key for authentication
 - `x-ecosystem-id` (optional): Your ecosystem ID
 - `x-ecosystem-partner-id` (optional): Your ecosystem partner ID
 
-### Example Requests
-
-Here's an example curl command to fetch user details by email:
-
-```bash
+### Example
 
-curl -X GET 'https://api.thirdweb.com/v1/wallets/[email protected]' \
-  -H 'x-secret-key: YOUR_SECRET_KEY'
-
-```
-
-Here's an example curl command to fetch user details by address:
+<OpenApiEndpoint path="/v1/wallets/user" method="GET" />
 
-```bash
-curl -X GET 'https://api.thirdweb.com/v1/wallets/user?address=0x123456789abcdef' \
-  -H 'x-secret-key: YOUR_SECRET_KEY'
-```
+For ecosystem wallets, include the ecosystem headers in your requests.
 
-Here's an example curl command to fetch the user details for an ecosystem owner:
+</TabsContent>
 
-```bash
-curl -X GET 'https://api.thirdweb.com/v1/wallets/user?address=0x123456789abcdef' \
-  -H 'x-secret-key: YOUR_SECRET_KEY' \
-  -H 'x-ecosystem-id: ecosystem.YOUR_ECOSYSTEM_ID' \
-  -H 'x-ecosystem-partner-id: YOUR_PARTNER_ID'
-```
+<TabsContent value="all">
 
-In both examples, replace `YOUR_SECRET_KEY` with your actual ThirdWeb Client Secret.
+## Get All Users
 
-Replace `YOUR_ECOSYSTEM_ID` and `YOUR_PARTNER_ID` with your actual ecosystem ID and partner ID respectively. The partner ID can be one you set up for yourself as the ecosystem owner.
+List all users in your in-app or ecosystem wallet with pagination support.
 
-### Response Format
+### Query Parameters
 
-The API returns a JSON array with the following structure for each user:
+- `page` (optional): Page number for pagination
+- `limit` (optional): Maximum users per request (default: 50)
 
-```json
-{
-	"result": {
-		"pagination": {
-			"hasMore": false,
-			"limit": 50,
-			"page": 1
-		},
-		"wallets": [
-			{
-				"address": "0x3aA70e68BBA8BC922a75d07388e368892c15c9Da",
-				"createdAt": "2025-07-21T22:58:12.834Z",
-				"profiles": [
-					{
-            "id": "107302390467834615186",
-            "name": "Richard Hendricks",
-            "type": "google",
-            "email": "[email protected]",
-            "picture": "https://lh3.googleusercontent.com/a/ACg8ocKC1D6ezzzaZxxUk4qtK_HCwVwpNamVopazXwklGBwuuHeSf_c=s96-c",
-            "givenName": "Richard",
-            "emailVerified": true
-          }
-				]
-			}
-		]
-	}
-}
-```
+### Authentication
 
-For more information, [view the full reference](https://api.thirdweb.com/reference#tag/wallets/get/v1/wallets/user)
+Required headers:
+- `x-secret-key`: Your secret key for authentication
+- `x-ecosystem-id` (optional): Your ecosystem ID
+- `x-ecosystem-partner-id` (optional): Your ecosystem partner ID
 
-### Convenience Methods
+<Callout variant="info" title="Ecosystem Users">
+	For ecosystem wallets, the secret key must be from the same account as the ecosystem owner.
+</Callout>
 
-If you are using the thirdweb SDK, you can use the `getUser` method to retrieve user details.
+### Example
 
-<Stack>
-	<ArticleIconCard
-		title="getUser"
-		icon={TypeScriptIcon}
-		description="Get user details from your backend for thirdweb wallets in TypeScript"
-		href="/references/typescript/v5/getUser"
-	/>
-</Stack>
+<OpenApiEndpoint path="/v1/wallets/users" method="GET" />
 
 </TabsContent>
 
-<TabsContent value="all">
+<TabsContent value="create">
 
-### Endpoint
+## Create User Wallet (Pregeneration)
 
-`GET` request to the following endpoint:
+Pregenerate a user wallet before authentication. This creates a wallet in advance that can be claimed later when the user authenticates.
 
-```http
-GET /v1/wallets/users
-Host: api.thirdweb.com
-x-secret-key: <your-secret-key>
-```
+### Use Cases
 
-### Query Parameters
-
-- `page` (optional): The page number to fetch (for pagination)
-- `limit` (optional): Maximum number of users to return per request (defaults to 50)
+- Create wallets based on known email addresses or user IDs
+- Pre-fund wallets with tokens or NFTs before users claim them
+- Enable smoother onboarding experiences
 
 ### Authentication
 
-You need to include the following headers:
-
+Required headers:
 - `x-secret-key`: Your secret key for authentication
 - `x-ecosystem-id` (optional): Your ecosystem ID
 - `x-ecosystem-partner-id` (optional): Your ecosystem partner ID
 
-<Callout variant="info" title="Getting ecosystem users">
-	For ecosystem wallets, the secret key have to be from the same account as the
-	ecosystem owner.
-</Callout>
+### Example
 
-### Example Requests
-
-Here's an example curl command to fetch all users:
-
-```bash
-curl -X GET 'https://api.thirdweb.com/v1/wallets/users?page=2&limit=100' \
-  -H 'x-secret-key: YOUR_SECRET_KEY' \
-  -H 'Content-Type: application/json'
-```
-
-### Response Format
-
-A successful API call returns an array of user objects in the following format:
-
-```json
-{
-  "result": {
-    "pagination": {
-      "hasMore": false,
-      "limit": 50,
-      "page": 1
-    },
-    "wallets": [
-  {
-    "address": "0x3aA70e68BBA8BC922a75d07388e368892c15c9Da",
-    "createdAt": "2025-07-21T22:58:12.834Z",
-    "profiles": [
-      {
-        "id": "107302390467834615186",
-        "name": "Richard Hendricks",
-        "type": "google",
-        "email": "[email protected]",
-        "picture": "https://lh3.googleusercontent.com/a/ACg8ocKC1D6ezzzaZxxUk4qtK_HCwVwpNamVopazXwklGBwuuHeSf_c=s96-c",
-        "givenName": "Richard",
-        "emailVerified": true
-      }]
-    },
-  ]
-}
-```
+<OpenApiEndpoint path="/v1/wallets/user" method="POST" />
 
 </TabsContent>
+
 </Tabs>
+
+## SDK Integration
+
+If you're using the thirdweb SDK, you can use the `getUser` method for easier integration:
+
+<Stack>
+	<ArticleIconCard
+		title="getUser"
+		icon={TypeScriptIcon}
+		description="Get user details from your backend for thirdweb wallets in TypeScript"
+		href="/references/typescript/v5/getUser"
+	/>
+</Stack>