NopCommerce Setup Guide

Accept Cryptocurrencies in NopCommerce at low cost!

Support Specialist avatar
Written by Support Specialist
Updated over a week ago

Step 1: Register Pay Account

  1. Sign up for a Pay account, if you don't already have one.

  2. Once you have access to the Pay Merchant Dashboard, You will be able to generate a secret key and publishable key pair. The API keys can be found inside the Integration > API Keys tab.

  3. Navigate to Integration > Webhooks tab. Click the Add Webhook button and then input https://<your-store-url>/Plugins/Crypto/Webhook as the Payload URL, then a signature secret for webhook is generated.

Step 2: Install the plugin on NopCommerce

You can download the Pay plugin in NopCommerce Marketplace.

Step 3: Setup Pay on NopCommerce

  1. After installing the Pay plugin, you can click Configuration > Payment methods on the navigation menu of the admin panel.

  2. You will be able to see “Crypto” on the list, click Configure.

  3. If you are testing with Test Data mode in Pay Merchant dashboard, please check Use Sandbox in Configure Page. Otherwise, please leave Use Sandbox unchecked.

  4. After that, please fill in secret key, publishable key and webhook signature secret on the page using the values you obtained from Step 1.

Note: Please make sure to select Use Sandbox if you are testing, and please make sure you input the keys and secrets correctly as they are different between Test mode and Live mode.

Step 4: Verify the flow

At this point, Pay is fully integrated with your NopCommerce store. But it is recommended to try the payment flow at least once.

For the convenience of testing, you may enable Test Data mode in Pay Merchant Dashboard. By following Step 1 in Test Data mode, you will be able to obtain another set of secret key, publishable key and webhook signature secret.

Refer here for how to complete a test payment.

When Pay approves the payment, the checkout window will indicate that the payment has been approved and your order status will also be updated.

After that, please navigate to the NopCommerce admin panel, follow Step 3 to input the settings and uncheck the Use Sandbox option. Now you are able to test your store without carrying out an actual transaction.

Step 5: Configure Account for LIVE transactions

Once the payment flow is thoroughly tested, you could enable LIVE transactions by following the below:

  1. Log in to the merchant account

  2. Make sure the Test Data button at menu bar is switched off.

  3. Click Integration tab on Dashboard menu bar, follow Step 1 at the top of this guide to generate a new set of publishable key and secret key values for Live Data mode. Add then add a new webhook for Live Data mode, copy these keys and secrets.

  4. Navigate back to your NopCommerce admin panel. Click Configuration > Payment methods. Click Configure button for the “Crypto” payment option.

  5. Uncheck Use Sandbox and fill in secret key, publishable key and webhook signature secret on the page using the values you obtained for Live Data mode.

Congratulations, you could now accept cryptocurrency payments in Live Data mode.

Did this answer your question?