Payments
Card payments
Add payment methods
About the APIs
Regulation Support
Sign in
Sign up
Support
Sign in
Payments
Older APIs
Sources
Sources and customers

Sources and customers

Learn how to attach and manage sources with Customer objects.

A Source object can be either single-use or reusable, as indicated by its usage parameter. While sources can be charged directly, reusable sources should always be attached to a Customer object for later reuse. Attaching reusable sources to Customer objects allows you to present your customers with a list of reusable payment methods that they have previously used with your app or website.

Reusable sources

Certain payment methods (e.g., SEPA Direct Debit) support reusable sources, so that you can create additional payments without your customer’s needing to complete the payment process again. A source that can be reused has its usage parameter set to reusable.

You must attach a reusable source to a Customer object before making a charge request. If you charge a reusable source without first attaching it, the source is consumed (its status changes from chargeable to consumed). Consumed sources cannot be used for further payments.

Attaching a source to a new Customer object

You can create a Customer object and attach a source in one API call. This is useful if this is the first time you’re seeing this customer.

curl https://api.stripe.com/v1/customers \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d email="paying.user@example.com" \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

customer = Stripe::Customer.create({
  email: 'paying.user@example.com',
  source: 'src_18eYalAHEMiOZZp1l9ZTjSU0',
})

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

customer = stripe.Customer.create(
  email='paying.user@example.com',
  source='src_18eYalAHEMiOZZp1l9ZTjSU0',
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$customer = \Stripe\Customer::create([
  'email' => 'paying.user@example.com',
  'source' => 'src_18eYalAHEMiOZZp1l9ZTjSU0',
]);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

CustomerCreateParams params =
  CustomerCreateParams.builder()
    .setEmail("paying.user@example.com")
    .setSource("src_18eYalAHEMiOZZp1l9ZTjSU0")
    .build();

Customer customer = Customer.create(params);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const customer = await stripe.customers.create({
  email: 'paying.user@example.com',
  source: 'src_18eYalAHEMiOZZp1l9ZTjSU0',
});

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

customerParams := &stripe.CustomerParams{
  Email: stripe.String("paying.user@example.com"),
}
customerParams.SetSource("src_18eYalAHEMiOZZp1l9ZTjSU0")
c, err := customer.New(customerParams)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new CustomerCreateOptions
{
    Email = "paying.user@example.com",
    Source = "src_18eYalAHEMiOZZp1l9ZTjSU0",
};

var service = new CustomerService();
Customer customer = service.Create(options);

The source becomes the Customer object’s default source, since this is the customer’s first and only payment method. The default source is automatically selected if you make a charge request using the customer parameter without specifying a source.

Attaching a Source to an existing Customer object

When you update a Customer object that has a default source, this automatically detaches the existing source, and adds the provided source as the new default. To add a source without replacing the existing default, use the attach method, as shown below.

curl https://api.stripe.com/v1/customers/cus_AFGbOSiITuJVDs/sources \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

Stripe::Customer.create_source(
  'cus_AFGbOSiITuJVDs',
  {
    source: 'src_18eYalAHEMiOZZp1l9ZTjSU0',
  }
)

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

stripe.Customer.create_source(
  'cus_AFGbOSiITuJVDs',
  source='src_18eYalAHEMiOZZp1l9ZTjSU0'
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

\Stripe\Customer::createSource(
  'cus_AFGbOSiITuJVDs',
  [
    'source' => 'src_18eYalAHEMiOZZp1l9ZTjSU0',
  ]
);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

Customer customer = Customer.retrieve("cus_AFGbOSiITuJVDs");

PaymentSourceCollectionCreateParams params =
  PaymentSourceCollectionCreateParams.builder()
    .setSource("src_18eYalAHEMiOZZp1l9ZTjSU0")
    .build();

Source source = (Source) customer.getSources().create(params);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const source = await stripe.customers.createSource(
  'cus_AFGbOSiITuJVDs',
  {
    source: 'src_18eYalAHEMiOZZp1l9ZTjSU0',
  }
);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.CustomerSourceParams{
  Customer: stripe.String("cus_AFGbOSiITuJVDs"),
  Source: &stripe.SourceParams{
    Token: stripe.String("src_18eYalAHEMiOZZp1l9ZTjSU0"),
  },
}
paymentsource.New(params)

Here, because a default source might already exist for the Customer object, the newly attached source does not become the default source. However, you can change the default source by updating the Customer object and specifying the source as a value for default_source.

curl https://api.stripe.com/v1/customers/cus_AFGbOSiITuJVDs \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d default_source=src_18eYalAHEMiOZZp1l9ZTjSU0

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

Stripe::Customer.update(
  'cus_AFGbOSiITuJVDs',
  {
    default_source: 'src_18eYalAHEMiOZZp1l9ZTjSU0',
  }
)

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

stripe.Customer.modify(
  'cus_AFGbOSiITuJVDs',
  default_source='src_18eYalAHEMiOZZp1l9ZTjSU0'
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

\Stripe\Customer::update(
  "cus_AFGbOSiITuJVDs",
  [
    'default_source' => 'src_18eYalAHEMiOZZp1l9ZTjSU0',
  ]
);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

Customer customer = Customer.retrieve("cus_AFGbOSiITuJVDs");

CustomerUpdateParams params =
  CustomerUpdateParams.builder()
    .setDefaultSource("src_18eYalAHEMiOZZp1l9ZTjSU0")
    .build();

customer.update(params);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const customer = await stripe.customers.update(
  'cus_AFGbOSiITuJVDs',
  {
    default_source: 'src_18eYalAHEMiOZZp1l9ZTjSU0'
  }
);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.CustomerParams{
  DefaultSource: stripe.String("src_18eYalAHEMiOZZp1l9ZTjSU0"),
}
c, _ := customer.Update("cus_AFGbOSiITuJVDs", params)

Charging an attached source

You must specify both the Customer object and the source when making a charge request.

curl https://api.stripe.com/v1/charges \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d amount=1099 \
  -d currency=eur \
  -d customer=cus_AFGbOSiITuJVDs \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

charge = Stripe::Charge.create({
  amount: 1099,
  currency: 'eur',
  customer: 'cus_AFGbOSiITuJVDs',
  source: 'src_18eYalAHEMiOZZp1l9ZTjSU0',
})

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

charge = stripe.Charge.create(
  amount=1099,
  currency='eur',
  customer='cus_AFGbOSiITuJVDs',
  source='src_18eYalAHEMiOZZp1l9ZTjSU0',
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$charge = \Stripe\Charge::create([
  'amount' => 1099,
  'currency' => 'eur',
  'customer' => 'cus_AFGbOSiITuJVDs',
  'source' => 'src_18eYalAHEMiOZZp1l9ZTjSU0',
]);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

ChargeCreateParams params =
  ChargeCreateParams.builder()
    .setAmount(1099L)
    .setCurrency("eur")
    .setDescription("Example charge")
    .setStatementDescriptor("Custom descriptor")
    .putCustomer("cus_AFGbOSiITuJVDs")
    .setSource("src_18eYalAHEMiOZZp1l9ZTjSU0")
    .build();

Charge charge = Charge.create(params);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const charge = await stripe.charges.create({
  amount: 1099,
  currency: 'eur',
  customer: 'cus_AFGbOSiITuJVDs',
  source: 'src_18eYalAHEMiOZZp1l9ZTjSU0',
});

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

chargeParams := &stripe.ChargeParams{
  Amount: stripe.Int64(1099),
  Currency: stripe.String(string(stripe.CurrencyEUR)),
  Customer: stripe.String("cus_AFGbOSiITuJVDs"),
}
chargeParams.SetSource("src_18eYalAHEMiOZZp1l9ZTjSU0")
ch, err := charge.New(chargeParams)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new ChargeCreateOptions
{
    Amount = 1099,
    Currency = "eur",
    Customer = "cus_AFGbOSiITuJVDs",
    Source = "src_18eYalAHEMiOZZp1l9ZTjSU0",
};

var service = new ChargeService();
Charge charge = service.Create(options);

If you attempt to charge a Customer object without specifying a source, Stripe uses the customer’s default source.

Detaching a source

If you need to remove a source from a particular Customer object, you can detach the source. Doing so changes the source’s status to consumed, so it cannot be used once detached.

Single-use sources

Single-use sources must be created each time a customer makes a payment, and cannot be reused. For that reason, we do not recommend that you permanently attach them to customers.

If you want to associate a payment with a particular Customer object, you can include a customer parameter when making a charge request with a source, even if the source is not attached.

curl https://api.stripe.com/v1/charges \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc: \
  -d amount=1099 \
  -d currency=eur \
  -d customer=cus_AFGbOSiITuJVDs \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

charge = Stripe::Charge.create({
  amount: 1099,
  currency: 'eur',
  customer: 'cus_AFGbOSiITuJVDs',
  source: 'src_18eYalAHEMiOZZp1l9ZTjSU0',
})

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

charge = stripe.Charge.create(
  amount=1099,
  currency='eur',
  customer='cus_AFGbOSiITuJVDs',
  source='src_18eYalAHEMiOZZp1l9ZTjSU0',
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

$charge = \Stripe\Charge::create([
  'amount' => 1099,
  'currency' => 'eur',
  'customer' => 'cus_AFGbOSiITuJVDs',
  'source' => 'src_18eYalAHEMiOZZp1l9ZTjSU0',
]);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

ChargeCreateParams params =
  ChargeCreateParams.builder()
    .setAmount(1099L)
    .setCurrency("eur")
    .setDescription("Example charge")
    .setStatementDescriptor("Custom descriptor")
    .putCustomer("cus_AFGbOSiITuJVDs")
    .setSource("src_18eYalAHEMiOZZp1l9ZTjSU0")
    .build();

Charge charge = Charge.create(params);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const charge = await stripe.charges.create({
  amount: 1099,
  currency: 'eur',
  customer: 'cus_AFGbOSiITuJVDs',
  source: 'src_18eYalAHEMiOZZp1l9ZTjSU0',
});

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

chargeParams := &stripe.ChargeParams{
  Amount: stripe.Int64(1099),
  Currency: stripe.String(string(stripe.CurrencyEUR)),
  Customer: stripe.String("cus_AFGbOSiITuJVDs"),
}
chargeParams.SetSource("src_18eYalAHEMiOZZp1l9ZTjSU0")
ch, err := charge.New(chargeParams)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new ChargeCreateOptions
{
    Amount = 1099,
    Currency = "eur",
    Customer = "cus_AFGbOSiITuJVDs",
    Source = "src_18eYalAHEMiOZZp1l9ZTjSU0",
};

var service = new ChargeService();
Charge charge = service.Create(options);

The resulting Charge object references both the Customer and Source objects, even if they are not directly related to one another.

Related resources

Was this page helpful?
Questions? Contact us.
Developer tutorials on YouTube.
You can unsubscribe at any time. Read our privacy policy.
On this page
Reusable sources
Single-use sources