The ROBOKASSA Connect application allows your end-users to pay for their Internet plans by using ROBOKASSA payment gateway.
This solution is suitable for accepting online payments in Russia and CIS countries. Please find here the complete list of supported countries.
Pre-requisites
In order to set up this application in Cloud4Wi, you need a merchant account. You can sign up at https://partner.robokassa.ru/Reg/Register.
Then you need to configure merchant account and find the following information that Cloud4Wi needs to set up payments:
- Password #1
- Password #2
- Shop identifier
Finally, you have to allow your end-users to access ROBOKASSA website before they are logged in. To do that, you have to correctly set up the walled garden of your access point. You will find the necessary information in this article, in the paragraph called "Walled garden".
You can get more information by contacting ROBOKASSA Support Team (language: Russian | English).
Admin Panel configuration
You can find the "ROBOKASSA Connect" application in the Marketplace, if available on your account. To get there, go to Manage → Apps and search in Integrations section.
After clicking on the "ROBOKASSA Connect" application, you will see a configuration screen asking for the following data of your account:
- Password #1
- Password #2
- Shop identifier
Once these parameters have been entered, you activate the payment gateway on your instance by going to Manage → Preferences, then moving to the Gateways tab and finally selecting "ROBOKASSA" as Provider Lists in the Online payments fieldset.
When this configuration is completed, any end-user who intends to use a paid Internet plan will be redirected to ROBOKASSA UI in order to complete the transaction. Please note that the payment procedure entirely takes place in the ROBOKASSA website and no sensitive information about bank account details or debit/credit card numbers is shared with Cloud4Wi.
Walled garden
In order to get the connector working for your end-users, you have to add the following domains (and any related subdomain) to the walled garden of your access point:
- auth.robokassa.ru
- mc.yandex.ru
Please find here the guide for your access point: Complete list of supported access points, access devices, and firmware.
Set-Up a Robokassa Shop
This article explains how to create a ROBOKASSA shop in your merchant account and how to retrieve the data that "ROBOKASSA Connect" application needs in order to set-up payments.
Please note that although this article is checked regularly, this described procedure may be outdated.
For any problem regarding how to configure a ROBOKASSA merchant account, you can contact the ROBOKASSA Support Team (language: Russian | English).
Sign in
Sign in to your merchant account at https://auth.robokassa.ru/partner/Login.aspx.
Create and configure your shop
Once logged in, click on My shop on the left-side toolbar.
In this article, we are describing how to create a new shop by clicking on the Add new button, but you also can configure your existing shop by clicking on the corresponding button.
In order to let our shop working on Cloud4Wi, you have the configure the URL main page of your site value with the following value:
- http://cloud4wi.com/ if your account is hosted onCloud4Wi's public cloud
- http://yourdomain.com/ if your account is hosted on a private/local cloud and your Splash Page URL is something such as: third-level-domain-name.yourdomain.com
Please enter all the required information and then click Create.
After your shop has been created, go back to the My shops section and click on the corresponding button.
Then move to the Technical preferences tab and configure the parameters as described below.
If your account is hosted on Cloud4Wi's public cloud:
- Hash calculation algorithm: MD5
- Password #1: (generate it)
- Password #2: (generate it)
- Result Url: https://splashportal.cloud4wi.com/robokassa/notification
- Method of sending data to Result Url: GET
- Success Url: https://splashportal.cloud4wi.com/robokassa/success
- Method of sending data to Success Url: GET
- Fail Url: https://splashportal.cloud4wi.com/robokassa/failed
- Method of sending data to Fail Url: GET
if your account is hosted on a private/local cloud and your Splash Page URL is SPLASH_PAGE_URL (choose HTTPS or HTTP depending on your needs):
- Hash calculation algorithm: MD5
- Password #1: (generate it)
- Password #2: (generate it)
- Result Url: https://SPLASH_PAGE_URL/robokassa/notification or http://SPLASH_PAGE_URL/robokassa/notification
- Method of sending data to Result Url: GET
- Success Url: https://SPLASH_PAGE_URL/robokassa/success or http://SPLASH_PAGE_URL/robokassa/success
- Method of sending data to Success Url: GET
- Fail Url: https://SPLASH_PAGE_URL/robokassa/failed or http://SPLASH_PAGE_URL/robokassa/failed
- Method of sending data to Fail Url: GET
Get ready to configure Cloud4Wi
Take note of the values below, since they will be necessary to configure the ROBOKASSA Connect application on Cloud4Wi:
- Password #1
- Password #2
- Shop identifier