---
description: >-
  Learn to install and use the Woocommerce plugin in your ecommerce and start to
  receive payments in Bitcoin!
---

# TurinPay Woocommerce plugin and test shop

Download the zip file woocommerce-turinpay-main.zip .

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FVKzhxNuEbynbyPpC2yKa%2FCaptura%20de%20Pantalla%202022-10-29%20a%20las%2017.10.07.png?alt=media&#x26;token=faf18467-3089-4c3d-b5a2-1cf0d984ce94" alt=""><figcaption><p>Image 1. Download the zip file</p></figcaption></figure>

Install and activate the plugin on your WordPress site.

From the WordPress Dashboard, go to Plugins>Add New and on the top left click ‘Upload Plugin’ then the ‘Choose File’ button will appear and select the downloaded zip file woocommerce-turinpay-main.zip and click ‘Install Now’.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FaT2myHRvZ5CyIXV2OAvP%2FCaptura%20de%20Pantalla%202022-10-29%20a%20las%2017.10.20.png?alt=media&#x26;token=b130fdd5-c911-4df6-9591-c1601684224a" alt=""><figcaption><p>Image 2. Install the zip file in your Wordpress</p></figcaption></figure>

Once the installation is complete, click activate button to activate the plugin.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FoxDaeFERJSPSPku1YWb7%2FCaptura%20de%20Pantalla%202022-10-29%20a%20las%2017.10.30.png?alt=media&#x26;token=933f3244-acd0-4265-a116-52f410f62d2d" alt=""><figcaption><p>Image 3. Activate the plugin</p></figcaption></figure>

After activating the plugin, proceed on creating a turinpay account to get the API keys for woocommerce turinpay API settings.

Sign up for an account here: [https://app.turinpay.com/signup](https://app.turinpay.com/signup) or if you already have an account please look in your dashboard > API Keys and it will display a popup.&#x20;

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2Fi9PHYEhFhvcQm0eAbH0m%2FCaptura%20de%20Pantalla%202022-10-29%20a%20las%2017.10.40.png?alt=media&#x26;token=24b74da6-cdc0-43bd-8b9a-f70472113fa8" alt=""><figcaption><p>Image 4. Create your account in TurinPay and test your Development API key.</p></figcaption></figure>

Copy the API keys to your woocommerce. From the WordPress Dashboard, go to Woocommerce > Settings > Payments > Turinpay Processing:

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FUvNn9rW8gJgypRIfi6Jq%2FCaptura%20de%20Pantalla%202022-10-29%20a%20las%2017.10.54.png?alt=media&#x26;token=6d29856b-c002-450c-9ec2-4a0bb27bc73b" alt=""><figcaption><p>Image 5. Locate your API keys in the plugin</p></figcaption></figure>

Enable the Turinpay Gateway then click the “Manage” button so it will be redirected to Turinpay API Settings. From there you can now paste the copied API keys in their respective box.

_Disclaimer: you receive a Development API key with your TurinPay account. Once you test the product ask for the Production API key to Turin Labs filling the form in app.turinpay.com._

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2Ffgwi8qEuuvkdcZveXdKd%2FCaptura%20de%20Pantalla%202022-10-29%20a%20las%2017.11.08.png?alt=media&#x26;token=b514ed5e-b2ad-4079-a8cb-47a32b5b9693" alt=""><figcaption><p>Image 6. Text your API keys in the plugin</p></figcaption></figure>

Also, the plugin have 2 modes (Test and Live) for this documentation we have used the test mode, so we can freely demonstrate how the plugin works. Note that you can switch it anytime.&#x20;

Lastly, it is required to tick the “Debug Log” option to record any bugs that you might experience. Easy to track and easy to solve.&#x20;

After installing and setting up the plugin on Wordpress, it is also necessary to install the TurinWallet on Android or iOS APP (to test the payments from the user side). **Note: the same account will be used to login on TurinWallet.**

Links to install TurinWallet in [GooglePlay](https://play.google.com/store/apps/details?id=com.turinlabs.wallet) and [AppleStore](https://apps.apple.com/us/app/turinwallet/id1621685642) here.

TurinWallet plays a big role for easy payments method to your woocommerce products.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FoWPx0KpTY3O7Vbu2xo50%2Ftw1.png?alt=media&#x26;token=6701c211-8b59-448f-9505-5de9a0c3d645" alt=""><figcaption><p>Image 7. Downloading TurinWallet from a store</p></figcaption></figure>

After installing the TurinWallet APP, login using your Turinpay Email & Mobile number.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FUPypU3rVLRJmThrHAWzR%2Ftw2.png?alt=media&#x26;token=bb865ca9-0ea1-4f97-a3ff-63064aee0c88" alt=""><figcaption><p>Image 8. Signing up in TurinWallet</p></figcaption></figure>

Please take note of the Mobile Number prefix to match your country’s phone number.

After filling up your login details the APP will request for a 2FA 6-digit code from both your email and mobile number. This is to secure your account from being breached.&#x20;

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2F5hMOiBBSSxKh0fHyC4MH%2Ftw3.png?alt=media&#x26;token=38001c55-0bf0-4620-a641-1914d7942087" alt=""><figcaption><p>Image 9. Signing up in TurinWallet</p></figcaption></figure>

### 1. Using Developer mode.

TurinWallet is the only Bitcoin wallet that incorporates a Developer mode to test payments with faucet Bitcoin (not real BTC). And you don't need to have faucet BTC in your wallet, the APP generates itself in the payment moment.&#x20;

To start testing  on your mobile click on the account icon on the top right-hand side of the app and turn on the ‘Developer Mode’.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FhfvnQEZ84Dm9HfAUcSL5%2Ftw4.png?alt=media&#x26;token=b56bbaaf-8873-485e-a6e2-75157a8ba758" alt=""><figcaption><p>Image 10. Testing in Developer mode</p></figcaption></figure>

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FUN8qJitTwiTI1YCc0etu%2Ftw5.png?alt=media&#x26;token=849ad000-b280-4d74-89e3-ca2b69a48988" alt=""><figcaption><p>Image 11. Activate the developer mode</p></figcaption></figure>

You notice the bottle icon appearing when you switch the mode to ‘Developer mode’. **We will use this icon to make test payments**.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2F1EJD3D4wSSwnT4XAobbH%2Ftw6.png?alt=media&#x26;token=0f92a24b-d324-4d23-8aac-acfbe4305e78" alt=""><figcaption><p>Image 12. Button used to pay in Developer mode</p></figcaption></figure>

Once the process is complete, you can pay using your Turinwallet. There are 2 ways to make a payment with Turinpay. Here’s an example:

1.1. If you’re on PC or laptop you can scan the QR code using your mobile app to pay instantly. Go to the test shop you have in the website [clicking here](https://www.turinlabs.com/turinpay#woocommerce).

The test shop is also available on [https://yenze.io/turinlabs/](https://yenze.io/turinlabs/).

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FpwIxxIBr6gR15MFjEgKx%2FCaptura%20de%20Pantalla%202022-10-29%20a%20las%2017.13.42.png?alt=media&#x26;token=810ee2ba-c46a-4e5a-a9e3-47d7133f4fbc" alt=""><figcaption><p>Image 13. Clicking in "Add to cart"</p></figcaption></figure>

1.2. Go to shop page the click add to cart > Proceed to checkout.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FUTbwPGw6CTBPfP4oSDhu%2FCaptura%20de%20Pantalla%202022-10-29%20a%20las%2017.14.00.png?alt=media&#x26;token=ca6eda50-2bfb-4619-9c57-1253f25e0b58" alt=""><figcaption><p>Image 14. Click on "Proceed to checkout"</p></figcaption></figure>

1.3. Fill out the required billing details then tick the “Checkout with Turinpay” option under "Your order". Proceed clicking the “Pay via Turinpay” button.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2Fa2qx9cHuPoDUF7osvUSw%2FCaptura%20de%20Pantalla%202022-10-29%20a%20las%2017.14.23.png?alt=media&#x26;token=d848a25d-d818-454d-aef4-6efc015d18cf" alt=""><figcaption><p>Image 15. Clicking on "Pay via Turinpay"</p></figcaption></figure>

1.4. After clicking this will display a pop-up indicating to pay with your TurinWallet. Click the turinpay logo and you will notice the QR code display. You can scan it using your mobile app.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FJD51a1P5O2p2PrV24hQT%2Ftw7.png?alt=media&#x26;token=6c713273-3e7f-4583-9bc5-89f3269bf990" alt=""><figcaption><p>Image 16. Generating the invoice to be paid</p></figcaption></figure>

If you are using mobile phone, you need to copy the invoice code:

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2Fl2ckv0VaOpKtz4Gh2CgY%2Ftw8.png?alt=media&#x26;token=981c7f70-e946-4bcf-be6c-f329dfd5e9e6" alt=""><figcaption><p>Image 16. Generating the invoice to be paid from a mobile phone</p></figcaption></figure>

1.5. Click the bottle icon on the upper part of your mobile screen then it will display a popup and click the “copy from clipboard” button to proceed with payment.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FGalTTn49nUBCOloehZtX%2Ftw9.png?alt=media&#x26;token=fa19c82d-1bc3-430d-8be6-114b3e1b3c9a" alt=""><figcaption><p>Image 17. Paying the invoice from TurinWallet Developer mode</p></figcaption></figure>

Scan the invoice and "Slide to confirm"... it's done! TurinPay Wocommerce plugin in testnet is working!

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FmuGTkpIA1rju0mgiqtfO%2Ftw12.png?alt=media&#x26;token=966f602b-45f8-4217-b53d-a535f2b2410b" alt=""><figcaption><p>Image 18. "Slide to confirm" and... it's working</p></figcaption></figure>

### 2. Using Normal mode.

In normal mode you will receive "real BTC" in each payment. All you have to do is to process the payment there are 2 ways to make a payment with Turinpay. Here’s an example:

2.1. If you’re on PC or laptop you can scan the QR code using your mobile app to pay instantly.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FTWxalFd46wTA04ZfE7q5%2FCaptura%20de%20Pantalla%202022-10-29%20a%20las%2017.15.42.png?alt=media&#x26;token=e3b01eec-ed86-4cec-95be-3aeff4b2a522" alt=""><figcaption></figcaption></figure>

2.2. Go to the shop page the click add to cart > Proceed to checkout.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FUTbwPGw6CTBPfP4oSDhu%2FCaptura%20de%20Pantalla%202022-10-29%20a%20las%2017.14.00.png?alt=media&#x26;token=ca6eda50-2bfb-4619-9c57-1253f25e0b58" alt=""><figcaption></figcaption></figure>

2.3. Fill out the required billing details then tick the “Checkout with Turinpay” option under order summary. Proceed clicking the “Pay via Turinpay” button.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2Fa2qx9cHuPoDUF7osvUSw%2FCaptura%20de%20Pantalla%202022-10-29%20a%20las%2017.14.23.png?alt=media&#x26;token=d848a25d-d818-454d-aef4-6efc015d18cf" alt=""><figcaption></figcaption></figure>

2.4. After clicking this will display a pop-up indicating to pay with your Turinwallet. Click the turinpay logo and you will notice the QR code display. You can scan it using your mobile app.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FJD51a1P5O2p2PrV24hQT%2Ftw7.png?alt=media&#x26;token=6c713273-3e7f-4583-9bc5-89f3269bf990" alt=""><figcaption></figcaption></figure>

2.5. If you are using mobile phone, you need to copy the invoice code.

2.6. Click the pay icon on your mobile screen then it will display a popup and click the “copy from clipboard” button to proceed with payment.

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2F2XUGPPWqpJgRNvYgxRAu%2Ftw11.png?alt=media&#x26;token=6697bc31-150a-4248-ba3f-5bab3470c7c7" alt=""><figcaption></figcaption></figure>

Scan the invoice and "Slide to confirm"... it's done! TurinPay Wocommerce plugin in production is working!

<figure><img src="https://3339113552-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fduv9RCPXtlEXjZTUhtLH%2Fuploads%2FmuGTkpIA1rju0mgiqtfO%2Ftw12.png?alt=media&#x26;token=966f602b-45f8-4217-b53d-a535f2b2410b" alt=""><figcaption></figcaption></figure>
