Configuration
Please, pay attention!
To successfully configure the plugin, you need to take some steps:
1.
2.
3.
4.
5.
6.
Settings
| Setting | Required | Description | Default |
|---|---|---|---|
| Is plugin turned on? “Включен ли плагин” | Yes | Shows Freedom Pay among the payment methods at checkout. | Disabled |
| Sort order “Порядок сортировки” | Position of Freedom Pay in the list of payment methods at checkout. | 0 | |
| Payment system name “Название способа оплаты” | Name of the payment method that clients see at checkout. | Freedom Pay (Visa, Mastercard) | |
| Client ID (Merchant ID) “Номер магазина” | Yes | Store ID in the payment gateway. To get it, see Get Merchant ID and key. | — |
| Secret key “Секретный ключ” | Yes | Merchant Key: the store key used to sign requests to the payment gateway and to check notifications from it. To get it, see Get Merchant ID and key. | — |
| Country “Страна” | Yes | Country in which your store is legally located: Kazakhstan, Kyrgyzstan or Uzbekistan. The plugin sends payments to Freedom Pay of this country (api.freedompay.kz, api.freedompay.kg or api.freedompay.uz). | Kazakhstan |
| Order status after payment “Статус заказа после оплаты” | Status of the order after a successful payment. Read more about the order statuses in the official OpenCart documentation. | Not set: choose a status | |
| Two-step payment “Двухэтапный платёж” | OpenCart 3.x only. When enabled, the money is only held on the client's card at payment. You charge it or release it later on the order page, see «Two-step payment» below. Ask your manager whether two-step payments are available for your store. In the plugin for OpenCart 4.x, two-step payments are not available yet. | Disabled | |
| Order status after clearing “Статус заказа после клиринга” | OpenCart 3.x only. Status of the order after the held money is charged. | Not set | |
| Order status after cancel “Статус заказа после отмены” | OpenCart 3.x only. Status of the order after the held money is released. | Not set | |
| FFD “ОФД” | Generate fiscal documents (receipts) for payments. Receipts are generated for stores in Kazakhstan and Uzbekistan. Every product needs a VAT rate, and in Uzbekistan also product codes: see «Product data for receipts and split payments» below. Does not affect the payment. | Disabled | |
| Append delivery to FFD “Учитывать доставку в ОФД” | Add delivery to the receipt. If disabled, delivery is not shown in the receipt. Set the delivery data in “Службы доставки”. | Disabled | |
| Shipping services “Службы доставки” | Receipt and split payment data for each shipping service of your store: the same fields as for products, see below. | — | |
| Sub-merchants “Суб-мерчанты” | Sub-merchants for split payments: add a sub-merchant by its ID and set its data. See «Split payments» below. | — |
Product data for receipts and split payments
| Attribute | Used for | Format |
|---|---|---|
| “Ставка НДС” (VAT rate) | Receipts, Kazakhstan and Uzbekistan | VAT 0% / no VAT, 10%, 12% or 16% |
| “ИКПУ товара” (IKPU code) | Receipts, Uzbekistan | 17 digits |
| “Код упаковки” (package code) | Receipts, Uzbekistan | Up to 20 digits |
| “Код единицы измерения” (unit code) | Receipts, Uzbekistan | Up to 8 digits |
| “Тип собственности” (owner type) | Receipts, Uzbekistan | Resale, own production or service |
| “Штрих-код товара” (barcode) | Receipts, Uzbekistan, optional | Up to 13 digits |
| “Код маркировки товара” (marking code) | Receipts, Uzbekistan, optional | Digits |
| “Использовать сплит-платежи” (use split payments) | Split payments | Enabled or disabled |
| “ID суб-мерчанта” (sub-merchant ID) | Split payments | Digits |
| “Процент комиссии для сплит-платежа” (commission for split payment) | Split payments | Number from 0 to 100 |
| “ИНН суб-мерчанта” or “ПИНФЛ суб-мерчанта” (sub-merchant TIN or PINFL) | Receipts with split payments, Uzbekistan | TIN: 9 digits, PINFL: 14 digits |
1.
2.
3.
4.
Split payments
1.
2.
Two-step payment
Next step