Payment Plugins for Joomla J2Store Documentation

At this stage, we assume you have downloaded and installed the J2Store Coinbase Commerce payment gateway plugin and now on the J2Store Payment methods page, J2Store => Setup => Payment methods.

One the J2Store payment methods page, locate and click on the Coinbase Commercer (Redirect and Modal) payment plugin link to open the configuration page for the plugin.

Below are detailed explanations for the various configuration fields on the page.

• (1) Status

  Select Enabled to publish and display the Coinbase Commerce payment method in the frontend checkout page under payment methods; otherwise, select Disabled.

• (2) Payment Option Title

  Enter the name that you would like to show on the checkout page for the Coinbase Commercer payment method.

• (3) Display Logo

  If you would like to display a logo for this payment method alongside the title on the checkout page, simply select the image here.

• (4) Coinbase Payment Method

  There are two options for you to select:

  1) Redirect (Off-the-site)

  Select the Redirect option for off-the-site redirect payment method. Customers will be redirected to a unique Coinbase Commerce payment page to complete their payment after which they will be redirected back to your website.

  
  

  
  

  2) Modal (On-the-site)

  Select Modal option for on-the-site modal pop up payment method. Customer will be presented with a modal pop up and will be able to complete payment without leaving your website.

  
  

• (5) Coinbase Commerce API Key

  Login into your Coinbase Commerce account (https://commerce.coinbase.com/) and navigate to the Settings page.

  
  

  
  Scroll down and locate the API Keys section. Click on Create an API Key link to create a new API key that will be used to connect your website to your Coinbase Commerce account.

  Copy the created API Key from Coinbase Commerce settings page and paste it into the Coinbase Commerce API Key field in your plugin settings.

• (6) Your Coinbase Commerce Webhook URL

  You need to create a Webhook Subscription within your Coinbase Commerce account by following the steps below:

  1. Navigate to the Settings page in your Coinbase Commerce account and scroll down to the Webhook Subscriptions section. Click on the Add an endpoint link to open a subscription box.

     
     

     
     

  2. Copy the full URL in your plugin settings Your Coinbase Commerce Webhook URL field into the Coinbase Commerce New Webhook Subscription endpoint field.

     
     

     
     

  3. Finally, click on the Save button to save the webhook subscription.

• (7) Coinbase Webhook Shared Secret

  Still on the Webhook Subscriptions section, click on the Show shared secret link to reveal your Coinbase Commerce Webhook Shared Secret.

  Copy and paste the shared secret into the Coinbase Webhook Shared Secret field within your plugin settings.

  
  

• (8) Article ID for thank you message

  Select the article that is displayed to customer after payment is successfully processed. It can include anything and should at the very least tell your customer to wait for the routine confirmations to finish taking place before their order is automatically activated by the plugin.

• (9) Geozone

  You can select a geozone here and restrict this payment method from displaying to customers outside the selected geozone. Choose All geozones to show this payment method to all customers.

• (10) Display text on selection

  Enter text you would want to display to customer once he selects this payment method. Leave empty if you don't want to display any text.

  You can enter a language constant as a value here if you are using a multi-lingual site and then write a language override.

• (11) Display text before payment

  Enter text you would want to display to customer on the order summary step just before the Place Order button. Leave empty if you don't want to display any text.

  You can enter a language constant as a value here if you are using a multi-lingual site and then write a language override.

• (12) Display text on after payment

  Enter text you would want to display to customer after payment completion. Leave empty if you want to display only the thank you message article.

  You can enter a language constant as a value here if you are using a multi-lingual site and then write a language override.

• (13) Display text on error in payment

  Enter text you would want to display to customer when there is error in making payment. Leave empty if you don't want to display any text.

  You can enter a language constant as a value here if you are using a multi-lingual site and then write a language override.

• (14) Display text if customer cancels payment

  Enter text you would want to display to customer when customer cancels the payment at the gateway. Leave empty if don't want to display any text.

  You can enter a language constant as a value here if you are using a multi-lingual site and then write a language override.

• (15) Payment button text

  Enter text for the payment button here; otherwise, the default text will be used.

  You can enter a language constant as a value here if you are using a multi-lingual site and then write a language override.

• (16) Debug

  WARNING: This is for troubleshooting purpose only and should NOT be set to Yes unless temporary requested by a tech support person.

  Set this to Yes if you want to log the request and responses of the Coinbase Commerce gateway payment plugin.

• Plugin Language Translation for Multilingual Website

  If you run a multilingual website and you have selected the Modal payment method option under Coinbase Payment Method settings above, then you might need to translate the plugin payment instructions to other languages apart from English (en-GB).

  The highlighted areas in the screenshot image below can be translated easily.

  
  

  
  To translate, simply follow the steps below:

  1. Navigate to the following folder, YOUR_SITE_ROOT/administartor/language/en-GB/, in your site root.
  2. Locate the plugin default language file, en-GB.plg_j2store_payment_coinbase.ini.
  3. Copy the located en-GB plugin language file to your desired language folder. For example, you can copy it to the fr-FR language folder for French language translation.
  4. Rename the copied language file's language code prefix accordingly. For example, rename the language file from en-GB.plg_j2store_payment_coinbase.ini to fr-FR.plg_j2store_payment_coinbase.ini.
  5. Lastly, open the renamed language file and translate the existing language constants accordingly.
  6. You should repeat these steps for all the active languages on your website.

After every necessary fields have been filled up, simply click on Save & Close button at the top to save the payment plugin configuration.

Now Coinbase Commerce payment method will start showing on the frontend checkout page under payment methods section, ready for customers to choose it as their preferred payment method.