This is the API reference for Stripe.js. Use Stripe.js’ APIs to tokenize customer information, collect sensitive card data using customizable Stripe Elements, and accept payments with browser payment APIs like Apple Pay and the Payment Request API.

• Including Stripe.js
• The Stripe object
  • stripe.elements()
  • stripe.createToken()
  • stripe.createSource()
  • stripe.retrieveSource()
  • stripe.paymentRequest()
• The Elements object
  • elements.create()
• The Element
  • element.mount()
  • element.on()
  • Other methods
    • element.blur()
    • element.clear()
    • element.destroy()
    • element.focus()
    • element.unmount()
    • element.update()
• The Element container
• The PaymentRequest object
  • paymentRequest.canMakePayment()
  • paymentRequest.show()
  • paymentRequest.update()
  • paymentRequest.on()
• Other Payment Request object types
  • The PaymentResponse object
  • The UpdateDetails object
  • The ShippingOption object
  • The shippingAddress object

Including Stripe.js

However you’re using Stripe.js, you always begin by including the library and setting your API key. To get started, include this script on your pages—it should always be loaded directly from https://js.stripe.com:

<script src="https://js.stripe.com/v3/">script>

To best leverage Stripe’s advanced fraud functionality, include this script on every page of your site, not just the checkout page. This allows Stripe to detect anomalous behavior that may be indicative of fraud as customers browse your website.

Stripe(publishableKey[, options])

Use Stripe(publishableKey[, options]) to create an instance of the Stripe object. Your Stripe publishable API key is required when calling this function, as it identifies your website to Stripe:

var stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx');

const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx');

We‘ve placed a random API key in the code. Replace it with your actual publishable API keys to test this code through your Stripe account.

When you’re ready to accept live payments, replace the test key with your live key in production. Learn more about how API keys work in test mode and live mode.

This function accepts an optional options object. Available options are documented below:

The Stripe object

• stripe.elements()
• stripe.createToken()
• stripe.createSource()
• stripe.retrieveSource()
• stripe.paymentRequest()

stripe.elements([options])

Create pre-built UI components to collect payment information with Elements.

var elements = stripe.elements();

const elements = stripe.elements();

This method creates an instance of elements, which manages a group of Elements. It accepts an optional options object. Available options are documented below:

stripe.createToken(element, tokenData)

Use stripe.createToken() to convert information collected by Elements into a single-use token that you safely pass to your server to use in an API call.

stripe.createToken(card).then(function(result)Women's BRYNTA2 Black Vince Boot Ankle Camuto z755wqT {
  // Handle result.error or result.token
});

const {token, error} = await stripe.createToken(card);

This method takes two arguments.

• element, the Element you wish to tokenize data from. If applicable, the Element pulls data from other Elements you’ve created on the same instance of elements to tokenize.
• tokenData, an object containing additional payment information you might have collected. In the case of cards, it can contain any of the following parameters:

Although these fields are optional, we highly recommend collecting name and address. This information can be used to perform a number of verifications, such as CVC, ZIP, and address verification. Radar includes built-in rules that can block payments where the ZIP or CVC verifications with the cardholder’s bank failed.

stripe.createToken returns a Promise which resolves with a result object. This object has either:

• result.token: a Token was created successfully.
• result.error: there was an error. This includes client-side validation errors. Refer to the API reference for all possible errors.

stripe.createToken('bank_account', bankAccountData)

Use stripe.createToken() to convert bank account information into a single-use token that you safely pass to your server to use in an API call.

stripe.createToken('bank_account', {
  country: 'US',
  currency: 'usd',
  routing_number: '110000000',
  account_number: '000123456789',
  account_holder_name: Espadrille Linen Women's Shoes Natural OTZ 40 Euro 'Jenny Rosen',
  account_holder_type: 'individual',
}).then(function(result) {
  // Handle result.error or result.token
});

const {token, error} = await stripe.createToken('bank_account', {
  country: 'US',
  currency: 'usd',
  routing_number: '110000000',
  account_number: '000123456789',
  account_holder_name: 'Jenny Rosen',
  account_holder_type: 'individual',
});

You can also use the IBAN Element to create bank_account tokens if you need to collect bank account information from customers in SEPA countries.

stripe.createToken(iban, {
  // country and account_number are automatically populated from the IBAN Element.
  currency: 'eur',
  account_holder_name: 'Jenny Rosen',
  account_holder_type: 'individual',
}).then(function(result) {
  // Handle result.error or result.token
});

const {token, error} = await stripe.createToken(iban, {
  // country and account_number are automatically populated from the IBAN Element.
  currency: 'eur',
  account_holder_name: 'Jenny Rosen',
  account_holder_type: 'individual',
});

Using stripe.createToken() for bank account details requires an object containing the following parameters:

stripe.createToken returns a Promise which resolves with a result object. This object has either:

• result.token: a Token was created successfully.
• result.error: there was an error. This includes client-side validation errors. Refer to the API reference for all possible errors.

stripe.createToken('pii', piiData)

Use stripe.createToken() to convert personally identifiable information (PII) into a single-use token for account identity verification.

stripe.createToken('pii', {
  personal_id_number: '123131185',
}).then(function(result) {
  // Handle result.error or result.token
});

const {token, error} = await stripe.createToken('pii', {
  personal_id_number: '123131185',
});

Using stripe.createToken() for PII data requires an object containing the following parameter:

stripe.createToken returns a Promise which resolves with a result object. This object has either:

• result.token: a Token was created successfully.
• result.error: there was an error. This includes client-side validation errors. Refer to the API reference for all possible errors.

stripe.createSource(element, sourceData)

Use stripe.createSource(element, sourceData) to convert payment information collected by Elements into a Source object that you safely pass to your server to use in an API call. See the Sources documentation for more information about Sources.

stripe.createSource(iban, {
  type: 'sepa_debit',
  currency: 'eur',
  owner: {
    name: 'Jenny Rosen',
  }Euro Linen Espadrille OTZ 40 Women's Shoes Natural ,
}).then(function(result) {
  // Handle result.error or result.source
});

const {source, error} = await stripe.createSource(iban, {
  type: 'sepa_debit'Mint Women Elevator Taller Up Lace Gray Insole 711 SNRD Sneakers Casual n61aTwfx,
  currency: 'eur',
  owner: {
    name: 'Jenny Rosen',
  },
});

This method takes two arguments.

• element, the Element containing payment source information. If applicable, the Element pulls data from other Elements you’ve created on the same instance of elements.
• sourceData, a required object containing the type of Source you want to create, and any additional payment source information that you have collected. See the Sources API reference for details.

stripe.createSource returns a Promise which resolves with a result object. This object has either:

• result.source: a Source was created successfully.
• result.error: there was an error. This includes client-side validation errors. Refer to the API reference for all possible errors.

stripe.createSource(sourceData)

Use stripe.createSource(sourceData) to convert raw payment information into a Source object that you can safely pass to your server for use in an API call. See the Sources documentation for more information about Sources.

stripe.createSource({
  type: 'ideal',
  amount: 1099,
  currency: 'eur',
  owner: {
    name: 'Jenny Rosen',
  },
  redirect: {
    return_url: 'https://shop.example.com/crtA6B28E1',
  },
}).then(function(result) {
  // Handle result.error or result.source
});

const {source, error} = await stripe.createSource({
  type: 'ideal',
  amount: 1099,
  currency: 'eur',
  owner: 40 Natural Espadrille OTZ Linen Women's Shoes Euro {
    name: 'Jenny Rosen',
  },
  redirect: {
    return_url: 'https://shop.example.com/crtA6B28E1',
  },
});Espadrille Women's Natural 40 OTZ Euro Shoes Linen 

This method accepts one argument, sourceData, which is an object containing payment source information that you have collected. See the Sources API reference for details.

stripe.createSource returns a Promise which resolves with a result object. This object has either:

• result.source: a Source was created successfully.
• result.error: there was an error. This includes client-side validation errors. Refer to the API reference for all possible errors.

stripe.retrieveSource(source)

Retrieve a Source using its unique ID and client secret.

stripe.retrieveSource({
  id: "src_18eYalAHEMiOZZp1l9ZTjSU0",
  client_secret: "src_client_secret_NibvRz4PMmJqjfb0sqmT7aq2",
}).then(function(result) {
  // Handle result.error or result.source
});

const {source, error} = await stripe.retrieveSource({
  id: "src_18eYalAHEMiOZZp1l9ZTjSU0",
  client_secret: "src_client_secret_NibvRz4PMmJqjfb0sqmT7aq2",
});

This method accepts an object source with the following required parameters:

You can use a Source object created with stripe.createSource as the argument to stripe.retrieveSource, as every Source object has both id and client_secret keys.

stripe.retrieveSource returns a Promise which resolves with a result object. This object has either:

• result.source: a Source was retrieved successfully.
• result.error: there was an error. Refer to the API reference for all possible errors.

stripe.paymentRequest(options)

Use stripe.paymentRequest() to create a PaymentRequest object. A PaymentRequest object is used to collect payment information through an interface controlled and styled by the browser itself (i.e., not by you or your page). See the Payment Request Button Element quickstart for a high-level overview of when you’d want to do this. In Safari, stripe.paymentRequest() uses Apple Pay, and in other browsers it uses the Payment Request API standard.

Creating a PaymentRequest requires that you configure it with an options object. Available options are documented below.

These options can be updated using paymentRequest.update().

The Elements object

elements.create(Euro Shoes Linen 40 Espadrille Women's Natural OTZ type, options)

var card = elements.create('card');

const card = elements.create('card');

This method creates an instance of a specific Element. It takes the type of Element to create as well as an options object.

Element type bright Women Sandals ZHOUZJ Shoes Summer Flip Slippers Leopard Flops Fashion Flats Beige wPP7UBEqn

Element options

All Elements accept a common set of options, and then some Element-specific options.

card Element:

cardNumber, cardExpiry, cardCvc Elements:

paymentRequestButton Element:

iban Element:

idealBank Element:

Here is an example that customizes the base and invalid states of a card Element:

var style = {
  base: {
    color: '#303238',
    fontSize: '16px',
    color: "#32325d"Espadrille Women's 40 Euro Natural Shoes OTZ Linen ,
    fontSmoothing: 'antialiased',
    '::placeholder': {
      color: '#ccc',
    },
  },
  invalid: {
    color: '#e5424d',
    ':focus': {
      color: '#303238',
    },
  },
};
var cardElement = elements.create('card', {style: style})Espadrille 40 Linen Euro Women's Natural OTZ Shoes 

const style = {
  base: {
    color: '#303238',
    fontSize: '16px',
    color: "#32325d",
    fontSmoothing: 'antialiased',
    '::placeholder': {
      color: '#ccc',
    },
  },
  invalid: {
    color: '#e5424d',
    ':focus': {
      color: '#303238',
    },
  },
};
const cardElement = elements.create('card', {style})

The Element

• element.mount()
• element.on()
• Other methods
  • element.blur()
  • element.clear()
  • element.destroy()
  • element.focus()
  • element.unmount()
  • element.update()

element.mount(domElement)

You need to create a container DOM element to mount an Element. If the container DOM element has a label, the Element is automatically focused when its label is clicked. There are two ways to do this:

1. Mount the instance within a .

   <label>Card
     <div id="card-element">div>
   label>

2. Create a with a for attribute, referencing the ID of your container.

   <label for="card-element">CardlabelOTZ Women's Euro Natural Linen 40 Espadrille Shoes >
   <div id="card-element">div>

The element.mount() method attaches your element to the DOM. element.mount() accepts either a CSS Selector (e.g., '#card-element') or a DOM element.

cardElement.mount('#card-element');

element.on(event, handler)

The only way to communicate with your element is by listening to an event. Elements might emit any of the events below. All events have a payload object that has an elementType property with the type of the Element that emitted the event.

Input validation

Elements validates customer input as it is typed. To help your customers catch mistakes, listen to change events on the Element and display any errors:

card.addEventListener(Espadrille OTZ Natural Shoes Euro 40 Linen Women's 'change', function(event) {
  var displayError = document.getElementById('card-errors');
  if (event.error) {
    displayError.textContent = event.error.message;Flat with Shoes Toe CHICKLE Bows Black Pointed Women's 7 twFq7vHP
  } else {
    displayError.textContent = '';
  }
});

card.addEventListener('change', ({error}) => {
  const displayError = document.getElementById('payment-errors');
  if (error) {
    displayError.textContent = error.message;
  }
});

Postal code formatting

The card Element automatically determines your customer’s billing address country based on their card number. Using this information, the postal code field validation reflects whether that country uses numeric or alphanumeric-formatted postal codes, or if the country uses postal codes at all. For instance, if a U.S. card is entered, the postal code field only accepts a five-digit numeric value. If it’s a UK card, an alphanumeric value can be provided instead.

Many of our test cards have a U.S. billing address country. When using these to test your payment form, you must also use a five-digit U.S. ZIP code (e.g., 12345). To test Elements with other postal code formats, use our international test card numbers.

Other methods

If you collect certain information in a different part of your interface (e.g., ZIP or postal code), use update() with the appropriate information.

var myPostalCodeField = document.querySelector('input[name="my-postal-code"]');
myPostalCodeField.addEventListener('change', function(event) {
  card.update({value: {postalCode: event.target.value}});
});

const myPostalCodeField = document.querySelector('input[name="my-postal-code"]');
myPostalCodeField.addEventListener('change', ({target}) => {
  card.update({value: {postalCode: target.value}});
});

The styles of an Element can be dynamically changed using update(). This method can be used to simulate CSS media queries that automatically adjust the size of Elements when viewed on different devices.

window.addEventListener('resize', function(event) {
  if (window.innerWidth <= 320) {
    card.update({style: {base: {fontSize: '13px'OTZ Women's Linen Shoes Natural 40 Espadrille Euro }}});
  } else {
    card.update({style: {base: {fontSize: '16px'}}});
  }
});

var previousBrand;
card.on('change', function(event) {
  if (event.brand !== previousBrand && event.brand === 'mastercard') {
    card.update({style: {base: {color: 'orange'}}});
    previousBrand = event.brand;
  }
});OTZ Euro Espadrille Women's Linen Natural Shoes 40 

window.addEventListener('resize', (event) => {
  if (window.innerWidth <= 320) {
    card.update({style: {base: {fontSize: '13px'}}});
  } else {
    card.update({style: {base: {fontSize: '16px'}}});
  }
});

let previousBrandNatural 40 Espadrille Women's OTZ Linen Shoes Euro ;
card.on('change', ({brand}) => {
  if (brand !== previousBrand && brand === 'mastercard') {
    card.update({style: {base: {color: 'orange'}}});
    previousBrand = event.brand;
  }
});

The Element container

Style the container you mount an Element to as if it were an on your page. For example, to control padding and border on an Element, set these properties on the container. This is usually done by re-using the classes that you have applied to your DOM elements. Example:

<style> .my-input { padding: 10px; border: 1px solid #ccc; } style>

<form>
  <div>
    <label>Namelabel>
    <input class="my-input">
  div>
  <div>
    <label>Cardlabel>
    
    
    <div class="my-input" id="card-element">div>
  div>
form>

After the Element is mounted, the .StripeElement class is added to the container. Additionally, the following classes are automatically added to the container when the Element is complete, empty, focused, invalid, or autofilled by the browser:

• .StripeElement--complete
• .StripeElement--empty
• .StripeElement--focus
• .StripeElement--invalid
• .StripeElement--webkit-autofill (Chrome and Safari only)

These class names can be customized using the classes option when you create an Element.

The PaymentRequest object

• paymentRequest.canMakePayment()
• paymentRequest.show()
• paymentRequest.update()
• paymentRequest.on()

For a quick overview of how to use the PaymentRequest object, see the Payment Request Button guide.

paymentRequest.canMakePayment()

Returns a Promise that resolves with a payload if a browser payment API is available. If no API is available, it resolves with null. The resolution object has these properties:

paymentRequest.show()

Shows the browser’s payment interface. When using the paymentRequestButton Element, this is called for you under the hood. This method must be called as the result of a user interaction (for example, in a click handler).

paymentRequest.update(options)

PaymentRequest instances can be updated with an options object. Available options are documented below.

paymentRequest.update() can only be called when the browser payment interface is not showing. Listen to the click and cancel events to detect if the payment interface has been initiated. To update the PaymentRequest right before the payment interface is initiated, call paymentRequest.update() in your click event handler.

paymentRequest.on(event, handler)

OTZ Linen Women's Natural Shoes 40 Euro Espadrille PaymentRequest instances receive the following events:

Other Payment Request object types

A number of types show up in multiple places the when using the PaymentRequest object or the paymentRequestButton.

• The PaymentResponse object
• The UpdateDetails object
• The ShippingOption object
• Green Unlimited Air Flax Nike Outdoor Suede Mens Xx1wXqC4

The PaymentResponse object

This object is returned as the payload of the token and source event handlers.

The UpdateDetails object

The UpdateDetails object is used to update certain parts of a PaymentRequest object after it has already been created. See the updateWith callback functions above.

The ShippingOption object

A ShippingOption is a normal JavaScript object you create that has the following parameters. Use these objects to let the customer select their preferred shipping method.

The ShippingAddress objectShoes Sport 7 Sperry Mesh Pink Light Women's Seas U6zXHxP

Use the requestShipping option to stripe.paymentRequest() to collect shipping information from the customer. This is the shape of the shipping address the customer enters:

Supported browsers

Stripe.js strives to support all recent versions of major browsers. For the sake of security and providing the best experience to the majority of customers, we do not support browsers that are no longer receiving security updates and represent a small minority of traffic.

• We support Internet Explorer and Edge per Microsoft's lifecycle policy. We currently support Internet Explorer 9 and above, but are deprecating support for IE9. As of December 1, 2018, we will support Internet Explorer 10 and above.
• We support Chrome and Safari on all platforms and Firefox on desktop platforms.
• We support the Android native browser on Android 4.4 and later.
• We require TLS 1.2 to be supported by the browser.
• We respond to bug reports but do not proactively test other mobile browsers.

If you have an issue with Stripe.js on a specific browser, please contact us so we can improve its support.