Authorize a Payment

Ask the buyer to approve an exact USDC payment offchain, then decide when to settle it. EIP-3009 signs the payer, recipient, amount, validity window, and one-time nonce without sending a transaction.

Demo

The demo above is mock only. If you want to see onchain demos on Vibenet, head to Base chain demos.

An EIP-3009 signature is deferred payment authorization, not a reserved balance. The payer can move funds before capture, and token policy can still block settlement. Only a successful capture transaction guarantees payment.

Sign and Store the Authorization

TypeScript

export async function authorizePayment(
  merchant: Address,
  orderId: string,
  amount: string,
): Promise<StoredAuthorization> {
  const { account, publicClient, walletClient } = await browserClients();
  const [name, version] = await Promise.all([
    publicClient.readContract({ address: USDC, abi: usdcAbi, functionName: "name" }),
    publicClient.readContract({ address: USDC, abi: usdcAbi, functionName: "version" }),
  ]);
  const now = BigInt(Math.floor(Date.now() / 1000));
  const authorization = {
    from: account,
    to: merchant,
    value: parseUnits(amount, 6),
    validAfter: now - 60n,
    validBefore: now + 15n * 60n,
    nonce: bytesToHex(crypto.getRandomValues(new Uint8Array(32))),
  } as const;
  const signature = await walletClient.signTypedData({
    account,
    domain: { name, version, chainId: baseSepolia.id, verifyingContract: USDC },
    types: transferAuthorizationTypes,
    primaryType: "TransferWithAuthorization",
    message: authorization,
  });
  return { orderId, authorization, signature };
}

Store the returned payload and signature against the order on your backend. Generate a cryptographically random 32-byte nonce for every attempt, and never reuse it for another order.

Field	Purpose
`value`	Exact amount that can settle
`validAfter`	Earliest valid capture time
`validBefore`	Capture deadline
`nonce`	One-time identifier consumed by capture or cancellation

The wallet returns a typed-data signature, while authorizationState(payer, nonce) remains false until the authorization is captured or canceled onchain.

Choose an Authorization Path

Need	Primitive	Continue with
Exact wallet payment captured later	EIP-3009	Capture an authorization
Variable total known later	EIP-2612 plus a constrained checkout	Capture a partial amount
Repeated scheduled charges	Smart-account spend permission	Charge on a schedule
Payment negotiated over HTTP	x402 exact	Charge for an API

Capture an Authorization

Submit the stored signature from the merchant account.

Void an Authorization

Let an authorization expire or cancel its nonce onchain.

Overview

Integrate DeFi

Tokenize Assets

Issue Stablecoins

Accept Payments

Demo

Sign and Store the Authorization

Choose an Authorization Path

See Also

Capture an Authorization

Void an Authorization

​Demo

​Sign and Store the Authorization

​Choose an Authorization Path

​See Also

Capture an Authorization

Void an Authorization

Demo

Sign and Store the Authorization

Choose an Authorization Path

See Also