subscribe Function

Create recurring USDC subscriptions on Base

Default (30-day period)Test Mode (5-minute period)

Code Editor

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

try {
  const subscription = await base.subscription.subscribe({
    recurringCharge: "10.50",
    subscriptionOwner: "0xFe21034794A5a574B94fE4fDfD16e005F1C96e51", // Your app's address
    periodInDays: 30,
    testnet: true
  })
  
  return subscription;
} catch (error) {
  console.error('Subscription failed:', error.message);
  throw error;
}

Intended for testing purposes only. Never paste code from untrusted sources. Coinbase is not responsible for any loss of funds that you incur. Testnet funds hold no real value.

Quick Tips

Get testnet USDC at https://faucet.circle.com/ - select "Base Sepolia" as the network
subscriptionOwner is your application's address that will control the subscription
recurringCharge is the amount of USDC to charge per period (e.g., "10.50" = $10.50)
periodInDays sets the billing cycle (default: 30 days)
overridePeriodInSecondsForTestnet allows faster testing cycles on testnet only
The user can revoke the subscription at any time through their wallet

Output

Click "Execute Code" to run your code

getSubscriptionStatus Function

Check the status of a subscription

Code Editor

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

try {
  const result = await base.subscription.getStatus({
    id: '0x...', // Replace with a subscription ID
    testnet: true
  })
  
  return result;
} catch (error) {
  console.error('Failed to check subscription status:', error.message);
  throw error;
}

Intended for testing purposes only. Never paste code from untrusted sources. Coinbase is not responsible for any loss of funds that you incur. Testnet funds hold no real value.

Quick Tips

Use the subscription ID returned from the subscribe function
remainingChargeInPeriod shows how much can still be charged this period
Make sure to use the same testnet setting as the original subscription

Output

Click "Execute Code" to run your code