WooCommerce Stellar

Your Stellar account may display as invalid if:

1. you have entered an incorrect Stellar address
2. your account has a balance of 0 Stellar - to avoid spam accounts, accounts must have a minimum of 20 Stellar

When you enter you account address, the extension will check your account to see which currencies it accepts. If your store's currency is not in the set of currencies your Stellar account accepts, then the extension will not display Stellar as a payment method on checkout. To have it display, you can either:

1. change your store's currency to Stellar (STR)
2. add the store's currency to your Stellar account

Stellar will attempt to find a path between the currency/currencies your customer holds a balance in, and the currency you are selling in. In theory, this means Stellar can be used to sell in any currency. In practice, your customers may only be able to pay in currencies in which they already hold a balance. Because the Stellar network is still young, the available paths between currencies are limited. You may have trouble selling in less popular currencies, like AUD or NZD, to customers who do not hold a balance in this currency. Rest assured, things are moving fast and it won't be too long before your customers in Hanoi can pay in Dong (VND), while you'll receive it in the mighty greenback (USD).

1. Login to your Stellar Dashboard
2. Click the add a currency link (displayed under your balance)
3. Enter the full URL of a Stellar gateway which supports multiple currencies (list of gateways)
4. Add the gateway to your account

To sell from multiple WooCommerce stores, you will need to create a new Stellar account for each store. Because the Stellar protocol only accepts numerical Destination Tags, there is no way to prefix them for different stores (e.g. JFK-12358 or SFO-1321). This restriction makes it unfeasible to use the same Stellar account on more than one site. The good news is, creating a Stellar account is both easy and free. You'll just need to seed each account with a few hundred Stellar before you can use them to accept payments.

The WooCommerce Stellar extension uses Destination Tags to match an order with a payment. Stellar accounts can be configured to require Destination Tags on all incoming payments or accept payments without a corresponding Destination Tag. If a Stellar account does not require Destination Tags, customers are able to make a payment that can not be matched with an order. This means a store manager will need to manually find the payment in their account and mark the order in WooCommerce as paid. When a Stellar address is saved on WooCommerce > Settings > Checkout > Stellar administration screen, the extension checks the account to see if it requires Destination Tags. If the account does not require Destination Tags, the WooCommerce Stellar extension encourages you to configure your account to require Destination Tags and avoid transactions that can not be automatically matched.

Yes! The Destination Tags notice provides a convenient way to configure your account to require Destination Tags (as there is no graphical interface available via the Stellar client to set this, yet). In order to configure your account, the extension needs your Stellar Secret Key. The extension tries to be as secure as possible with your sensitive key. It sends it directly from your browser to Stellar.org. It does not send your key to your web server, or any other web server, and it definitely does not store your key anywhere. This greatly reduces the risk of your secret key being stolen by an attacker; however, if you have malicious code running in your browser, for example, some JavaScript served by a hacked WordPress plugin, that code will be able to steal your Secret Key (and do all sorts of other nasty things with your site). If you would prefer not to enter your Secret Key in your browser, you can configure your account manually using the AccountSet API command. For example, you can use the following from Mac OS X's terminal application (after entering your secret key and account address): curl -X POST https://live.stellar.org:9002 -d ' { "method": "submit", "params": [ { "secret": "", "tx_json": { "TransactionType": "AccountSet", "Account": "", "SetFlag": 1 } } ] }'

1. Login to your Stellar Dashboard
2. Click your username in the header menu
3. Scroll to the bottom of the Settings page
4. Click Reveal next to the Secret Key setting

If you've found a bug in the extension or have a feature request, please open a new issue on the WooCommerce Stellar GitHub repository. If you have a question, post a topic in the WordPress.org WooCommerce Stellar Forum. We may or may not reply, but would appreciate help from other users of the extension in handling support - while our code is free our time is not.