FloPay Docs

All constants exported by @flopay/shared, including SDK version, themes, element types, card brands, and currency mappings.

Themes

`DEFAULT_APPEARANCE`

const DEFAULT_APPEARANCE: FloPayAppearance = {
  theme: 'default',
  variables: {
    colorPrimary: '#4A49FF',
    colorBackground: '#FFFFFF',
    colorText: '#262833',
    colorDanger: '#DF1B41',
    borderRadius: '8px',
    fontFamily: 'Poppins, system-ui, sans-serif',
    fontSizeBase: '16px',
    spacingUnit: '4px',
  },
};

The default appearance applied when no custom appearance is provided.

`FLAT_APPEARANCE`

const FLAT_APPEARANCE: FloPayAppearance = {
  theme: 'flat',
  variables: {
    ...DEFAULT_APPEARANCE.variables,
    borderRadius: '4px',
  },
};

Flat theme with minimal borders and shadows. Inherits all variables from DEFAULT_APPEARANCE except borderRadius.

`NIGHT_APPEARANCE`

const NIGHT_APPEARANCE: FloPayAppearance = {
  theme: 'night',
  variables: {
    colorPrimary: '#7B7BFF',
    colorBackground: '#1A1A2E',
    colorText: '#E0E0E0',
    colorDanger: '#FF6B6B',
    borderRadius: '8px',
    fontFamily: 'Poppins, system-ui, sans-serif',
    fontSizeBase: '16px',
    spacingUnit: '4px',
  },
};

Night (dark) theme with a dark background.

Element Types

`ELEMENT_TYPES`

const ELEMENT_TYPES: readonly ['payment', 'card', 'cardNumber', 'cardExpiry', 'cardCvc', 'address'];

All supported element type identifiers. Used to validate element creation.

Currency

`CURRENCY_MAP`

const CURRENCY_MAP: Record<string, CurrencyInfo>;

Maps ISO 3166-1 alpha-2 country codes to currency information. Includes entries for:

Region	Countries	Currency
Eurozone + EU	AT, BE, BG, CY, CZ, DE, DK, EE, ES, FI, FR, GR, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK	EUR
United Kingdom	GB	GBP
United States	US	USD
Canada	CA	CAD
New Zealand	NZ	NZD
Australia	AU	AUD

Each entry is a CurrencyInfo object with currency, symbol, country, countryCode, and tax (0 or 1).

`DEFAULT_CURRENCY`

const DEFAULT_CURRENCY: CurrencyInfo = {
  currency: 'USD',
  symbol: '$',
  country: 'United States',
  countryCode: 'US',
  tax: 0,
};

Default currency information returned when a country is not in CURRENCY_MAP.

Countries, States & Provinces

`COUNTRY_OPTIONS`

const COUNTRY_OPTIONS: CountryOption[];

The full list of ISO 3166-1 alpha-2 countries used by the AVS country dropdown. Priority countries (US, GB, CA, AU, NZ, EU) appear first; the remainder are sorted alphabetically. Each entry has code, name, and flag (emoji).

Use getCountryByCode to look up a single entry.

`US_STATES`

const US_STATES: { code: string; name: string }[];

51 entries — all 50 US states plus District of Columbia. Codes are 2-letter USPS abbreviations (e.g. 'AL', 'CA', 'WY').

Used by the SDK to render a <select> for the AVS state field when country === 'US'.

`CA_PROVINCES`

const CA_PROVINCES: { code: string; name: string }[];

13 entries — all 10 Canadian provinces plus 3 territories. Codes are 2-letter ISO 3166-2:CA subdivisions (e.g. 'AB', 'ON', 'QC').

Used by the SDK to render a <select> for the AVS state field when country === 'CA'.

See getStateOptions and getStateLabel for the helpers that consume these.

Constants

SDK Version and API

`SDK_VERSION`

`DEFAULT_API_BASE_URL`

`DEFAULT_API_VERSION`