2Checkout Inline for RD-Subscriptions

1. Начало

Данный плагин обеспечивает интеграцию RD-Subscriptions с 2Checkout. RD-Subscriptions - это компонент для организации подписки на сайте на базе Joomla. 2Checkout - платежная система, работающая более чем с 200 торговыми площадками и поддерживающая 15 валют и 7 языков.

Требования:

  • Joomla 3.6.x+
  • RD-Subscriptions 2.3.0+
  • Валидный SSL сертификат

Крайне рекомендуется использование SSL сертификата для гарантирования безопасной передачи персональных данных пользователей.

Note: 2Checkout payment platform offer several checkout experience to receive funds: Standard, Payment API and Inline. This plugin operates as 2Checkout Inline.

2. Installation

2Checkout Inline for RD-Subscriptions can be installed as typical Joomla extensions. Make sure you have downloaded latest version of the plugin. Go to Administrator panel > Extensions > Manage > Install

3. Configuring the plugin

There are several tabs with settings. Let’s consider each tab.

3.1. Plugin tab

  • Currency - Set your checkout currency. Available currencies: AFN, ALL, DZD, ARS, AUD, AZN, BSD, BDT, BBD, BZD, BMD, BOB, BWP, BRL, GBP, BND, BGN, CAD, CLP, CNY, COP, CRC, HRK, CZK, DKK, DOP, XCD, EGP, EUR, FJD, GTQ, HKD, HNL, HUF, INR, IDR, ILS, JMD, JPY, KZT, KES, LAK, MMK, LBP, LRD, MOP, MYR, MVR, MRO, MUR, MXN, MAD, NPR, TWD, NZD, NIO, NOK, PKR, PGK, PEN, PHP, PLN, QAR, RON, RUB, WST, SAR, SCR, SGD, SBD, ZAR, KRW, LKR, SEK, CHF, SYP, THB, TOP, TTD, TRY, UAH, AED, USD, VUV, VND, XOF, YER.
  • Sandbox - When running in the sandbox mode you need to enter your private and publishable key for the sanbox account. You can now simulate payments like real payments.
  • Refunds - Turn this option on to initiate refunds from the backend of your website.
  • Verify SSL - During testing you might want to turn off the verification of SSL, it is advised to turn it on on live environments.
2Checkout Inline for RD-Subscriptions - Plugin Settings
Plugin Setting

3.2. API Setting Live Environment tab

Here are API Credentials for Live Environments.

  • Seller ID - Enter the seller ID from the 2Checkout, this is being used to initiate payments.
  • Secret Word - You can find your Secret Word on the Site Management tab of 2Checkout Dashboard.
  • API Username - The API password is being used to initiate refunds from the backend.
  • API Password - The API password is being used to initiate refunds from the backend.
  • Publishable Key - You can find your Publishable Key in the dashboard of 2Checkout API.
  • Private Key - You can find your Private Key in the dashboard of 2Checkout API.
2Checkout Inline for RD-Subscriptions - Live Environment Setting
Live Environment Setting

3.3. API Setting Test Environment tab

Here are API Credentials for Sandbox Environments.

  • Seller ID - Enter the seller ID from the 2Checkout, this is being used to initiate payments.
  • API Username - The API username is being used to initiate refunds from the backend.
  • API Password - The API password is being used to initiate refunds from the backend.
  • Publishable Key - You can find your Publishable Key in the dashboard of 2Checkout API.
  • Private Key - You can find your Private Key in the dashboard of 2Checkout API.
2Checkout Inline for RD-Subscriptions - Test Environment Setting
Test Environment Setting

3.4. Custom Note tab

It’s Custom note field that will be displayed at checkout page. HTML tags are allowed. Also you can add custom macros (RokCandy or similar extension).

  • Custom Note - You may use the custom note for showing customers a notice at the checkout, before entering the credit card details. You can style the text by adding a class to your CSS file 'custom-note-2checkout' which can be styled the way you like.
2Checkout Inline for RD-Subscriptions - Custom Note Setting
Custom Note Setting

3.5. Вкладка "Ключ скачивания"

Вкладка Ключ скачивания платёжного плагина 2Checkout Inline for RD-Subscriptions
Вкладка Ключ скачивания

Ключ скачивания обеспечивает возможность оповещения администратора сайта о новой версии плагина и позволяет обновить его из админ.панели в несколько кликов. Укажите ключ скачивания для включения возможности обновления через встроенную в Joomla систему обновления расширений. Вы можете найти ваш ключ в списке подписок на веб-сайте NorrNext.

Если вы указываете ключ в первый раз или изменили его, то нажмите на кнопку Обновить ключ для его сохранения во встроенной системе обновления расширений.

Официальное руководство: Включаем обновление в один клик в коммерческих расширениях NorrNext

4. 2Checkout Dashboard Settings

Make sure you have configured 2Checkout settings correctly. Sign in to 2Checkout Dashboard, then go to Account > Site Management

There are important settings that must be filled:

  • Demo Setting (Yes, No or Parameter)
  • URL: required parameter. You are able to enter URL one time, so be careful.
  • Pricing currency - set the correct currency
  • Refund Policy and Privacy Policy - refer to your site URLs
  • Direct Return - must be selected to Header Redirect (Your URL)
  • Secret Word - enter your secret word
    2Checkout Dashboard settings
    2Checkout Dashboard settings
2Checkout Dashboard settings
2Checkout Dashboard settings

Save the changes. Now it’s time to go to API menu item to generate Publishable Key and Private Key which are using by 2Checkout to provide refunds. So, just generate and take Publishable & Private Keys to paste to 2Checkout Inline plugin settings.

5. FAQ

Does 2Checkout support payment via PayPal?
Yes, if customer has the same e-mail account in PayPal and at your site, a special PayPal button will be appeared during checkout.

Can I use 2Checkout standard mode?
No. This plugin operates with Inline mode only.

What does ERROR CODE:PE101 means?
In rarely cases some users can get such error which means that the bank of has refused the payment. In such case it’s better to repeat the payment after some time or use card issued by another bank.