WooCommerce TBC Credit Card Payment Gateway (Premium)

Prerequisites

• You must be using WooCommerce 3.0 or newer
• You must enable pretty permalinks in Settings > Permalinks.

Installation Instructions

1. Upload the plugin files to the /wp-content/plugins/plugandpay-woocommerce-tbc-credit-card-payment-gateway directory.
2. Activate the plugin through the Plugins screen in WordPress.
3. Go to WooCommerce -> Settings -> Payments -> TBC credit card (click Manage) and fill out required settings.
4. Bank provides certificate in .p12 format, to transform it into .pem use this command: openssl pkcs12 -in *.p12 -out tbcpay.pem (You can also convert certificate using online tools).
5. Upload generated .pem certificate to a secure directory on your server, usually this is not your root wordpress directory. Enter full path to certificate in plugin settings under certificate path.
6. You should communicate Ok and Fail urls to Tbc e.g. example.com/wc-api/tbc/ok and example.com/wc-api/tbc/fail. Note that these slugs can be changed in plugin settings.
7. You should communicate your server IP to TBC.
8. Open outgoing port 18443 on the server.

– რა არის საჭირო პლაგინით მუშაობის დასაწყებად?

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

– ვის დავუკავშირდე TBC-ში?

– ეს პლაგინი WooCommerce-ის გარდა სხვა ელ-კომერციის ძრავთან (shopify, prestashop ა.შ.) თავსებადია?

არა, პლაგინი თავსებადია მხოლოდ WooCommerce-თან.

– როგორ შევამოწმო პლაგინის გამართულად მუშაობა?

დაამატეთ 50 თეთრიანი სატესტო პროდუქტი და თქვენი ბარათით გაიარეთ ყიდვის პროცედურა. ეს თანხა შემდგომ refund-ის მეშვეობით (edit order-გვერდიდან) შეგიძლიათ უკან დაიბრუნოთ.

– სერტიფიკატის კონვერტაციის უფრო მარტივი ხერხი არსებობს?

კონვერტირება შესაძლებელია ამ online converter-ის გამოყენებით. თუმცა ეს მეთოდი არ არის რეკომენდირებული რადგან თქვენ სერტიფიკატს მესამე პირს ანდობთ.

– პლაგინის სეტინგების გვერდზე OK და FAIL input-ებში რა ჩავწერო?

არ არის საჭირო ამ input-ების default მნიშვნელობების შეცვლა. საკმარისია ეწეროს ok და fail, პლაგინი ავტომატურად დააგენერირებს გვერდებს http://domain.com/wc-api/ok და http://domain.com/wc-api/fail-ს. თუ input-ში შეცვლით მნიშვნელობას, მაგალითად ok-ის მაგივრად ჩაწერთ tbcOK-ს მაშინ ავტომატურად დაგენერირდება გვერდი: http://domain.com/wc-api/tbcOK. აქ არ უნდა ჩაწეროთ თქვენი შექმნილი გვერდები!

– SSL სერტიფიკატი (https) აუცილებელია?

სერტიფიკატის დაყენება არ არის აუცილებელი, WooCommerce ისევე როგორც ჩვენი პლაგინი იმუშავებს სერტიფიკატის გარეშეც, თუმცა რეკომენდირებულია. იმის გარდა რომ SSL-ით იცავთ თქვენი კლიენტების მონაცემებს (username/password), თქვენ თავიდან აიცილებთ შეცდომას რომელსაც browser-ი აფიქსირებს TBC-ის გადახდების (https) გვერდიდან  თქვენ (http) მაღაზიაში გადმომისამართების დროს. ამ შეცდომაზე cancel-ის დაჭერის შემთხვევაში, მიუხედავად იმისა რომ კლიენტის კარტიდან თანხა ჩამოიჭრა, WooCommerce-ში გადახდა არ დაფიქსირდება.

– no TRANSACTION_ID from Tbc

ეს ნიშნავს რომ პლაგინი ვერ უკავშირდება ტიბისის სერვისს, ამის მიზეზი შეიძლება იყოს:

• სერტიფიკატი
  • პლაგინის სეტინგებში არასწორედ შეყვანილი სერტიფიკატის absolute path ან passphrase.
    Absolute path ასე გამოიყურება: /home/username/public_html/tbc.pem და არა http://domain.com/public_html/tbc.pem!
  • PHP-ს არ აქვს წვდომა ატვირთულ სერტიფიკატზე (სცადეთ სერტიფიკატის public_html-ში მოთავსება, ასევე შეამოწმეთ უფლებები ფაილზე).
  • თუ თქვენი PHP დაკომპილირებულია curl+NSS-ით (centos7/rhel) მაშინ სერტიფიკატი უნდა გადაიყვანოთ .p12-ი ფორმატიდან .pem ფორმატში ამ ბრძანებით: openssl pkcs12 -in *.p12 -out tbcpay.pem -nodes (-nodes ნიშნავს no DES encryption რისი მხარდაჭერაც NSS-ს არ აქვს).
• თქვენ სერვერზე გამავალი პორტი (18443) დაკეტილია.
• TBC-ის თქვენი სერვერის IP-ი, firewall-ის whitelist-ში არ დაუმატებია.

– Error ~ Tbc did not return trans_id in $_REQUEST on OK page

ამის მიზეზი შეიძლება იყოს:

• თქვენი ელ-მაღაზია იყენებს https (ssl certificate)-ს, ხოლო ტიბისისთვის გადაგზავნილი გაქვთ OK / FAIL url-ები http-ით. საკმარისია ტიბისის მხარეს ჩასწორდეს http->https ეს შეცდომა აღარ დაფიქსირდება. იგივე განმეორდება თუ თქვენი ელ-მაღაზია იყენებს www.-ს ხოლო ტიბისისთვის გადაგზავნილი გაქვთ OK / FAIL url -ები მის გარეშე (ან პირიქით). ტიბისის მხარეს გაწერილი url-ები ზუსტად უნდა ემთხვეოდეს თქვენი საიტისას.
• PHP-ი ან webserver-ი (nginx/apache) არასტანდარტულად არის დაკონფიგურირებული სერვერზე და $_REQUEST ყოველთვის ცარიელია. მიმართეთ ჰოსტინგის პროვაიდერს.

– 404 შეცდომა ყიდვის ღილაკის დაჭერის შემდეგ

ყიდვის ყილაკზე დაჭერის შემდეგ მომხმარებელის გადამისამართება ხდება აქ: http://domain.com/wc-api/redirect_to_payment_form?transaction_id=XXXX – ხოლო ამ გვერდიდან TBC-ის ბარათის შესაყვან ფორმაზე. თუ ამ პროცესში 404 შეცოდმა ამოვარდა და თქვენ საიტზე Polylang ენების პლაგინი აყენია, მაშინ ამ პლაგინის სეტინგებში ეს checkbox მონიშნეთ:

– Forbidden შეცდომა ბარათის მონაცემების შეყვანის შემდეგ

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

პრობლემის მოგვარება შეიძლება თემის functions.php ფაილში ამ კოდის მოთავსებით:

4.1.0

• feat: (UFC) Check order status before canceling via WooCommerce hook
• refactor: (UFC) Background tasks class
• refactor: (UFC) Shorter methods
• chore: WC tested up to: 5.6

4.0.1

• fix: Set default gateway TBC (Checkout)

4.0.0

• feat: (Checkout) Merchant accounts per currency
• feat: (Checkout) Pre authorization payment method
• feat: (Checkout) Configurable payment methods (ib, qr etc.)
• feat: (Checkout) Logos change as per configurable payment methods
• feat: (Checkout) Refunds
• feat: (Checkout) Callback url
• feat: (Checkout) Pass language parameter
• feat: (Checkout) Hide gateway if currency not supported
• feat: (Checkout) Setting allows to skip the bank-side transaction results page
• feat: (Checkout) Pass cmsInfo paremeter with plugin version
• fix: (Checkout) Initially failed order status is never changed on successful retry
• fix: (Checkout) Do not show required fields error when gateway is disabled

3.0.1

• fix: Set default gateway UFC

3.0.0

• feat: TBC (UFC) save card checked by default
• feat: TBC (UFC) save card checkbox label editable from settings
• feat: TBC (Checkout) API implemented
• chore: WC tested up to 5.2

2.5.0

• feat: WooCommerce Subscriptions plugin compatibility
• feat: Keep track of refund transaction id in order notes
• fix: Payment token would not validate and save
• fix: Saved card data missing in my account payment methods
• fix: Redirecting user to technical fail url during charge and save method
• chore: WC tested up to 4.9.0

2.4.0

• feat: Save card / tokenization
• refactor: Update and modernize various internal methods
• chore: WC tested up to 4.8.0

2.3.0

• feat: Pay with Ertguli points
• fix: Second refund cannot be done after partial reversal
• refactor: Update and modernize various internal methods
• refactor: Clarify that server cron is optional
• refactor: Default certificate is not needed (removed)
• chore: Remove currency conversion dependencies
• chore: Drop support for securepay server
• chore: WC tested up to 4.7.0

2.2.0

• feat: Partial refund
• chore: Remove unnecessary gettext translations

2.1.1

• feat: Biller parameter
• feat: WPML compatibility (order button text)
• fix: Improve IP detection where file_get_contents is disabled

2.1.0

• chore: Change plugin API name (remove v2)
• docs: EULA link
• docs: Update plugin descriptions
• feat: Customizable order button text
• feat: Show external shop IP on plugin settings page
• fix: On fresh plugin activation, ok/fail input description was missing default value

2.0.9

• fix: Add missing merchant host url to redirect template

2.0.8

• feat: Merchant host option (securepay, ecommerce)
• chore: Less cryptic gettext domain pp-woo-tbc-cc -> tbc-gateway
• feat: Improve whoami, from gpost plugin
• refactor: Factory class introduced

2.0.7

• feat: Manually check transaction status on order page
• docs: Add WC requires and WC tested up to tags

2.0.6

• fix: payment_form_url (404) WordPress installed in subdirectory
• fix: Better language detection and transformation (GE->KA)

2.0.5

• feat: Payment form language override option

2.0.4

• fix: Tbc->description must only contain latin characters
• feat: Load plugin translation files (ka_GE)
• docs: Update README.md
• fix: Visa / Mastercard logo – white background and spacing in svg
• chore: Add white stroke to TBC logo
• fix: TBC logo not visible on white background

2.0.3

• fix: error on capture still displays success message
• fix: tbc icons are displayed on all gateways

2.0.2

• fix: capturing authorized payment
• chore: WPcs compatibility efforts started
• chore: log file name based on gateway id
• fix: Uncaught Error: Class ‘TbcPayProcessor’ not found

2.0.1

• feat: TBC/VISA/MASTERCARD logos on checkout
• chore: improve file organization and class names
• chore: add CHANGELOG file
• fix: check if Woo exists before loading plugin

2.0.0

• feat: DMS (authorize)
• feat: full refunds
• feat: multimerchant (USD/GEL/EUR)
• chore: add POT file for translations
• chore: rename plugin to “plug-and-pay”
• feat: log close_business_day results
• fix: Woo 3.* compatibility issues
• chore: update compser dependencies
• chore: improve settings page

1.0.2

• chore: update compser dependencies
• fix: typo get_total is a method

1.0.1

• fix: Woo 3.* compatibility issues

1.0.0

• feat: SMS (capture)
• feat: OK/FAIL url generation
• feat: close business day
• feat: comprehensive event logging