Your first invoice

This document describes the whole process you should do after Deploying to get your first invoice in your store!

Registering on an instance

The first step in setting up your Bitcart instance is creating a user account. The first created account on a newly-deployed Bitcart instance is automatically - admin.

Server admins have the same access to features as the regular users, but they are also provided with some server management tools like server upgrade or server policies management.

To register, visit your Bitcart URL and fill in the account registration form. Input your password, password confirmation, e-mail and click "Register". You will automatically be logged in.

Creating a wallet

Inside Bitcart, you can setup and manage an unlimited number of wallets. Each wallet has its own xpub (BTC-based blockchains) or a single wallet address (ETH-based blockchains), and currency. One wallet holds one currency.

Bitcart is a non-custodial software, which means that all the funds received to your store, will end up directly into your connected wallet.

You need to have your blockchain wallets created beforehand to specify their details in Bitcart! (more on this below)

Creating a wallet for Bitcoin-based blockchains (BTC)

Note: A private key (xprv) is never required for receiving money on-chain to a Bitcart wallet. The software needs a public key (xpubkey) which is a watch-only wallet token. The xpubkey allows Bitcart to generate a new address each time a new invoice is generated. It enables users to observe the wallet balance and transactions without having to share their private key.

To manage the funds received to your Bitcart wallet, you can use an external wallet.

We recommend that you use the wallet which:

  1. Allows connection to a full node

  2. Allows custom gap limit

The most recommended wallet for use with Bitcart is the Electrum wallet, as Bitcart uses electrum internally, which makes it perfectly integrated.

Creating a wallet for ETH-based blockchains (ETH, BSC)

You can use any ETH-compatible wallets (e.g. MetaMask, or Mycellium) to create your ETH or BSC wallets. Copy-paste your wallet address from wallet software to Bitcart into "Wallet / Xpub" input.

Creating a wallet in Bitcart UI

To setup wallets, make sure you're logged in into your account, and go to > Wallets by clicking Details button on the card. Click on the create wallet button and fill in the wallet name, currency(optional, default btc) and xpub (or wallet address for ETH-based blockchains).

Create a store

Inside Bitcart, you can create and manage an unlimited number of stores. Each store has its own wallet or wallets (it allows multicurrency checkout), can create products, invoices or be connected with external e-commerce software through one of the integrations.

To create a store, make sure you're logged in into your account, and go to > Stores page by clicking on Details in it's card. Click on the New Store button. Enter the store name, and select this store's wallets.

Customizing your Bitcart Store Settings

You can always edit your store by clicking the edit icon.

To configure email servers, click on email icon in actions column.

For more information, check Stores FAQ.

Creating your invoice

You can create your invoice in a variety of different ways

Via admin panel UI

This method is one of the most obvious. You can create invoices from the panel, manage your orders and send links to checkout pages to your customers. Click on the show button in the payment methods column to view the checkout page.

Via store POS

Bitcart provides a ready to use store POS. You can manage your products and invoices right from the admin panel! Check out the POS guide

Via our e-commerce integrations

Depending on the CMS you're using, you can easily connect Bitcart to your online store. Currently, Bitcart offers following integrations :

Join our community!

That's it, your first invoice was created with ease!

If you have questions, try searching our FAQ Section or join the Bitcart Community and share questions and ideas for improvement.

If you are a developer take a look at the Local Development guide and help us with any open issues on Github. If you would like to contribute to Bitcart in other ways, check out the Contribution Guide for ideas.

Last updated