Core Resources
Payment Methods
Products
Checkout
Payment Links
Billing
Capital
Connect
Reserves
Fraud
Issuing
Terminal
Treasury
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Privacy
Webhooks

Create a Location 

Terminal
Location
Create a Location

Creates a new Location object. For further details, including which address fields are required in each country, see the Manage locations guide.

Parameters

  • addressobject

    The full address of the location.

    • address.countrystringRequired

      Two-letter country code (ISO 3166-1 alpha-2).

    • address.citystringRequired in certain countries

      City, district, suburb, town, or village.

    • address.line1stringRequired

      Address line 1 (e.g., street, PO Box, or company name).

    • address.line2string

      Address line 2 (e.g., apartment, suite, unit, or building).

    • address.postal_codestringRequired in certain countries

      ZIP or postal code.

    • address.statestringRequired in certain countries

      State, county, province, or region.

  • display_namestring

    A name for the location. Maximum length is 1000 characters.

  • metadataobject

    Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

More parameters

  • address_kanaobjectPreview feature

    The Kana variation of the full address of the location (Japan only).

    • address_kana.citystring

      City or ward.

    • address_kana.countrystring

      Two-letter country code (ISO 3166-1 alpha-2).

    • address_kana.line1string

      Block or building number.

    • address_kana.line2string

      Building details.

    • address_kana.postal_codestring

      Postal code.

    • address_kana.statestring

      Prefecture.

    • address_kana.townstring

      Town or cho-me.

  • address_kanjiobjectPreview feature

    The Kanji variation of the full address of the location (Japan only).

    • address_kanji.citystring

      City or ward.

    • address_kanji.countrystring

      Two-letter country code (ISO 3166-1 alpha-2).

    • address_kanji.line1string

      Block or building number.

    • address_kanji.line2string

      Building details.

    • address_kanji.postal_codestring

      Postal code.

    • address_kanji.statestring

      Prefecture.

    • address_kanji.townstring

      Town or cho-me.

  • configuration_overridesstring

    The ID of a configuration that will be used to customize all readers in this location.

  • display_name_kanastringPreview feature

    The Kana variation of the name for the location (Japan only). Maximum length is 1000 characters.

  • display_name_kanjistringPreview feature

    The Kanji variation of the name for the location (Japan only). Maximum length is 1000 characters.

  • phonestringPreview feature

    The phone number for the location.

Returns

Returns a Location object if creation succeeds.

POST /v1/terminal/locations
const stripe = require('stripe')('sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2');
const location = await stripe.terminal.locations.create({
  display_name: 'My First Store',
  address: {
    line1: '1234 Main Street',
    city: 'San Francisco',
    postal_code: '94111',
    state: 'CA',
    country: 'US',
  },
});
Response
{
  "id": "tml_FBakXQG8bQk4Mm",
  "object": "terminal.location",
  "address": {
    "city": "San Francisco",
    "country": "US",
    "line1": "1234 Main Street",
    "line2": "",
    "postal_code": "94111",
    "state": "CA"
  },
  "display_name": "My First Store",
  "livemode": false,
  "metadata": {}
}