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, 8.1, 8.2, or 8.3
  • ionCube Loader: Required. For version requirements and installation details, check the IonCube Loader documentation.
  • WooCommerce: 5.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 Support❌❌❌
HPOS✅✅✅
Background Polling✅✅✅
Callback (Async)✅✅❌
Redirect Sync✅✅✅
Save card❌❌✅
Save via My Account❌❌❌
Subscriptions❌❌✅
Authorise✅❌✅
Refunds✅✅✅
Multi-currency✅✅✅
Apple Pay✅❌❌
Google Pay✅❌❌

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.