WooCommerce BOG Credit Card Payment Gateway
Documentation for the Plug and Pay WooCommerce BOG Credit Card 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: 3.0.0 or higher
Store Setup Prerequisites
- BOG Merchant Account: You must have an active merchant agreement with Bank of Georgia.
Technical Specification & Feature Support
| Feature | BOG Aggregator (Recommended) | BOG iPay | BOG iPay Solo |
|---|---|---|---|
| API Version | Latest | Legacy | Legacy |
| Status | Recommended | Maintained | Maintained |
| Blocks Support | Yes | No | No |
| HPOS | Yes | Yes | Yes |
| Background Polling | No | No | No |
| Callback (Async) | Yes | Yes | Yes |
| Redirect Sync | Yes | No | No |
| Saved Cards | No | No | No |
| Add Cards from My Account | No | No | No |
| Subscriptions | No | No | No |
| Manual Authorization | Yes | No | No |
| Refunds | Yes | Yes | No |
| Multi-Currency | Yes | Yes | No |
| Apple Pay | Yes | No | No |
| Google Pay | Yes | No | No |
| Test Mode | Yes | No | No |
Technical Details
Callback (Async Notification)
The BOG gateways support Async Callbacks. This means the bank sends a Background Notification directly to your server as soon as a payment is completed. This ensures that order statuses are updated even if the customer closes their browser before being redirected back to your website.
Redirect Sync
The BOG Aggregator gateway also performs a real-time status check the moment the customer is redirected back from the bank to your store. This ensures the order status is updated immediately upon the customer's return, providing instant feedback. Legacy iPay gateways rely on the Async Callback for status updates.
Configuration
Capture Method (BOG Aggregator)
The BOG Aggregator gateway supports two capture methods:
- Automatic: The payment is captured immediately upon checkout.
- Manual (Authorize): Only blocks the amount on the customer's card (pre-authorization). This is supported for Card, Google Pay, and Apple Pay.
To capture a manual payment, go to the WooCommerce Order Edit screen, select the Complete BOG Aggregator Pre Auth action from the "Order actions" dropdown, and click the arrow button. You can also cancel the pre-authorization using the Cancel BOG Aggregator Pre Auth action.
Optional Payment Methods
The BOG Aggregator settings also include provider-side payment toggles. These options must be enabled by Bank of Georgia before they are enabled in WooCommerce:
- BOG Point payments MR/Plus
- InternetBank payments
- Apple Pay
- Google Pay
- Gift Card payments
Sandbox / Test Mode
The BOG Aggregator gateway supports Bank of Georgia's Sandbox environment for testing payment flows without real transactions. Enable Test mode in the gateway settings to connect to the sandbox API endpoints.
Note: Under test mode, only card payments are supported by the Bank of Georgia Sandbox environment. Other payment methods (Apple Pay, Google Pay, Loyalty, etc.) are automatically disabled while test mode is active.
API Credentials
BOG Aggregator requires a Client id and Secret key from Bank of Georgia. Legacy iPay gateways use their own credential fields in their separate gateway settings.