The Soge Commerce plugin lets customers pay by credit card through Sogecommerce, the Société Générale hosted payment gateway (Lyra V2 platform). The customer pays on the gateway page and returns to your store.
It is for stores that have a Sogecommerce merchant account.
Requirements
- Joomla 6.0.0 or later.
- J2Commerce 6.6.4 or later, installed and enabled.
- A Sogecommerce merchant account with a store identifier and test and production keys.
Installation
Buy and download it from Soge Commerce on the J2Commerce Extensions Store.
- In the Joomla administrator, go to System -> Install -> Extensions.
- Upload the plugin package.
- Go to J2Commerce -> Payment Methods and open Sogecommerce Payment.
- Set Status to Enabled and fill in the settings below.
- Save.
Settings
General
| Setting | What It Does | Default | Options |
|---|---|---|---|
| Display Name | Name shown to customers at checkout. | Payment by credit card | Text |
| Display Image | Image shown next to the payment method. | None | Media file |
Payment Gateway Access
| Setting | What It Does | Default | Options |
|---|---|---|---|
| Store identifier | The 8-digit store identifier provided by Sogecommerce. | 12345678 | Text |
| Key in test mode | Test key from the Sogecommerce Back Office. | 1111111111111111 | Text |
| Key in production mode | Production key from the Back Office, available after you enable production mode. | 2222222222222222 | Text |
| Mode | Context mode of the payment method. | TEST | TEST, PRODUCTION |
| Signature algorithm | Algorithm used to sign the payment form. It must match the algorithm set in the Sogecommerce Back Office. | HMAC-SHA-256 | SHA-1, HMAC-SHA-256 |
| Instant Payment Notification (IPN) URL | Read-only note. Copy this URL into the Back Office under Settings > Notification rules. | None | Not applicable |
| Payment page URL | Address of the hosted payment page. | https://sogecommerce.societegenerale.eu/vads-payment/ | URL |
Payment Page
| Setting | What It Does | Default | Options |
|---|---|---|---|
| Default language | Language of the payment page. | fr | Supported languages |
| Available languages | Languages offered on the payment page. Select none to allow all supported languages. | None | Supported languages |
| Capture delay | Number of days before the bank captures the payment. Also configurable in the Back Office. | Empty | Number of days |
| Validation mode | Whether payments are validated automatically. With Manual, confirm each payment in the Back Office. | Sogecommerce Back Office configuration | Sogecommerce Back Office configuration, Automatic, Manual |
| Card types | Card types customers can use. Select none to use the gateway configuration. | None | Card list |
Selective 3DS and Amount Limits
| Setting | What It Does | Default | Options |
|---|---|---|---|
| Disable 3DS below | Amount below which 3DS is disabled. Needs the selective-3DS option on your Sogecommerce subscription. | Empty | Amount |
| Minimum amount | Minimum order amount for this payment method to be available. | Empty | Amount |
| Maximum amount | Maximum order amount for this payment method to be available. | Empty | Amount |
Return to Shop
| Setting | What It Does | Default | Options |
|---|---|---|---|
| Automatic redirection | Redirects the buyer to your site at the end of the payment. | No | Yes, No |
| Redirection timeout on success | Seconds before redirection after a successful payment. | 5 | 0 to 300 |
| Redirection message on success | Message shown on the payment page before redirection after success. | Redirection to shop in a few seconds... | Text |
| Redirection timeout on failure | Seconds before redirection after a declined payment. | 5 | 0 to 300 |
| Redirection message on failure | Message shown on the payment page before redirection after a decline. | Redirection to shop in a few seconds... | Text |
| Return mode | Method used to send the payment result back to your shop. | GET | GET, POST |
Order Status Mapping
| Setting | What It Does | Default | Options |
|---|---|---|---|
| Confirmed payment status | Order status when the payment is accepted. | Status with ID 1 | Order statuses |
| Pending payment status | Order status when the payment awaits confirmation. | Status with ID 4 | Order statuses |
| Cancelled payment status | Order status when the buyer cancels. | Status with ID 6 | Order statuses |
| Failed payment status | Order status when the payment fails or is refused. | Status with ID 3 | Order statuses |
Other Settings
The plugin also has the standard J2Commerce payment options: surcharge name, percentage, fixed amount and tax class, geozone restriction, thank-you article, on-selection, before-payment and after-payment messages, button text and subtemplate.
| Setting | What It Does | Default | Options |
|---|---|---|---|
| Debug mode | Writes debug logs to the Joomla log directory. Turn it off in production. | No | Yes, No |
Common Setups
- Enter the store identifier and the test key, and leave Mode on TEST.
- Copy the IPN URL into the Back Office notification rules.
- Place a test order.
- Enter the production key, set Mode to PRODUCTION and save.
Troubleshooting
- Orders stay pending: check that the IPN URL is set in the Back Office notification rules.
- Payments are rejected as invalid: make sure Signature algorithm matches the Back Office.
- The plugin does not install: it needs J2Commerce 6.6.4 or later and Joomla 6.
Uninstalling
Go to System -> Manage -> Extensions, find Sogecommerce Payment and uninstall it.