How to integrate a payment system on Kwiga

Kwiga პლატფორმა გაძლევთ საშუალებას, სტუდენტებისგან გადახდების მიღება მოაწყოთ საგადახდო სისტემებთან ინტეგრაციების միջոցով. ინტეგრაციით შეგიძლიათ სტუდენტებისგან მიიღოთ ბარათით გადახდები, შესთავაზოთ განვადება და გამოწერაზე დაფუძნებული წვდომა.

ინტეგრაციის დასაყენებლად გადადით ზედა მენიუში პარამეტრები - ინტეგრაციები - საგადახდო სისტემები:

სიიდან აირჩიეთ იმ სისტემის სახელი, რომლის კონფიგურაციაც გჭირდებათ.

ახალ ფანჯარაში შეავსეთ პარამეტრები და შეინახეთ.

ამჟამად ინტეგრაციისთვის ხელმისაწვდომია შემდეგი საგადახდო სისტემები და სია თანდათან ფართოვდება. თუ თქვენთვის საჭირო საგადახდო სისტემას ვერ ხედავთ, მოგვწერეთ Telegram-ში.

plata by mono (ექვაირინგი monobank-ის მიერ)

გახსენით ინდმეწარმის ანგარიში monobank აპში ან კომპანიის ანგარიში Universal Bank-ში ნომერზე 0 800 300 200 დარეკვით.
(Monobank-ში ინდმეწარმის ანგარიშის გახსნა და მომსახურება უფასოა. გახსნას 2 წუთი სჭირდება). 

ინდმეწარმის ანგარიშის გასახსნელად:
1. გახსენით monobank აპი
2. ჩამოსვით ქვემოთ

3. დააჭირეთ “open a card or sole proprietor account”

4. აირჩიეთ “sole proprietor account”

5. შეავსეთ ფორმა და გაგზავნეთ განაცხადი. შეავსეთ შეერთების განაცხადის ფორმა. ამას 2 წუთი სჭირდება. ფორმის შევსების შემდეგ 24 საათის განმავლობაში მიიღებთ შეერთების დადასტურების შეტყობინებას და ინსტრუქციებს.

დაელოდეთ ექვაირინგის ჩართვას. monobank აპში მიიღებთ push-შეტყობინებას.

გადადით ინდმეწარმის ანგარიშზე

აირჩიეთ განყოფილება Acquiring->internet

*თუ "internet" გვერდი არ გაქვთ, ეს ნიშნავს:
რომ თქვენ არ დაგიტოვებიათ მოთხოვნა monobank-ის internet acquiring-ის ჩასართავად? მისი გაგზავნა შეგიძლიათ ბმულით https://www.monobank.ua/e-comm
Или თქვენთვის ჯერ არ არის მინიჭებული გადახდების მიღების წვდომა. გთხოვთ, დაელოდოთ :)

გახსნილ ფანჯარაში დააჭირეთ create token-ს, შემდეგ კი დააკოპირეთ ის

მიუთითეთ ანგარიშის მეტსახელი, როგორც ეს ინტეგრაცია გამოჩნდება Kwiga პლატფორმაზე, ჩასვით დაკოპირებული ტოკენი API Token ველში და დააჭირეთ შენახვას.

plata by mono საგადახდო სისტემა გადახდების მიღების საშუალებას იძლევა მხოლოდ სამ ვალუტაში: EUR, USD, UAH

PayPal

დააჭირეთ PayPal-ის ლოგოს ხატულას, შემდეგ დააჭირეთ ღილაკს +Account და შეავსეთ ძირითადი პარამეტრები:

PayPal-ის პლატფორმასთან დასაკავშირებლად საჭიროა paypal.com-ზე რეგისტრირებული ბიზნეს ანგარიში გქონდეთ. შედით თქვენს PayPal ანგარიშში და გადადით ბმულზე. შემდეგ გვერდის ქვედა ნაწილში იპოვეთ Connect to an e-commerce platform და დააჭირეთ Get Started.

ამ საგადახდო სისტემის ინტეგრაციისთვის საჭიროა მიიღოთ უნიკალური იდენტიფიკატორები – Client ID და Secret – და ეს მონაცემები შეიყვანოთ Kwiga-ს შესაბამის პარამეტრების ველებში. დარწმუნდით, რომ აკოპირებთ Live -ისთვის განკუთვნილ მონაცემებს (სლაიდერის პოზიცია ნაჩვენებია წითელი ისრით სკრინშოტზე) და არა Sandbox-ისთვის. თუ ხედავთ შეტყობინებას You're in sandbox mode, საჭიროა სლაიდერი გადაიყვანოთ Live-ზე.

ასევე მიუთითეთ ანგარიშის მეტსახელი - ამ ინტეგრაციის სახელი Kwiga-ში, ანუ როგორ გამოჩნდება ანგარიში პლატფორმაზე, და დააჭირეთ შენახვას.

WayForPay

დააჭირეთ WayForPay ბლოკს და შემდეგ ღილაკს +Account.

ინტეგრაციის დასაყენებლად, თქვენ უნდა გქონდეთ ანგარიში WayForPay ვებსაიტზე. გადადით გვერდზე Store settings და აირჩიეთ საჭირო მაღაზია. შემდეგ, ბლოკში Merchant details დააკოპირეთ მონაცემები.

შეიყვანეთ MERCHANT LOGIN და MERCHANT SECRET KEY მნიშვნელობები Kwiga-ში ინტეგრაციის პარამეტრების ფორმის შესაბამის ველებში.

MERCHANTPASSWORD - ეს ველი არასავალდებულოა. ის გამოიყენება მხოლოდ მაშინ, როცა გეგმავთ განმეორებადი გადახდების (გამოწერების) მიღებას და საშუალებას აძლევთ კლიენტებს, თავიანთ სტუდენტის ანგარიშში თავად გააუქმონ განმეორებადი გადახდები. ამ პაროლის მისაღებად დაუკავშირდით Wayforpay-ის მხარდაჭერას.

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

LIQPAY

დააჭირეთ LiqPay სახელწოდების ბლოკს და შემდეგ ღილაკს +Account.

LiqPay-ის Kwiga-სთან ინტეგრაციისთვის საჭიროა შექმნათ და გააქტიუროთ ანგარიში LiqPay-ში. კომპანიის აქტივაციის შემდეგ გადადით მთავარ გვერდზე. დააკოპირეთ public და private key მნიშვნელობები და ჩასვით ისინი LiqPay Settings ფორმის შესაბამის ველებში, მიუთითეთ ანგარიშის მეტსახელი (როგორ ერქმევა ამ ინტეგრაციას პლატფორმაზე) და დააჭირეთ შენახვას.

Stripe

დააჭირეთ Stripe სახელწოდების ბლოკს და შემდეგ +Account.

Stripe-ის Kwiga-სთან ინტეგრაციისთვის დაგჭირდებათ Stripe ანგარიშის შექმნა და გააქტიურება. მისი შექმნის შემდეგ გადადით “Developers” განყოფილებაში და გახსენით ჩანართი “API keys”.

დააკოპირეთ Publishable key და Secret key მნიშვნელობები, შემდეგ კი ჩასვით ისინი ინტეგრაციის დასაყენებელ შესაბამის ველებში. ასევე მიუთითეთ ანგარიშის მეტსახელი (როგორ ერქმევა ამ ინტეგრაციას პლატფორმაზე) და დააჭირეთ შენახვას.

VAT-ის დამატება Stripe-ით გადახდისას

Stripe საგადახდო სისტემა საშუალებას გაძლევთ, კურსის ფასს ავტომატურად დაამატოთ VAT. Stripe-ის პარამეტრებში შეგიძლიათ მიუთითოთ ქვეყნების სია, რომლებისთვისაც უნდა გავრცელდეს ეს გადასახადი. გადახდაზე გადასვლისას კლიენტს შეეძლება აირჩიოს თავისი ქვეყანა და ამ არჩევანის მიხედვით Stripe ან დაამატებს VAT-ს თანხას, ან არა.

იმისთვის, რომ ეს სწორად იმუშაოს Kwiga პლატფორმაზე, ოფერტის დაყენებისას უნდა გამორთოთ პარამეტრი “price includes VAT”. ეს Stripe-ს საშუალებას მისცემს, თავად განსაზღვროს კლიენტის მდებარეობა და საჭიროების შემთხვევაში დაარიცხოს შესაბამისი გადასახადი.

FONDY

დააწკაპუნეთ შესაბამის ბლოკზე Fondy-ის ლოგოთი და დააწკაპუნეთ +ანგარიში.

ინტეგრაციისთვის საჭიროა Fondy სისტემაში რეგისტრაცია. ასევე შეავსეთ პარამეტრები Kwiga-ში:

ანგარიშის ალიასი - ანგარიშის სახელი Kwiga-ში, როგორც ის გამოჩნდება პლატფორმაზე ანგარიშების სიაში.

Merchant ID - ამ პარამეტრს Fondy სერვისი განიჭებთ; მისი ნახვა შეგიძლიათ თქვენს Fondy ანგარიშში გვერდზე Merchant settings → Technical. დააკოპირეთ მნიშვნელობა Merchant ID ველიდან და შეიყვანეთ შესაბამის ველში Kwiga-ს პარამეტრებში.

Payment key - გადადით თქვენს Fondy ანგარიშში და გახსენით გვერდი Merchant settings → Technical. შემდეგ დააკოპირეთ მნიშვნელობა Payment key ველიდან.

დაშვებული ვალუტები - აირჩიეთ ვალუტა, რომელშიც დაკავშირებულია თქვენი merchant ანგარიში Fondy-ში; ამ დეტალების დაზუსტება შეგიძლიათ მხარდაჭერის გუნდთან.

და დააწკაპუნეთ შენახვა.

ასევე დარწმუნდით, რომ თქვენთვის დაყენებულია სწორი redirect მეთოდი. ამის გაკეთება შესაძლებელია, თუ გადახვალთ Fondy -> Merchant settings -> Technical > payment page settings-ში, ველში "Redirect method to the result page" უნდა იყოს POST (თუ სხვა მნიშვნელობაა დაყენებული, ის უნდა შეიცვალოს POST-ზე).

Coin Payments

ინტეგრაციის დასაყენებლად დააწკაპუნეთ ბლოკზე სახელად Coin Payments, შემდეგ კი ღილაკზე +Account.

ინტეგრაციისთვის საჭიროა CoinPayments-ში რეგისტრაცია. ასევე შეავსეთ პარამეტრები Kwiga-ში:

ანგარიშის ალიასი - ანგარიშის სახელი Kwiga პლატფორმაზე, რომელიც გამოჩნდება დამატებული გადახდის სისტემების სიაში.

Public key - დააკოპირეთ მნიშვნელობა Public Key ველიდან თქვენს ანგარიშში გვერდზე https://www.coinpayments.net/acct-api-keys

Private Key - დააკოპირეთ მნიშვნელობა Private Key ველიდან თქვენს ანგარიშში გვერდზე https://www.coinpayments.net/acct-api-keys

IPN Secret - მიუთითეთ და დააკოპირეთ მნიშვნელობა IPN Secret ველიდან merchant settings გვერდზე https://www.coinpayments.net/acct-settings.

Your Merchant ID - დააკოპირეთ მნიშვნელობა Your Merchant ID ველიდან basic settings გვერდზე https://www.coinpayments.net/acct-settings

ყველა ველის შევსების შემდეგ დააწკაპუნეთ შენახვა.

თქვენს Coinpayments ანგარიშში გახსენით Merchant Settings და IPN Secret ველში შეიყვანეთ https://cryptobalance.kwiga.com/coinpayment/ipn

InterKassa

ანგარიშის ალიასი - ეს არის სახელი, რომელიც მხოლოდ თქვენთვის ჩანს ამ გადახდის სისტემის იდენტიფიცირებისთვის. ის ნაჩვენებია გადახდის ანგარიშებსა და შეთავაზებებში.

Client ID შეგიძლიათ ნახოთ ბმულზე https://portal.interkassa.com/account/checkout

Client Secret - მდებარეობს Secret key ველში

API Key - მდებარეობს API სექციაში

Secret key - უნდა აიღოთ საიტის მფლობელობის ვერიფიკაციის სექციიდან. მითითებული შინაარსის მქონე ფაილის დამატება საჭირო არ არის; საკმარისია მითითებული მნიშვნელობის დაკოპირება Kwiga პლატფორმაზე, ანგარიშის დამატების შენახვა და ამის შემდეგ InterKassa-ში Confirm-ზე დაჭერა.

Allpay

შედით თქვენს ანგარიშში, გადადით Settings->API Integration->Create login\/key pair.

ამის შემდეგ გადადით Kwiga პლატფორმაზე, გახსენით Settings - Integrations - Payment systems - Allpay და დააწკაპუნეთ add-ზე. შესავსებად შეავსეთ საჭირო ველები:

ანგარიშის ალიასი - ანგარიშის სახელი Kwiga პლატფორმაზე, რომელიც გამოჩნდება დამატებული გადახდის სისტემების სიაში. ეს შეიძლება იყოს თქვენთვის გასაგები ნებისმიერი სახელი.

API login - დააკოპირეთ ის, რაც ნაჩვენებია შესაბამის ხაზში Allpay-ში

API key - დააკოპირეთ ის, რაც ნაჩვენებია შესაბამის ხაზში Allpay-ში

PayU

შედით თქვენს ანგარიშში, გახსენით Online Payments - My shops.

დააწკაპუნეთ იმ მაღაზიის სახელზე, რომლის დაკავშირებაც გსურთ.

ამის შემდეგ გადადით POS ჩანართზე და კიდევ ერთხელ დააწკაპუნეთ მაღაზიის სახელზე:

თქვენთვის ჩაიტვირთება პარამეტრები და საჭირო მონაცემები (მონიშნულია ლურჯად).

ანგარიშის ალიასი - ანგარიშის სახელი Kwiga პლატფორმაზე, რომელიც გამოჩნდება დამატებული გადახდის სისტემების სიაში. ეს შეიძლება იყოს თქვენთვის გასაგები ნებისმიერი სახელი.

POS ID - დააკოპირეთ ის, რაც ნაჩვენებია შესაბამის ხაზში POS ID-ს (pos_id) გვერდით.

Second key (MD5) - დააკოპირეთ ის, რაც ნაჩვენებია შესაბამის ხაზში PayU-ში.

Przelewy 24

Przelewy24 სისტემაში რეგისტრაციის შემდეგ, უნდა გადახვიდეთ პარამეტრებში და შექმნათ API ინტეგრაცია. გთხოვთ, გაითვალისწინოთ, რომ მუშაობისა და გადახდების მისაღებად უნდა გამოიყენოთ Przelewy24 სერვისი - production ვერსია. გამოიყენეთ გადახდის სისტემის ინსტრუქციები https://developers.przelewy24.pl/index.php?en#tag/Set-up-and-test-your-accounts/Build-API-integration. 

ამის შემდეგ გადადით Kwiga პლატფორმაზე, გახსენით Settings - Integrations - Payment systems - Przelewy24 და დააჭირეთ დამატებას. დასამატებლად შეავსეთ საჭირო ველები:

ანგარიშის ალიასი - ანგარიშის სახელი Kwiga პლატფორმაზე, რომელიც გამოჩნდება დამატებული გადახდის სისტემების სიაში. ეს შეიძლება იყოს თქვენთვის გასაგები ნებისმიერი სახელი.

MerchantId - ეს არის თქვენი შესვლა Przelewy24 ანგარიშზე წვდომისთვის; ის უნდა ყოფილიყო გამოგზავნილი სარეგისტრაციო ელფოსტაში, რომელიც ადასტურებს თქვენს რეგისტრაციას (confirmation e-mail after registration process). 

API key -  დააკოპირეთ მნიშვნელობა API key ველიდან (ამის სანახავად დააჭირეთ show ღილაკს). 

Crc - დააკოპირეთ მნიშვნელობა CRC key ველიდან (ამის სანახავად დააჭირეთ show ღილაკს). 

რეკომენდებულია გადახდის სისტემაში IP 159.69.103.40-ის whitelist-ში დამატება.

Klarna

შედით თქვენს Klarna ანგარიშში და გახსენით Payment Settings განყოფილება (ქვემოთ).

აირჩიეთ Klarna API Credentials

დააჭირეთ +Generate new Klarna API credentials

ამის შემდეგ გადადით Kwiga პლატფორმაზე, გახსენით Settings - Integrations - Payment systems - Kalrna და დააჭირეთ დამატებას. დასამატებლად შეავსეთ საჭირო ველები:

ანგარიშის ალიასი - ანგარიშის სახელი Kwiga პლატფორმაზე, რომელიც გამოჩნდება დამატებული გადახდის სისტემების სიაში. ეს შეიძლება იყოს თქვენთვის გასაგები ნებისმიერი სახელი.

UID - დააკოპირეთ და ჩასვით Klarna-ში Username (UID) ველში მითითებული მნიშვნელობა.

Password -  დააკოპირეთ და ჩასვით Klarna-ში Password ველში მითითებული მნიშვნელობა.

RedSys

ანგარიშის გახსნისას კავშირის დეტალებს მიიღებთ ელფოსტაზე. 

ანგარიშის ალიასი - ანგარიშის სახელი Kwiga პლატფორმაზე, რომელიც გამოჩნდება დამატებული გადახდის სისტემების სიაში. ეს შეიძლება იყოს თქვენთვის გასაგები ნებისმიერი სახელი.

DS_MERCHANT_MERCHANTCODE - მოვაჭრის ნომერი

DS_MERCHANT_TERMINAL და DS_MERCHANT_CURRENCY ივსება ელფოსტაში მითითებულის შესაბამისად. თუ ეს ელფოსტა აღარ გაქვთ, დაუკავშირდით RedSys მხარდაჭერას.

ასევე გვსურს თქვენი ყურადღება მივაქციოთ იმას, რომ RedSys ანგარიში თავდაპირველად იხსნება test რეჟიმში, რაც ნიშნავს, რომ რეალური გადახდების მიღებას ვერ შეძლებთ. გადახდების მისაღებად ანგარიში ადმინისტრირების მოდულში უნდა გადაიყვანოთ Live რეჟიმში. ამის შემდეგ BBVA ტექნიკური მხარდაჭერისგან მიიღებთ კიდევ ერთ ელფოსტას რეალური გარემოს (Production) კონფიგურაციისა და თქვენი ვირტუალური TPV-ის აქტივაციის შემდგომი ინსტრუქციებით.