-type payment_type():: credit_card | mobile | paypal | wire_transfer | facebook.
-type purchase_state() :: added | done | cancelled | pending | untracked.

-record(basket, {
        user_id                    ::any(),
        package_id                 ::any()}).

-record(membership_package, {
        id                         ::any(),      % package id
        payment_type               ::payment_type(),
        no                         ::integer(),  % package number (need to display in pricelist)
        amount                     ::integer(),  % price
        deducted_for_gifts         ::integer(),  % kakush currency charge
        net_membership             ::integer(),  % net membership fee
        available_for_sale = false ::boolean(),  % not used yet
        quota::integer()                         % game quota
        }).

-record(state_change, {
        time     :: erlang:now(),
        state    :: any(),
        info     :: any()}).

-record(membership_purchase, {
        id                    :: any(),
        external_id           :: any(),     % id of the purchase in external payment system if any
        user_id               :: any(),
        state                 :: purchase_state(),
        membership_package    :: #membership_package{},
        next                  :: any(),
        prev                  :: any(),
        start_time            :: erlang:now(),
        end_time              :: erlang:now(),
        state_log = []        :: [#state_change{}],
        info                  :: any()      % payment-specific info about purchase if any
        }).

-record(user_purchase, {
        user :: any(),
        top           :: any()
        }).

-define(MP_STATE_ADDED,     added).
-define(MP_STATE_DONE,      done).
-define(MP_STATE_CANCELLED, cancelled).
-define(MP_STATE_UNTRACKED, untracked).
-define(MP_STATE_PENDING,   pending).
-define(MP_STATE_FAILED,    failed).
-define(MP_STATE_UNKNOWN,   unknown).
-define(MP_STATE_CONFIRMED, confirmed).
-define(MP_STATE_UNEXPECTED, unexpected).
-define(MP_STATE_DISCARDED, discarded).
-define(MP_MONTHLY_LIMIT_MULTIPLIER, 3).

-record(pi_credit_card, {
        cardholder_name,
        cardholder_surname,
        cardnumber_masked,
        retref_num,
        prov_date,
        auth_code
        }).