Finance

cc type#

chance.cc_type()
chance.cc_type({raw: true})

Return a random credit card type.

chance.cc_type();
=> 'visa'

cc#

chance.cc()
chance.cc({type: 'Mastercard'})

Generate a random credit card number. This card number will pass the Luhn algorithm so it looks like a legit card.

chance.cc();
=> '6304038511073827'

Optionally specify a particular type of card to return:

chance.cc({ccType: CCType.mastercard });
=> '5171206237468496'

The types are enumerated below.

visa, mastercard, americanExpress, discover

currency pair#

Generate a currency pair. Handy for simulating currency conversions. Guaranteed to return a unique pair (and not the same currency twice).

chance.currencyPair()

currency#

chance.currency();
=> {
    'symbol': symbol,
    'name': name,
    'symbol_native': symbolNative,
    'decimal_digits': decimalDigits,
    'rounding': rounding,
    'code': code,
    'name_plurals': namePlurals,
}

dollar#

chance.dollar()
chance.dollar({max: 250})

Return a random dollar amount.

chance.dollar();
=> "$2560.27"

chance.dollar();
=> "$750.99"

By default returns dollar amount no larger than 10000. Optionally specify the max to make it larger (or smaller).

chance.dollar({max: 20});
=> "$15.23"

chance.dollar({max: 10000000})
=> "$5051205.49"

euro#

chance.euro()
chance.euro({max: 250})

Return a random euro amount. Formatting depends on the current locale (samples are displayed with european formatting)

chance.euro();
=> "2.560,27€"

chance.euro();
=> "750.99€"

By default returns euro amount no larger than 10000. Optionally specify the max to make it larger (or smaller).

chance.euro({max: 20});
=> "15,23€"

chance.euro({max: 10000000})
=> "5.051.205,49€"

exp month#

chance.expMonth()
chance.expMonth({future: true})

Generate a random credit card expiration month.

chance.expMonth();
=> '01'

Optionally specify that it must be a later month than the current month.

chance.expMonth({future: true});
=> '10'

So if called in June, this would return a random month from July - Dec. If called in October, would return November or December.

This because many credit card sandboxes require an expiration date later than the current date so it's necessary when generating an expiration with the current year to generate a month later than the current month.

exp year#

chance.expYear()

Generate a random credit card expiration year.

chance.expYear();
=> '2018'

Returns a random year between today and 10 years in the future.

exp#

chance.exp();
chance.exp({raw: true});

Generate a random credit card expiration.

chance.exp();
=> '10/2020'

Optionally specify that a raw object be returned rather than a string

chance.exp({raw: true});
=> {month: '11', year: '2017'}