Methods to manage and update credit cards stored on a customer's account.

List saved credit cards

Use to get a list of credit cards on file for the account. These are stored automatically when a non-guest user checks out and chooses to save their information for later.

Returns all addresses, with offset pagination using limit and page.

List saved credit cards
await swell.account.listCards()

Create a new credit card

Use to save a tokenized credit card to the account for future use. Credit card tokens can be created using swell.card.createToken or Stripe.js.

Create a new credit card
await swell.account.createCard({
  token: '...'
})

Update an existing card

Used to update information on an existing card on file by ID.

Update an existing card
await swell.account.updateCard('5c15505200c7d14d851e510f'){
  exp_month: 11,
  exp_year: 2050
})

Delete a credit card

Use to remove a saved credit card from the account by ID.

Delete a credit card
await swell.account.deleteCard('5c15505200c7d14d851e510f')

Update a default card

When fetching an account, the default payment method is listed account.billing.account_card_id. The account's default card can be updated by passing the desired card ID to account.billing.account_card_id

Update the default card
import swell from 'swell-js'
swell.init('my-store', 'public-key')

account = await swell.account.get()

Swell supports deleting the default card. If the default card that is deleted is associated with an active subscription, it will remain associated with the subscription unless the subscription itself is modified.