subscription.subscribe

import { base } from '@base-org/account';

try {
  const subscription = await base.subscription.subscribe({
    recurringCharge: "9.99",
    subscriptionOwner: "0xYourSubscriptionOwnerWallet",
    periodInDays: 30
  });
  
  console.log(`Subscription ID: ${subscription.id}`);
  console.log(`Payer: ${subscription.subscriptionPayer}`);
  console.log(`Monthly charge: $${subscription.recurringCharge}`);
} catch (error) {
  console.error(`Subscription failed: ${error.message}`);
}

try {
  const subscription = await base.subscription.subscribe({
    recurringCharge: "2.99",
    subscriptionOwner: "0xYourSubscriptionOwnerWallet",
    periodInDays: 7,  // Weekly billing
    testnet: true     // Use Base Sepolia
  });
  
  console.log(`Created weekly subscription: ${subscription.id}`);
  console.log(`Charging ${subscription.recurringCharge} every ${subscription.periodInDays} days`);
} catch (error) {
  console.error(`Failed to create subscription: ${error.message}`);
}

try {
  const subscription = await base.subscription.subscribe({
    recurringCharge: "99.99",
    subscriptionOwner: "0xYourSubscriptionOwnerWallet",
    periodInDays: 365,  // Annual billing
    testnet: false
  });
  
  console.log(`Annual subscription created!`);
  console.log(`ID: ${subscription.id}`);
  console.log(`Annual charge: $${subscription.recurringCharge}`);
} catch (error) {
  console.error(`Subscription creation failed: ${error.message}`);
}

{
  id: "0x71319cd488f8e4f24687711ec5c95d9e0c1bacbf5c1064942937eba4c7cf2984",
  subscriptionOwner: "0xYourSubscriptionOwnerWallet",
  subscriptionPayer: "0x742d35Cc4Bf53E0e6C42E5d9F0A8D2F6D8A8B7C9",
  recurringCharge: "9.99",
  periodInDays: 30
}

{
  "code": 4001,
  "message": "User rejected the request",
  "stack": "Error: User rejected the request\n    at getEthProviderError..."
}

Defined in the Base Account SDK

The subscribe function creates recurring USDC subscriptions using spend permissions on the Base network. This enables you to charge users periodically without requiring approval for each transaction. No fees for merchants or users.

Parameters

string

required

Amount of USDC to charge per period (e.g., “10.50”). Maximum 6 decimal places.

string

required

Ethereum address that will be the spender (your application’s address).Pattern: ^0x[0-9a-fA-F]{40}$

number

The period in days for the subscription (e.g., 30 for monthly). Default: 30

boolean

Set to true to use Base Sepolia testnet instead of mainnet. Default: false

boolean

Check if the payer’s wallet has sufficient USDC balance before creating the subscription. If true, subscription creation will fail if the payer doesn’t have enough balance to cover the recurring charge. Default: true

boolean

Whether to enable telemetry logging. Default: true

Returns

SubscriptionResult

Subscription details on success. The function throws an error on failure.

Show SubscriptionResult properties

string

The subscription ID (permission hash) - use this to manage the subscription.

Address

Address that controls the subscription (your application).

Address

Address that will be charged (the user).

string

Recurring charge amount in USD.

number

Period in days for the subscription.

Errors

The subscribe function throws an error when subscription creation fails. The error object contains a message explaining what went wrong.

import { base } from '@base-org/account';

try {
  const subscription = await base.subscription.subscribe({
    recurringCharge: "9.99",
    subscriptionOwner: "0xYourSubscriptionOwnerWallet",
    periodInDays: 30
  });
  
  console.log(`Subscription ID: ${subscription.id}`);
  console.log(`Payer: ${subscription.subscriptionPayer}`);
  console.log(`Monthly charge: $${subscription.recurringCharge}`);
} catch (error) {
  console.error(`Subscription failed: ${error.message}`);
}

try {
  const subscription = await base.subscription.subscribe({
    recurringCharge: "2.99",
    subscriptionOwner: "0xYourSubscriptionOwnerWallet",
    periodInDays: 7,  // Weekly billing
    testnet: true     // Use Base Sepolia
  });
  
  console.log(`Created weekly subscription: ${subscription.id}`);
  console.log(`Charging ${subscription.recurringCharge} every ${subscription.periodInDays} days`);
} catch (error) {
  console.error(`Failed to create subscription: ${error.message}`);
}

try {
  const subscription = await base.subscription.subscribe({
    recurringCharge: "99.99",
    subscriptionOwner: "0xYourSubscriptionOwnerWallet",
    periodInDays: 365,  // Annual billing
    testnet: false
  });
  
  console.log(`Annual subscription created!`);
  console.log(`ID: ${subscription.id}`);
  console.log(`Annual charge: $${subscription.recurringCharge}`);
} catch (error) {
  console.error(`Subscription creation failed: ${error.message}`);
}

{
  id: "0x71319cd488f8e4f24687711ec5c95d9e0c1bacbf5c1064942937eba4c7cf2984",
  subscriptionOwner: "0xYourSubscriptionOwnerWallet",
  subscriptionPayer: "0x742d35Cc4Bf53E0e6C42E5d9F0A8D2F6D8A8B7C9",
  recurringCharge: "9.99",
  periodInDays: 30
}

{
  "code": 4001,
  "message": "User rejected the request",
  "stack": "Error: User rejected the request\n    at getEthProviderError..."
}

Error Handling

Always wrap calls to subscribe in a try-catch block:

try {
  const subscription = await base.subscription.subscribe({
    recurringCharge: "19.99",
    subscriptionOwner: "0xYourSubscriptionOwnerWallet",
    periodInDays: 30
  });
  // Subscription created successfully
  saveSubscriptionId(subscription.id); // Save for future charges
} catch (error) {
  // Handle subscription failure
  console.error(`Failed to create subscription: ${error.message}`);
}

Subscriptions Overview

subscription.getStatus

Introduction

Quickstart

Guides

Framework Integrations

Reference

More

Basenames

Contribute

Parameters

Returns

Errors

Error Handling

​Parameters

​Returns

​Errors

​Error Handling

Parameters

Returns

Errors

Error Handling