მთავარ შინაარსზე გადასვლა
codeon
CodeOn Core
ონლაინ-მაღაზიის გზამკვლევი · გადახდები

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

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

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

დაწყებამდე

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

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

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

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

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

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

ჩამოტვირთეთ პლაგინის ZIP არქივი

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

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

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

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

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

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

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

აქტივაციის შემდეგ ჩანს ორი შეტყობინება: ლიცენზიის კოდის მოთხოვნა და პლაგინის გააქტიურების დადასტურება.

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

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

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

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

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

შეიყვანეთ TBC-ის წვდომის მონაცემები

TBC-ის მონაცემების ბლოკში იწერება merchantId და apiKey. დაიწყეთ სატესტო გარემოს მონაცემებით, ანუ იმით, რომელსაც წინ test_ პრეფიქსი აქვს.

ველი: merchantId
თქვენი TBC-ის სავაჭრო იდენტიფიკატორი. სატესტო გარემოში ჰგავს test_M00012345-ს.
ველი: apiKey
TBC-ის მიერ მოწოდებული API key. ეს კონფიდენციალური მონაცემია — არ გააზიაროთ საჯარო ჩატებში, ეკრანის ანაბეჭდებში (screenshot) ან ელფოსტით მიმოწერაში.
Mode
Sandbox / Production. დაიწყეთ Sandbox რეჟიმით და გადადით Production-ზე (რეალურ რეჟიმზე) მხოლოდ სატესტო შეკვეთის წარმატებით დასრულების შემდეგ.
TBC credentials ჩანართი სატესტო რეჟიმში, შენახული მონაცემებითა და წარმატებული კავშირით.

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

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

გახსენით მაღაზია ინკოგნიტო ფანჯარაში, რათა ადმინისტრატორის პროფილით არ იყოთ შესული. კალათაში დაამატეთ პროდუქტი, დროებით შეამცირეთ ფასი 1 თეთრამდე (ან გამოიყენეთ დამალული სატესტო პროდუქტი) და გადადით შეკვეთის გაფორმების გვერდზე.

მომხმარებლის WooCommerce შეკვეთის გაფორმების გვერდი. TBC Card ჩანს გადახდის სხვა მეთოდებთან ერთად.

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

TBC sandbox test cards

გამოიყენეთ TBC-ის სატესტო ბარათი:

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

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

  • შეკვეთის სტატუსი იცვლება Pending-დან Processing-ზე.
  • მოდის Order received ელფოსტა.
  • WooCommerce → Orders-ში შეკვეთის დეტალებში ჩანს TBC transaction ID.
  • TBC-ის სატესტო პორტალში გადახდა ტრანზაქციების ისტორიაში რამდენიმე წამში ჩნდება.

გადადით რეალური რეჟიმის მონაცემებზე

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

იგივე პარამეტრების ეკრანი რეალურ რეჟიმში, რეალური merchantId/apiKey მონაცემებით.

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

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

შეკვეთის გაფორმებისას TBC Card გამოჩნდება TBC-ის ლოგოთი და საგადახდო სისტემების ნიშნებით. არჩევის შემდეგ მომხმარებელი გადადის ბანკის გადახდის გვერდზე, სადაც ბარათის მონაცემებს და 3-D Secure-ს ავსებს. ბარათის მონაცემები თქვენს მაღაზიაში არ ინახება.

შეკვეთის გაფორმებისას TBC Card-ის არჩევა იწყებს ბანკის გადახდის გვერდზე გადამისამართებას.
TBC-ის ბანკის გადახდის გვერდი. ბარათის მონაცემები პირდაპირ TBC-ში მიდის.

თანხის დაბრუნება

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

  • სრული დაბრუნება: საბანკო დღის დახურვამდე (settlement), ჩვეულებრივ მეორე სამუშაო დღემდე, სწრაფად სრულდება. settlement-ის შემდეგ TBC მას სტანდარტულ დაბრუნებად ამუშავებს, ბარათზე თანხის ასახვას კი 3-5 სამუშაო დღე შეიძლება დასჭირდეს.
  • ნაწილობრივი დაბრუნება: მხარდაჭერილია, შეგიძლიათ ცალკეული პროდუქტების თანხის დაბრუნებაც.
  • დაბრუნების უარყოფა: თუ ხედავთ შეტყობინებას decline general, ხშირად მიზეზი ბარათზე დაწესებული ლიმიტია (rate limit). დაელოდეთ შემდეგ სამუშაო დღეს და სცადეთ ხელახლა.

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

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

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

  • გსურთ ბარათით გადახდასთან ერთად TBC Installments? იხილეთ TBC Installments-ის დაყენება.
  • საქართველოს ბანკით გადახდაც გჭირდებათ? ბევრი მაღაზია TBC-სა და BOG-ს ერთად აყენებს, რათა მყიდველმა სასურველი ბანკი თავად აირჩიოს. იხილეთ BOG Card-ის დაყენება.
  • გსურთ ავტომატიზაცია შეკვეთების მოვლენებზე? დოკუმენტაცია ინტეგრატორებისთვის მოიცავს საჯარო REST API-სა და webhook-ების სპეციფიკაციას.