Stores FAQ

What is underpaid percentage?

Underpaid percentage is a store checkout setting, which can be in range from 0 to 99, indicating that the payment may be that percent less than expected, and it will still be accepted as paid. For example, if customer sends from an exchange wallet and the fees are deducted from the sent amount, the payment will still be accepted if you set underpaid percentage to a small non-zero value.

What is the Use Dark Mode setting?

When enabling this store checkout setting, the checkout page will always be served in dark mode. Ensure to check that your logo is suitable for dark mode.

To keep consistent branding, you can change the default Bitcart logo to your own logo. For that, it must be accessible via the URL provided. Note that, no matter what resolution the image is, it will be fit into maximum height of 40.

Show recommended fee setting enables showing recommended fee for all onchain (i.e. not lightning) payment methods.

To configure it, you need to set the recommended fee confirmation target blocks setting, which configures the fee displayed. If you set it to 2, it would mean it will show the recommended fee for the customer to pay for his payment to be confirmed in 2 blocks. Default value is 1.

How do I change my payment method's name?

By default Bitcart uses currency symbol as method name, and if there are multiple wallets of the same currency connected it adds an index to it (BTC(1), BTC(2)).

In some cases you may want to have a custom label for your payment methods, for example to indicate if some payment method is for legacy payments, and another is for segwit payments.

To do that, just add a label to your wallet:

How do I display a checkout hint for customers?

Any wallet (payment method) may have a hint which will be displayed on checkout page. First of all, the default Bitcart hints are displayed (recommended fee unless disabled, and about sending exact amounts in eth). Your custom hint will be displayed below.

How do I randomize wallets used/distribute funds across multiple wallets?

Usually when you have multiple wallets of same currency (currency+contract pair) connected, it would be displayed like BTC (1), BTC (2) or with a custom label. But it is now possible to randomize wallet used. This is useful to either distribute funds across multiple wallets for even better privacy, or in case of ETH to improve UX of checkouts page. You will no longer see each method, but only one, selected randomly.

Why could anyone create an invoice without authorization? How to disallow that?

That's because, for store POS and custom integrations from different sites to work, it can't get an authorization token in a way which is not seen to the user. Currently all integrations work same way.

But it is possible to make authorization mandatory on a per-store basis in store settings:

Please note that, when disallowing anonymous invoice creation, all plugins and store POS will break. Use this only if you have a custom integration where you are able to create invoices server-side only for authorized users only (otherwise, it is working same way as Bitcart works, but with another unnecessary layer of complexity added)

Last updated