Skip to content

WooCommerce TBC Credit Card Payment Gateway

Documentation for the Plug and Pay WooCommerce TBC 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

  • TBC Merchant Account: You must have an active merchant agreement with TBC Bank.

Technical Specification & Feature Support

FeatureTBC Checkout (Recommended)TBC Checkout Part-by-PartTBC UFC (Legacy)
API VersionLatestLatestLegacy
StatusRecommendedRecommendedMaintained
Blocks SupportNoYesNo
HPOSYesYesYes
Background PollingYesYesNo
Callback (Async)YesYesNo
Redirect SyncYesYesYes
Saved CardsNoNoYes
Add Cards from My AccountNoNoNo
SubscriptionsNoNoYes
Manual AuthorizationYesNoYes
RefundsYesYesYes
Multi-CurrencyYesNoYes
Apple PayYesNoNo
Google PayYesNoNo
Test ModeNoNoNo

Technical Details

Callback (Async Notification)

TBC Checkout supports Async Callbacks. The bank sends a server-to-server notification to your store as soon as the customer completes the payment. This is the most reliable way to ensure order statuses are updated.

Background Polling

In addition to the callback, TBC Checkout includes a Background Polling mechanism. If the async callback is missed for any reason (e.g., server downtime), the plugin will automatically check the order status at increasing intervals (3, 5, and 10 minutes) using the WooCommerce Action Scheduler.

The legacy TBC UFC gateway also includes a safety check that automatically verifies the transaction status one last time right before WooCommerce attempts to cancel an unpaid pending order.

Redirect Sync

For all gateways, the plugin also performs a real-time status check the moment the customer is redirected back from the bank to your store's "Order Received" page. This ensures that even if the background callback hasn't arrived yet, the user sees the correct order status immediately.

Configuration

Payment Action (TBC Checkout)

The TBC Checkout gateway supports two payment actions:

  • Immediate (Capture): The payment is captured immediately upon checkout.
  • Authorize (Pre-authorization): Only blocks the amount on the customer's card.

To capture an authorized payment, go to the WooCommerce Order Edit screen, select the Complete TBC checkout Pre Auth action from the "Order actions" dropdown, and click the arrow button. You can also cancel the pre-authorization using the Cancel TBC checkout Pre Auth action.

Client Accounts

TBC Checkout and TBC Checkout Part-by-Part use a Client accounts table. Add one row per currency/account pair:

  • Currency
  • Client Id
  • Client Secret

TBC Checkout Part-by-Part supports GEL only.

Payment Method Toggles

TBC Checkout settings include individual toggles for:

  • Card payments
  • Web QR, BNPL, Loyalty Points
  • Apple Pay
  • Google Pay
  • InternetBank payments
  • Skip transaction results page

TBC Checkout Part-by-Part exposes the BNPL/QR-related toggle and only supports direct capture.