Flitt Payments — სწრაფი დაყენება
მიიღეთ Visa, Mastercard, Apple Pay და Google Pay Flitt-ის გადახდის გვერდით. Flitt (ყოფილი Fondy) მრავალვალუტიანი გადახდის პროვაიდერია და განსაკუთრებით გამოგადგებათ, თუ თქვენი მაღაზია GEL-თან ერთად EUR, USD ან GBP ვალუტაშიც ყიდის.
codeon-flitt-paymentდაწყებამდე
Flitt-ის დაყენება ქართული ბანკების ინტეგრაციას ჰგავს, თუმცა ხელშეკრულება და წვდომის მონაცემები Flitt-ის მართვის პანელიდან გაიცემა და არა ადგილობრივი ბანკიდან.
- აქტიური Flitt-ის სავაჭრო ანგარიში. თუ Fondy-ს ძველი ანგარიში უკვე გაქვთ, ისიც გამოდგება. ახალი ანგარიშის გასახსნელად დარეგისტრირდით flitt.com-ზე.
- თქვენი Flitt-ის API მონაცემები: რიცხვითი
merchant_idდაsecret_key. ორივე ხელმისაწვდომია Flitt-ის მართვის პანელში, მენიუში Settings → Technical settings. - WordPress-ის ადმინპანელზე წვდომა და აქტიური WooCommerce. პლაგინი WooCommerce-ს თავისით არ აყენებს — ის წინასწარ უნდა გქონდეთ გააქტიურებული.
შეიძინეთ Flitt Payments-ის ლიცენზია
გახსენით Flitt Payments-ის პროდუქტის გვერდი და დააჭირეთ Buy license-ს. ლიცენზიის საფასურია ₾160 წელიწადში ერთ დომენზე და მოყვება თანხის დაბრუნების 14-დღიანი გარანტია.
ჩამოტვირთეთ პლაგინის ZIP ფაილი
შედით თქვენს ანგარიშში, გახსენით codeon.ge/downloads, მოძებნეთ Flitt Payments და დააჭირეთ Download-ს.
ZIP ფაილი პერსონალიზებულია თქვენი ანგარიშისთვის. არ გაუზიაროთ სხვებს, რადგან პირდაპირ თქვენს ლიცენზიასთანაა დაკავშირებული.
დააყენეთ პლაგინი WordPress-ში
WordPress-ის ადმინპანელში გახსენით Plugins → Add New → Upload Plugin, აირჩიეთ ZIP ფაილი, დააჭირეთ Install Now-ს და შემდეგ Activate Plugin-ს.
გააქტიურების შემდეგ გამოჩნდება შეტყობინება, რომელიც ლიცენზიის კოდის შეყვანას მოგთხოვთ. დააჭირეთ Enter license key-ს და გადახვალთ WooCommerce → Settings → Payments → Flitt-ზე.
გააქტიურეთ ლიცენზია
ჩასვით კოდი License key-ს ველში და დააჭირეთ Save changes-ს.
- Active სტატუსი ადასტურებს, რომ ლიცენზიის კოდი აქტიურია.
- დომენი ლიცენზიის კოდს პირველივე გამოყენებისას ებმება.
- ქვემოთ გამოჩნდება Flitt credentials-ის სექცია.
შეიყვანეთ Flitt-ის წვდომის მონაცემები
Flitt credentials-ის სექციაში მიუთითეთ რიცხვითი merchant_id და secret_key. ინტეგრაცია დაიწყეთ სატესტო გარემოში და რეალურ რეჟიმზე მხოლოდ შემოწმების შემდეგ გადადით.
- ველი: merchant_id
- Flitt-ის სავაჭრო ანგარიშის იდენტიფიკატორი, როგორც წესი 7-ნიშნა რიცხვი. შეგიძლიათ იხილოთ მართვის პანელში: Settings → Technical settings.
- ველი: secret_key
- Flitt-ის ხელმოწერის საიდუმლო გასაღები. შეინახეთ კონფიდენციალურად და არ ჩასვათ ჩატებში ან ეკრანის ანაბეჭდებში.
- Mode
Sandbox / Production. რეალურ რეჟიმზე გადადით მხოლოდ მას შემდეგ, რაც სატესტო შეკვეთა წარმატებით დასრულდება.- Settlement currency
- აირჩიეთ ვალუტა, რომელშიც Flitt თანხას გირიცხავთ. შესაძლოა განსხვავდებოდეს WooCommerce-ის მაღაზიის ვალუტისგან.
Save changes-ის შემდეგ პლაგინი Flitt-ის სტატუსის endpoint-ს ამოწმებს. მწვანე Connected ნიშნავს, რომ merchant_id და secret_key სწორია და ერთმანეთს ემთხვევა.
გააფორმეთ 1-ცენტიანი ან 1-თეთრიანი სატესტო შეკვეთა
გახსენით მაღაზია ინკოგნიტო ფანჯარაში, დაამატეთ სატესტო პროდუქტი და ფასი მინიმალურ სატესტო თანხამდე ჩამოწიეთ. შემდეგ გადადით შეკვეთის გაფორმების გვერდზე.
აირჩიეთ Flitt და დააჭირეთ Place order-ს. მომხმარებელი გადამისამართდება Flitt-ის ბანკის გადახდის გვერდზე.
Flitt-ის სატესტო ბარათები
სატესტო გარემოში გამოიყენეთ უნივერსალური სატესტო ბარათი. გადახდის უარყოფისა და 3-D Secure-ის სცენარები Flitt-ის დოკუმენტაციაშია აღწერილი.
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-ში შეკვეთის დეტალებში ჩანს Flitt-ის
order_idდაpayment_id. - Flitt-ის სატესტო სამართავ პანელში ტრანზაქციების ისტორია ივსება.
გადადით რეალური რეჟიმის მონაცემებზე
Mode გადართეთ Production-ზე და ჩასვით რეალური რეჟიმის merchant_id და secret_key Flitt-ის სამართავი პანელიდან. შეინახეთ ცვლილებები და დაელოდეთ Connected სტატუსს.
ბოლოს გააფორმეთ მცირე თანხის შეკვეთა რეალური ბარათით და შემდეგ WooCommerce-იდან თანხის დაბრუნება (refund) გააკეთეთ.
რას ხედავს მომხმარებელი
შეკვეთის გაფორმებისას Flitt-ის მეთოდი გამოჩნდება Visa-ს, Mastercard-ის, Apple Pay-სა და Google Pay-ს ლოგოებით. ბარათის მონაცემები თქვენს მაღაზიაში არ ინახება.
თანხის დაბრუნება
WooCommerce → Orders → [order] → Refund-ში მიუთითეთ თანხა და დააჭირეთ Refund via Flitt-ს. პლაგინი Flitt-ის refund endpoint-ს გამოიძახებს და შეკვეთის სტატუსს სინქრონულად განაახლებს.
- სრული დაბრუნება იმავე დღეს: საბანკო დღის დახურვამდე (settlement) ავტორიზებული თანხის ბლოკი უბრალოდ იხსნება. settlement-ის შემდეგ კი თანხის დაბრუნებას შესაძლოა 3-5 სამუშაო დღე დასჭირდეს.
- ნაწილობრივი დაბრუნება: შესაძლებელია როგორც კონკრეტული პროდუქტების არჩევით, ისე სასურველი თანხის მითითებით.
- სავალუტო თავისებურება: თუ მაღაზიის ვალუტა და ანგარიშსწორების ვალუტა განსხვავდება, კურსთა შორის მცირე სხვაობა (FX) სავსებით ბუნებრივია.
ხშირი შეცდომები
License domain limit reached- ლიცენზიის კოდი უკვე სხვა დომენზეა მიბმული. ძველი დომენი გათიშეთ /licenses-დან.
License expired- ლიცენზიის ვადა ამოიწურა. განაახლეთ /licenses-დან.
Flitt: invalid signature- Secret Key და Merchant ID არ ემთხვევა ერთმანეთს ან სამუშაო რეჟიმია არასწორი.
Flitt: 3DS authentication failed- მომხმარებელმა 3-D Secure დადასტურება გააუქმა ან ვერ გაიარა. შეკვეთა Pending სტატუსზე რჩება.
requires PHP version 8.1 or higher- ჰოსტინგზე PHP-ის ვერსია 8.1-ზე დაბალია. განაახლეთ PHP ჰოსტინგის მართვის პანელიდან.
შემდეგი ნაბიჯები
- ქართულ ბაზარზე ადგილობრივი გადახდების დამატებაც გსურთ? ჩართეთ TBC Card ან BOG Card.
- განვადების შეთავაზებაც გჭირდებათ? Flitt-ის პარალელურად დაამატეთ BOG Installments ან TBC Installments.
- Flitt-ის შეტყობინებებზე (webhook) ავტომატიზაცია გჭირდებათ? ინტეგრატორის დოკუმენტაცია დეტალურად აღწერს REST API-სა და webhook-ების სპეციფიკაციას.