Skip to content

WooCommerce BOG Installments Payment Gateway

Documentation for the Plug and Pay WooCommerce BOG Installments Payment Gateway plugin.

Requirements

Technical Requirements

  • PHP: 7.4, or 8.1 through 8.5. PHP 8.0 is not supported.
  • ionCube Loader: Required. For version requirements and installation details, check the IonCube Loader documentation.
  • WooCommerce: 4.0.0 or higher

Store Setup Prerequisites

  • BOG Installments Credentials: Client ID and Secret Key from Bank of Georgia.
  • Currency: GEL.

Technical Specification & Feature Support

FeatureBOG Installments (Aggregator) (Recommended)BOG Part-by-Part (Aggregator)BOG Installments V1BOG Part-by-Part V1BOG Installments Legacy
API VersionLatestLatestV1V1Legacy
StatusRecommendedCurrentDiscontinuedDiscontinuedLegacy
Blocks SupportYesYesNoNoNo
HPOSYesYesYesYesYes
Background PollingNoNoNoNoNo
Callback (Async)YesYesYesYesYes
Redirect SyncYesYesNoNoNo
Amount LimitsYesYesYesYesNo
Handling FeeYesYesYesYesNo
RefundsNoNoNoNoNo
Reclaim StockNoNoNoNoNo
Test ModeNoNoNoNoNo
CurrencyGELGELGELGELGEL

Technical Details

Callback (Async Notification)

All BOG installment modes receive asynchronous status notifications from Bank of Georgia and update the WooCommerce order after verifying the application status.

Redirect Sync

The Aggregator modes also request the current application status when the customer returns to the store. The V1 and legacy modes rely on the asynchronous callback.


Configuration

The plugin registers multiple BOG installment gateway modes. Use an Aggregator mode for new configurations. The V1 modes are discontinued, while the legacy mode remains available for existing integrations.

Common settings include:

  • Enable BOG Installments
  • Title, Description, and Order button text
  • Debug log
  • Client id
  • Secret key
  • Min Installment and Max Installment
  • Handling Fee %

The Aggregator gateway filters installment options by the current cart total and exposes those options in both shortcode checkout and block checkout.