xMoney Crypto for PrestaShop

Accept Bitcoin, Ethereum, eGLD, UTK Token, and other juicy cryptocurrencies directly on your online store and get settled in the currency of your choice.

With xMoney Crypto Pay, grow your business by allowing your customers to enjoy a vast portfolio of fiat & crypto currencies when purchasing goods and services, with a zero-fee exchange rate.

Find out more at xMoney.com/crypto-pay

xMoney is the world's digital payments network for all things money. Crypto-enabled & Fiat-ready, with a suite of solutions for anyone, anywhere. Powered by MultiversX.

Requirements

• xMoney Crypto Merchant account
• Online store using PrestaShop v1.7.x
• If you're still using PrestaShop v1.6.x, download module from here

Install and Update

Installing

1. Download our latest release zip file on the releases page.
2. Go to your PrestaShop admin dashboard (it should be something like https://<your-store.com>/admin).
3. Navigate to the Modules and Services -> Modules and Services.
4. Click Add a new module on top and upload the zip file.
5. After the module being uploaded, click Install and Proceed with Installation
6. Once installed, follow the Setup instructions bellow.

Updating

You can always check our releases page for a new version. To update just follow steps 2, 3 and 4 on the above install instructions.

Setup

On the xMoney Crypto side

1. Go to xMoney Crypto merchant dashboard.

2. Log in or sign up if you didn't yet.

3. On the left sidebar choose Integrations.

4. Select PrestaShop and click the button Generate Credentials.

5. You will see now your Api Key and Webhook Secret, save them somewhere safe temporarily.

   ⚠️ You will only be able to see the Webhook Secret once, after refreshing or changing page it will be no longer available to copy; if needed, you can always generate new credentials.

   🚫 Don't share your credentials with anyone. They can use it to place orders on your behalf.

On the PrestaShop side

1. Go to your PrestaShop admin dashboard.
2. Navigate to the Modules and Services -> Modules and Services.
3. Search for Utrust in the list and click Configure
4. Add your Api Key and Webhook Secret and click Save.

Features

✨ These are the features already implemented and planned for the xMoney Crypto for PrestaShop plugin:

• Creates Order and redirects to xMoney Crypto payment widget
• Receives and handles webhook payment received
• Receives and handles webhook payment cancelled
• Starts automatic refund on xMoney Crypto when refund initiated in PrestaShop

Support

Feel free to reach by opening an issue on GitHub if you need any help with the xMoney Crypto for PrestaShop plugin.

If you're having specific problems with your account, then please contact support@xmoney.com.

In both cases, our team will be happy to help 💜.

Contribute

This plugin was initially written by a third-party contractor (Bleujour/Infopolis), and is now maintained by the Utrust development team.

We have now opened it to the world so that the community using this plugin may have the chance of shaping its development.

You can contribute by simply letting us know your suggestions or any problems that you find by opening an issue on GitHub.

You can also fork the repository on GitHub and open a pull request for the master branch with your missing features and/or bug fixes. Please make sure the new code follows the same style and conventions as already written code. Our team is eager to welcome new contributors into the mix 😊.

Development

If you want to get your hands dirty and make your own changes to the xMoney Crypto for PrestaShop plugin, we recommend you to install it in a local PrestaShop store (either directly on your computer or using a virtual host) so you can make the changes in a controlled environment. Alternatively, you can also do it in a PrestaShop online store that you have for testing/staging.

Once the plugin is installed in your store, the source code should be in modules/UTRUST. All the changes there should be reflected live in the store. When you add a translation string like l s='This is phrase' mod='UTRUST' it should automatically appear in "Admin dashboard" -> "Localization" -> "Translations" -> "Modify Translations" (section) and choose the Type of translation "Installed modules translations" and the desired language. Search for Utrust and make the changes. Once you save, it will store the translations in Utrust module code (folder translations). f something goes wrong, logs can be found in /log.

Publishing

For now only members of the Utrust development team can publish new versions of the Utrust for PrestaShop plugin.

To publish a new version, simply follow these instructions.

License

The xMoney Crypto for PrestaShop plugin is maintained with 💜 by the xMoney Crypto development team, and is available to the public under the GNU GPLv3 license. Please see LICENSE for further details.

© Utrust 2024