მერჩანტის გზამკვლევი · გადახდები

TBC Card Payment — სწრაფი დაყენება

დაამატეთ WooCommerce checkout-ზე Visa, Mastercard, Apple Pay და Google Pay TBC-ის hosted payment page-ით. თუ TBC-ის ecommerce ხელშეკრულება უკვე აქტიურია, მთელი დაყენება დაახლოებით 30 წუთში სრულდება.

დაახლოებით 30 წუთი · 7 ნაბიჯიგანახლებულია: აპრილი 2026Plugin slug: codeon-tbc-card-payment

დაწყებამდე

წინასწარ მოამზადეთ სამი რამ. ასე დაყენების დროს აღარ მოგიწევთ credentials-ის ან WordPress წვდომის ძებნა.

აქტიური TBC E-commerce merchant contract. თუ ჯერ არ გაქვთ, განაცხადი შეავსეთ tbcbank.ge-ის ბიზნეს გვერდზე. დამტკიცებას, როგორც წესი, 3-5 სამუშაო დღე სჭირდება.
თქვენი TBC merchant API credentials: merchantId და apiKey. TBC მათ email-ით აგზავნის, როცა ხელშეკრულება აქტიურდება. მოძებნეთ წერილი სათაურით "TBC Acquiring — API access".
WordPress admin წვდომა და აქტიური WooCommerce. პლაგინი WooCommerce-ს არ აყენებს, ამიტომ ის წინასწარ უნდა იყოს დაყენებული.

შეიძინეთ TBC Card Payment-ის ლიცენზია

გახსენით TBC Card-ის პროდუქტის გვერდი და დააჭირეთ Buy license-ს. ლიცენზია ღირს ₾160 წელიწადში ერთ დომენზე და მოყვება 14-დღიანი refund window.

ჩამოტვირთეთ plugin ZIP

შედით account-ში და გახსენით codeon.ge/downloads. მოძებნეთ TBC Card Payment და დააჭირეთ Download-ს.

დააყენეთ პლაგინი WordPress-ში

WordPress admin-ში გადადით Plugins → Add New → Upload Plugin-ზე. აირჩიეთ ჩამოტვირთული ZIP, დააჭირეთ Install Now-ს და შემდეგ Activate Plugin-ს.

WordPress admin: Plugins → Add New → Upload Plugin. აირჩიეთ ZIP და დააჭირეთ Install Now-ს.

აქტივაციის შემდეგ ზედა ნაწილში გამოჩნდება notice, რომელიც license key-ს ითხოვს. დააჭირეთ Enter license key-ს. ეს გადაგიყვანთ ეკრანზე.

გაააქტიურეთ ლიცენზია

Settings ეკრანზე ჩასვით key License key ველში და დააჭირეთ Save changes-ს.

შეიყვანეთ TBC merchant credentials

TBC credentials ბლოკში იწერება merchantId და apiKey. დაიწყეთ sandbox credentials-ით, ანუ იმით, რომელსაც test_ prefix აქვს.

ველი: merchantId: თქვენი TBC merchant identifier. sandbox-ში ჰგავს test_M00012345-ს.
ველი: apiKey: TBC-ის მიერ გაცემული API key. ეს secret-ია, არ ჩასვათ საჯარო ჩატებში, screenshot-ებში ან email მიმოწერაში.
Mode: Sandbox / Production. დაიწყეთ Sandbox-ით და გადადით Production-ზე მხოლოდ სატესტო შეკვეთის წარმატებით დასრულების შემდეგ.

გაუშვით 1-თეთრიანი სატესტო შეკვეთა

გახსენით მაღაზია incognito ფანჯარაში, რომ admin-ით არ იყოთ შესული. კალათაში დაამატეთ პროდუქტი, დროებით ჩამოწიეთ ფასი 1 თეთრამდე ან გამოიყენეთ hidden test product და გადადით checkout-ზე.

გადადით production credentials-ზე

როცა sandbox test წარმატებით დასრულდება, Mode გადართეთ Production-ზე და ჩასვით production merchantId + apiKey, რომლებიც TBC-მ გამოგიგზავნათ. შეინახეთ. მწვანე Connected badge ამჯერად production endpoint-ზე უნდა გამოჩნდეს.

რას ხედავს მომხმარებელი

checkout-ზე TBC Card გამოჩნდება TBC-ის ლოგოთი და card network ნიშნებით. არჩევის შემდეგ მომხმარებელი გადადის TBC-ის hosted page-ზე, სადაც ბარათის მონაცემებს და 3-D Secure-ს ავსებს. ბარათის მონაცემები თქვენს მაღაზიაში არ ინახება.

Refund-ის გაკეთება

გადადით WooCommerce → Orders → [order] → Refund-ზე, მიუთითეთ თანხა და დააჭირეთ Refund via TBC Card-ს. პლაგინი TBC-ის refund endpoint-ს გამოიძახებს და დადასტურების შემდეგ order status-ს განაახლებს.

სრული refund: settlement-მდე, ჩვეულებრივ მეორე სამუშაო დღემდე, სწრაფად სრულდება. settlement-ის შემდეგ TBC მას სტანდარტულ refund-ად ამუშავებს, ბარათზე დაბრუნებას 3-5 სამუშაო დღე შეიძლება დასჭირდეს.
ნაწილობრივი refund: მხარდაჭერილია, შეგიძლიათ ცალკეული line item-ების დაბრუნებაც.
Refund decline: თუ ხედავთ decline general-ს, ხშირად მიზეზი per-card rate limit-ია. დაელოდეთ შემდეგ სამუშაო დღეს და სცადეთ ხელახლა.

ხშირი შეცდომები

License domain limit reached: key უკვე მიბმულია სხვა დომენზე. ჯერ გათიშეთ ძველი დომენი /licenses-დან და შემდეგ გაააქტიურეთ ახალ მაღაზიაზე.
License expired: 365-დღიანი ვადა დასრულდა. პლაგინი კიდევ 14-დღიან grace window-ში მუშაობს. განაახლეთ /licenses-დან, იგივე key გაგრძელდება.
TBC: invalid signature: merchantId და apiKey ერთმანეთის წყვილი არ არის, ან sandbox / production აირია. შეამოწმეთ Mode და credentials.
TBC: 3DS authentication failed: მომხმარებელმა 3-D Secure გააუქმა ან ვერ გაიარა. order რჩება Pending-ზე და მომხმარებელს შეუძლია სხვა ბარათით სცადოს.

შემდეგი ნაბიჯები

გინდათ ბარათთან ერთად TBC Installments? ნახეთ TBC Installments-ის დაყენება.
საქართველოს ბანკის გადახდაც გჭირდებათ? ბევრი მაღაზია TBC-ს და BOG-ს ერთად აყენებს, რომ მომხმარებელმა საკუთარი ბანკი აირჩიოს. ნახეთ BOG Card-ის დაყენება.
order events-ზე automation გინდათ? ინტეგრატორის დოკუმენტაცია public REST surface-ს და webhook contract-ს ფარავს.

Refunds straight from WooCommerce → Orders

License

₾ 160/ year

Per WordPress domain · 14-day refund

Buy license

Card or bank transfer

TBC Card-ის პროდუქტის გვერდი codeon.ge-ზე: ბანკის ლოგო, პირველი წლის ფასი და ყიდვის ღილაკი ერთ ბლოკშია.

Checkout-ზე აირჩიეთ გადახდის გზა: ბარათით გადახდა ან საბანკო გადარიცხვა GEL-ში. ბარათით გადახდისას ლიცენზია წამებში აქტიურდება, გადარიცხვით გადახდისას, თანხის ასახვის შემდეგ, ერთი სამუშაო დღის ფარგლებში.

Locked

/downloads გვერდი აჩვენებს ყველა ლიცენზირებულ პლაგინს. რაც არ გაქვთ შეძენილი, locked მდგომარეობაში ჩანს.

ZIP თქვენს account-ზეა watermarked. არ გააზიაროთ: ის ლიცენზიასთანაა მიბმული და სხვა დომენებზე მუშაობა შეეზღუდება.

WooCommerce → Settings → Payments → TBC Card

აქტივაციის შემდეგ ორი notice ჩანს: license key-ის მოთხოვნა და პლაგინის ჩართვის დადასტურება.

Re-check license

Save changes

License tab წარმატებული აქტივაციის შემდეგ: მწვანე Active badge, ვადის გასვლის თარიღი და მიბმული დომენი.

წარმატებული აქტივაციის შემდეგ დაინახავთ:

მწვანე Active badge-ს და ვადას, რომელიც შეძენიდან ერთი წელია.
დომენს, რომელზეც key პირველად გააქტიურდა. ლიცენზია პირველ გამოყენებაზე ებმება დომენს.
ქვემოთ გახსნილ TBC credentials ბლოკს.

LicenseTBC credentialsLogs

TBC credentialsConnectedLast handshake: 2 minutes ago

Mode

SandboxProduction

Test mode. Use TBC test cards (4111 1111 1111 1111).

merchantId

test_M00012345

apiKey

test_••••••••••••••••••••5e7c

Stored encrypted; never sent back to your browser.

Save changes

TBC credentials tab sandbox რეჟიმში, შენახული credentials-ით და წარმატებული კავშირით.

დააჭირეთ Save changes-ს. პლაგინი TBC-ის status endpoint-ს ამოწმებს და წარმატებისას აჩვენებს მწვანე Connected badge-ს. წითელი badge, როგორც წესი, ნიშნავს apiKey-ის typo-ს ან იმას, რომ TBC-ის მხარეს merchant account ჯერ ბოლომდე არ არის აქტიური.

Bank of Georgia Card

Visa · Mastercard · Amex · Apple Pay · Google Pay

Flitt

Visa · Mastercard · Apple Pay · Google Pay

Cash on delivery

Pay with cash on delivery.

You'll be redirected to TBC to complete payment.Place order

მომხმარებლის WooCommerce checkout. TBC Card ჩანს სხვა ჩართულ payment gateway-ებთან ერთად.

აირჩიეთ TBC Card და დააჭირეთ Place order-ს. მომხმარებელი გადამისამართდება TBC-ის hosted card-entry გვერდზე.

TBC sandbox test cards

გამოიყენეთ TBC-ის sandbox test card:

Card number  : 4111 1111 1111 1111
Expiry       : any future month / year
CVV          : 123
Name         : any
3-D Secure   : 1234 (when prompted)

დადასტურების შემდეგ TBC დაბრუნდება თქვენს მაღაზიაში. შეამოწმეთ:

order status იცვლება Pending-დან Processing-ზე.
მოდის Order received email.
WooCommerce → Orders-ში order detail-ზე ჩანს TBC transaction ID.
TBC sandbox merchant portal-ში test payment transaction log-ში რამდენიმე წამში ჩნდება.

Production

Live mode. Real charges hit real cards.

merchantId

M00038217

apiKey

••••••••••••••••••••2af1

Stored encrypted; never sent back to your browser.

Save changes

იგივე credentials screen production რეჟიმში, production merchantId/apiKey-ით.

ბოლოს გაუშვით კიდევ ერთი 1-თეთრიანი შეკვეთა რეალური ბარათით. თანხა რეალურად ჩამოგეჭრებათ, შემდეგ კი WooCommerce-დანვე დაიბრუნეთ refund-ით.

Flitt

Visa · Mastercard · Apple Pay · Google Pay

Cash on delivery

Pay with cash on delivery.

You'll be redirected to TBC to complete payment.Place order

Checkout-ზე TBC Card-ის არჩევა იწყებს TBC hosted page-ზე redirect-ს.

TBC-ის hosted card-entry page. ბარათის მონაცემები პირდაპირ TBC-ში მიდის.