[SDK] Add support for extra metadata in x402 payment requests (#8358)

Author: joaquim-verges

.changeset/four-ghosts-tickle.md

@@ -0,0 +1,5 @@
+---
+"thirdweb": patch
+---
+
+Add support for extraMetadata in x402 payment requirements

packages/thirdweb/src/x402/common.ts

@@ -44,6 +44,7 @@ export async function decodePaymentRequest(
     routeConfig = {},
     method,
     paymentData,
+    extraMetadata,
   } = args;
   const { errorMessages } = routeConfig;
 
@@ -54,6 +55,7 @@ export async function decodePaymentRequest(
     price,
     routeConfig,
     payTo,
+    extraMetadata,
   });
 
   // Check for payment header, if none, return the payment requirements

packages/thirdweb/src/x402/facilitator.ts

@@ -281,6 +281,7 @@ export function facilitator(
           routeConfig: args.routeConfig,
           serverWalletAddress: facilitator.address,
           recipientAddress: args.payTo,
+          extraMetadata: args.extraMetadata,
         }),
       });
       if (res.status !== 402) {

packages/thirdweb/src/x402/types.ts

@@ -35,6 +35,8 @@ export type PaymentArgs = {
   routeConfig?: PaymentMiddlewareConfig;
   /** Optional recipient address to receive the payment if different from your facilitator address */
   payTo?: string;
+  /** Optional extra data to be included in the payment request */
+  extraMetadata?: Record<string, unknown>;
 };
 
 export type SettlePaymentArgs = PaymentArgs & {