Skip to content
codeon
CodeOn Core
MERCHANT GUIDE · PAYMENTS

Bank of Georgia Installments — quick-start

Add the Bank of Georgia Installments option at checkout. Customers pick a 3, 6, 12 or 24-month plan on BoG's hosted page; BoG carries the loan and you receive the full order amount at settlement. Most setups take about 30 minutes assuming your BoG installments contract is signed and active.

~30 min · 7 stepsLast updated: April 2026Plugin slug: codeon-bog-installments

Before you begin

Three prerequisites — same shape as the BoG Card guide, with one critical difference: the installments product is a separate contract with BoG and uses different API credentials.

  • An active BoG Installments merchant contract. This is distinct from the BoG e-commerce (card) contract — make sure you signed the installments annex specifically. Approval typically takes 5-7 business days; ask your BoG relationship manager for the installments product line if you only have card.
  • Your BoG installments API credentials: a separate client_id / secret_key pair issued for the installments endpoint. They look the same as the card-payment credentials but they are not interchangeable — using card credentials with the installments plugin will fail at the connect step.
  • WordPress admin access and WooCommerce already installed and active. We recommend installing BoG Card first so customers who don't want installments still have a way to pay; the plugins coexist cleanly.

Buy a Bank of Georgia Installments license

Open the BoG Installments product page and click Buy license. License is ₾130 / year per domain with a 14-day no-questions refund window.

The BoG Installments product page on codeon.ge — separate license from BoG Card; you can run both at once.

Download the plugin ZIP

Sign in and open codeon.ge/downloads. Find BoG Installments and click Download.

Your /downloads list. If you also bought BoG Card or another CodeOn plugin, every plugin you own appears unlocked here.

Install the plugin in WordPress

In your WordPress admin, go to Plugins → Add New → Upload Plugin. Select the ZIP you downloaded, click Install Now, then Activate Plugin.

WordPress admin: Plugins → Add New → Upload Plugin.

Once activated, you'll see a yellow admin notice asking for your license key. Click Enter license key— it goes to the plugin's settings screen at WooCommerce → Settings → Payments → BoG Installments.

The two admin notices after activation: license-key prompt + activation confirmation.

Activate your license

On the plugin settings screen, paste your license key into the License key field and click Save changes.

License tab after a successful activation: green Active badge, expiry date, and the bound domain.

Activation success looks the same as BoG Card: green badge, one-year expiry, the store's domain bound. The BoG credentials section unlocks underneath.

Plug in your BoG Installments credentials

The BoG credentials section accepts a separate client_id / secret_key pair, issued by BoG against the installmentsproduct line. Like BoG Card, you'll start in Sandbox mode and switch to production once a test order succeeds.

Field: Client ID
Installments client identifier. Looks like test_bog_inst_a4f2e1 in sandbox. Not the same as your BoG Card client_id even if the prefix looks similar.
Field: Secret Key
Installments secret BoG issued. Treat as a secret; never paste into chats or screenshots.
Mode
Sandbox / Production. Start in sandbox; the plan picker is identical to production but no real loan is opened.
Plans offered
Defaults to 3, 6, 12, 24months. BoG may restrict longer plans for some merchant categories — check with your relationship manager. Plans the customer can't use are hidden on BoG's side, not yours.
BoG credentials tab on the installments plugin settings page. No Capture-mode field here — the loan is signed once approved, no separate capture step.

Place a test order

BoG's sandbox lets you walk the plan-picker flow without opening a real loan. Open your storefront in an incognito window, drop a test product into the cart with a price of at least ₾100(BoG's minimum threshold for installments), and proceed to checkout.

WooCommerce checkout — BoG Installments visible alongside any other gateways you have enabled.

Pick BoG Installments and click Place order. You're redirected to BoG's plan-picker page where the customer chooses a 3 / 6 / 12 / 24-month plan and submits their personal ID for a credit check.

BoG's hosted installments page — customer picks a plan and enters their personal ID for a quick credit check.

Sandbox approves all plans for valid-format IDs. Use 01001000000 as the test personal ID. After approval, BoG redirects back to your store and you should see:

  • Order status flips from Pending to Processing.
  • The order detail in WooCommerce shows the chosen plan (e.g. "6 months · ₾87 / month") under the BoG Installments transaction id field.
  • An Order receivedemail lands in your inbox exactly like a card order — BoG carries the loan, so from your perspective it's a normal sale.

Switch to production credentials

Flip Mode to Production and replace the credentials with the production installments client_id / secret_key. Save — the green Connected badge should reappear.

Same screen as step 5, switched to Production mode.

For a production smoke-test, run a small order (≥₾100) with a real personal ID and pick the shortest plan offered. Cancel the loan from your BoG merchant portal once you're satisfied — instant cancellation while the loan is in the first 24-hour cooling-off window leaves no fees.

What your customers see

The customer's checkout looks like any other gateway choice: a labelled radio with the bank logo and a one-line description. After they hit Place order, BoG takes over for plan selection and credit check — you don't handle any of that.

Customer-facing checkout: BoG Installments option with the BoG logo and the plan-range hint.
BoG's hosted installments page. Customer picks a plan, enters personal ID, gets approved (or asked for verification), then is redirected back to your store.

Refunding an installment order

Refund flow is initiated the same way as a card refund: WooCommerce → Orders → [order] → Refund. Behind the scenes the refund is more involved because BoG needs to unwind the customer's loan, so settlement timing differs from card.

  • Within 24 hours of approval (cooling-off): full refund only. The loan is cancelled cleanly with no interest billed to the customer; you're re-credited within one business day.
  • After 24 hours:partial refunds are supported but BoG may charge a small unwind fee (typically the first month's interest accrued). We surface the fee on the WooCommerce order note when BoG's callback returns it.
  • After the customer has paid 1+ installments: partial refund only — the principal already returned to you can't be reversed. Contact support if you need to refund a long-running installment plan; we'll walk through it.

Common errors and what they mean

License key doesn't cover this plugin
You pasted a BoG Card license into the BoG Installments plugin (or vice versa). Each plugin has its own license; check /licenses for which key is which.
BoG: 401 unauthorized
Wrong credentials. Most often this means you pasted your BoG cardcredentials into the installments plugin. Verify with BoG that you're using the installments-specific secret_key.
BoG: amount below threshold
Order total was below the installment minimum (typically ₾100). The customer should pick BoG Card instead, or you can hide the installments method on carts under the threshold via WooCommerce's payment-method visibility filters.
BoG: customer rejected
BoG declined the credit check. The order stays Pending; the customer can retry with another method. Don't treat this as a plugin error.

Next steps

  • Add BoG Card so customers who don't want a loan can still pay instantly.
  • Run TBC Installments alongside so customers can pick their issuing bank — many Georgian buyers do.
  • Building automation around order events? The integrator docs cover the public REST surface and the BoG / TBC callback contracts.