Русская версия

beGateway payment module for Joomla and JoomShopping 4.x/5.x

System requirements

• cURL extension
• Joomla 4.x (the module was tested with version 4.4.5)
• JoomShopping 4.x/5.x (the module was tested with version 4.18.5/5.4.0)

The module installation

1. Download the latest version of the plugin joomshopping-begateway.zip
2. Go to Joomla's administration panel
3. Go to the menu Components -> JoomShopping -> Install & Update (arrow #1)
4. Install the module package
5. Open the page Upload Package File (arrow #2)
6. Select the module package file saved at the step 1.
7. Upload and install the module (arrow #3)

The module configuration

1. Go to Joomla's administration panel
2. Go to the menu Components -> JoomShopping -> Options (arrow #1) -> Payments (arrow #2)
3. Find the installed method by the code begateway and press the Edit icon (arrow #1)
4. Configure the module
5. Open the Config tab (arrow #1)
6. Edit the settings form
7. Click Save & Close button to save the payment method setttings and close the form (arrow #2)
8. Publish the payment method
9. Find the installed method by the code begateway in payment methods list and select it (arrow #1)
10. Publish it (arrow #2)

Uninstall the module

1. Go to Joomla's administration panel
2. Go to the menu Components -> JoomShopping -> Options (arrow #1) -> Payments (arrow #2)
3. Delete the payment method
4. Find the installed method by the code begateway in payment methods list and select it (arrow #1)
5. Delete the payment method (arrow #2)
6. To completly remove the module you have to delete files and folders in your Joomla's directory:

• components/com_jshopping/payments/pm_begateway

Test data

If you setup the module with values as follows:

• Payment page domain checkout.begateway.com
• Shop Id 361
• Shop secret key b8647b68898b084b836474ed8d61ffe117c9a01168d867f24953b776ddcb134d
• Check Enable test mode

Use the following test card to make successful test payment:

• Card number: 4200000000000000
• Name on card: JOHN DOE
• Card expiry date: 01/30
• CVC: 123

Use the following test card to make failed test payment:

• Card number: 4005550000000019
• Name on card: JOHN DOE
• Card expiry date: 01/30
• CVC: 123

Widget style

Styles that are being used by the widget

Style name
widget
header
headerPrice
headerDescription
headerDescriptionText
headerClose
footer
footerText
footerLink
footerSecurity
main
methodsMenu
methodsMenuText
methodsMenuCard
methodsMenuCardText
methodsMenuList
methodsMenuListMethod
methodsMenuGrid
methodsMenuGridMethod
cardsMenu
cardsMenuText
cardsMenuCard
cardsMenuCardText
card
cardSides
cardFace
cardFaceContent
cardBack
cardBackMagneticLine
cardBackCVC
cardBackCVCText
cardBackCVCInput
cardPoints
cardCustomer
cardCustomerField
cardButton
eripContent
eripTitle
eripOrder
eripOrderTitle
eripOrderNumber
eripBanks
eripBanksTitle
eripQRCode
eripBanksComment
eripBanksLinks
eripBanksBank
eripBanksMore
paymentResult
paymentResultStatus
paymentResultStatusText
paymentResultDetails
paymentResultDetailsText
paymentResultButton
method
methodContent
methodTitle
methodForm
methodButton
methodWaiting
phoneLabel
inputGroup
inputGroupField
inputGroupSelect
stepBack
stepBackText

Customizable CSS properties

The widget supports only properties listed below.

Property	Equal CSS property
color	color
backgroundColor	background-color
border	border
borderRadius	border-radius
fontFamily	font-family
fontSize	font-size
fontSmoothing	font-smoothing
fontStyle	font-style
fontVariant	font-variant
fontWeight	font-weight
lineHeight	line-height
letterSpacing	letter-spacing
margin	margin
padding	padding
textAlign	text-align
textDecoration	text-decoration
textShadow	text-shadow
textTransform	text-transform

Values of CSS properties may accept values compatible with CSS syntax.

You may use a browser Developer Tools (Inspect element) to know what CSS elements are in use and how they are nested.

Example

header: {
  backgroundColor: '#fff',
  border: 'none'
},
headerPrice: {
  color: '#fff'
},
footer: {
  backgroundColor: '#fff',
  border: 'none'
},
cardButton: {
  backgroundColor: '#26d893',
  border: 'none'
},
methodButton: {
  backgroundColor: '#26d893',
  border: 'none'
},
paymentResultButton: {
  backgroundColor: '#26d893',
  border: 'none'
}

Contributing

Issue pull requests or send feature requests.

English version

Модуль оплаты beGateway для Joomla и JoomShopping 4.x/5.x

Системные требования

• cURL
• Joomla 4.x (модуль был разработан и протестирован с версией 4.4.5)
• JoomShopping 4.x/5.x (модуль был разработан и протестирован с версией 4.18.5/5.4.0)

Установка

1. Скачайте последнюю версию модуля joomshopping-begateway.zip
2. Зайдите в панель администратора Joomla
3. Перейдите в меню Компоненты -> JoomShopping -> Установка и обновление (стрелка #1)
4. Установите пакет
5. Откройте страницу Загрузить файл пакета (стрелка #2)
6. Выберите файл архива модуля, скаченного на шаге 1
7. Загрузите и установите модуль (стрелка #3)

Настройка модуля

1. Зайдите в панель администратора Joomla
2. Перейдите в меню Компоненты -> JoomShopping -> Опции (стрелка #1) -> Способы оплаты (стрелка #2)
3. Найдите установленный способ оплаты в таблице по коду begateway и нажните иконку Редактировать (стрелка #1)
4. Настройте модуль
5. Выберите закладку Конфигурация (стрелка #1)
6. Введите настройки модуля
7. Нажмите Сохранить и закрыть (стрелка #2)
8. Опубликуйте способ оплаты
9. Найдите установленный способ оплаты в таблице по коду begateway и выберите его (стрелка #1)
10. Опубликуйте его (стрелка #2)

Удалить модуль

1. Зайдите в панель администратора Joomla
2. Перейдите в меню Компоненты -> JoomShopping -> Опции (стрелка #1) -> Способы оплаты (стрелка #2)
3. Удалить способ оплаты
4. Найдите установленный способ оплаты в таблице по коду begateway и выберите его (стрелка #1)
5. Удалите выбранный способ оплаты (стрелка #2)
6. Для полного удаления модуля удалите следующие файлы и директории в директории Joomla:

• components/com_jshopping/payments/pm_begateway

Тестовые данные

Настройте модуль со следующими значениями

• Домен страницы оплаты checkout.begateway.com
• Id магазина 361
• Секретный ключ магазина b8647b68898b084b836474ed8d61ffe117c9a01168d867f24953b776ddcb134d
• Отметьте Включить тестовый режим модуля

Используйте следующие данные карты для успешного тестового платежа:

• Номер карты: 4200000000000000
• Имя на карте: JOHN DOE
• Месяц срока действия карты: 01/30
• CVC: 123

Используйте следующие данные карты для неуспешного тестового платежа:

• Номер карты: 4005550000000019
• Имя на карте: JOHN DOE
• Месяц срока действия карты: 01/30
• CVC: 123

Стиль виджета

Стили, используемые в виджете

Имя стиля
widget
header
headerPrice
headerDescription
headerDescriptionText
headerClose
footer
footerText
footerLink
footerSecurity
main
methodsMenu
methodsMenuText
methodsMenuCard
methodsMenuCardText
methodsMenuList
methodsMenuListMethod
methodsMenuGrid
methodsMenuGridMethod
cardsMenu
cardsMenuText
cardsMenuCard
cardsMenuCardText
card
cardSides
cardFace
cardFaceContent
cardBack
cardBackMagneticLine
cardBackCVC
cardBackCVCText
cardBackCVCInput
cardPoints
cardCustomer
cardCustomerField
cardButton
eripContent
eripTitle
eripOrder
eripOrderTitle
eripOrderNumber
eripBanks
eripBanksTitle
eripQRCode
eripBanksComment
eripBanksLinks
eripBanksBank
eripBanksMore
paymentResult
paymentResultStatus
paymentResultStatusText
paymentResultDetails
paymentResultDetailsText
paymentResultButton
method
methodContent
methodTitle
methodForm
methodButton
methodWaiting
phoneLabel
inputGroup
inputGroupField
inputGroupSelect
stepBack
stepBackText

Настраиваемые CSS свойства

Никакие другие CSS свойства не поддерживаются.

Параметр	Соответствующее CSS свойство
color	color
backgroundColor	background-color
border	border
borderRadius	border-radius
fontFamily	font-family
fontSize	font-size
fontSmoothing	font-smoothing
fontStyle	font-style
fontVariant	font-variant
fontWeight	font-weight
lineHeight	line-height
letterSpacing	letter-spacing
margin	margin
padding	padding
textAlign	text-align
textDecoration	text-decoration
textShadow	text-shadow
textTransform	text-transform

Значениями CSS свойств могут быть текстовые значения совместимые с CSS синтаксисом (см. пример выше). Структуру html-документа виджета с используемыми стилями можно посмотреть с помощью Developer Tools браузера (Inspect element).

Пример

header: {
  backgroundColor: '#fff',
  border: 'none'
},
headerPrice: {
  color: '#fff'
},
footer: {
  backgroundColor: '#fff',
  border: 'none'
},
cardButton: {
  backgroundColor: '#26d893',
  border: 'none'
},
methodButton: {
  backgroundColor: '#26d893',
  border: 'none'
},
paymentResultButton: {
  backgroundColor: '#26d893',
  border: 'none'
}