Freedom Pay
  1. Bitrix
Freedom Pay
  • Gateway API
    • Introduction
    • Reference
      • Test cards
      • Error codes
    • Sync API
      • Introduction
      • Page
        • Introduction
        • Page
        • Page with amount control
        • Status
      • Pay
        • Introduction
        • Card
        • 3DSecure
        • Cancel
        • Clearing
        • Refund
        • Status
      • Payout
        • Introduction
        • Card
        • IBAN
        • Balance
        • Status
        • StatusV2
      • Transfer
        • Introduction
        • Card
        • 3DSecure
        • Rates
        • Status
      • Card
        • Introduction
        • Add
        • 3DSecure
        • List
        • Remove
        • Status
      • Token
        • Introduction
        • Token Pay
        • Apple Pay
        • Google Pay
        • Samsung Pay
        • Token Payout
        • Status
    • Async API
      • Introduction
      • create
        • create payment
        • create payment recurrent
      • read
        • read payment
        • read request
      • edit
        • edit payment.refund
        • edit payment.reverse
        • edit payment.clearing
      • delete
  • Merchant API
    • Introduction
    • Reference
      • Test cards
      • Test phone numbers
      • Error codes
    • Page
      • Introduction
      • Page
      • Page with amount control
      • Payout page
      • Frame
      • Widget
      • Status
    • Pay
      • Introduction
      • Cancel
      • Clearing
      • Refund
      • Status
    • Payout
      • Introduction
      • IBAN
      • Balance
      • Status by order_id
      • Status by Payment ID
      • Status by Payment ID V2
    • Mobile balance
      • Introduction
      • Init
      • Pay
      • Approve
      • Resend code
      • Status
    • Card
      • Introduction
      • Add
      • Add for payout
      • Remove
      • List
      • Status
    • Token
      • Introduction
      • Saved card with CVC input (Init)
      • Saved card with CVC input (Pay)
      • Non-acceptance payments
      • Non-acceptance payments (Pay)
      • Token payout
      • Status
    • Invoice
      • Introduction
      • Init
      • Info
      • Pay
      • Status
    • Additional
      • Introduction
      • Check request
      • Result notify
      • Payout notify
      • Redirect back
  • Card API
    • Introduction
    • Payment Cards
      • Reference
        • Request Status
        • Client product
        • Card product
        • Card status
        • Card block
        • Transaction
        • Error codes
      • Card issue
        • Bulk
        • Single
        • Physical
      • Card control
        • Activate
        • Block
        • Unblock
        • Set PIN
        • Reset PIN counter
        • Close
        • Identification
        • Info
        • Balance
        • Secret data
        • Statement
      • Client
        • Create
        • Edit
        • Card list
      • Additional
        • Request status
    • Gift Cards
      • Introduction
      • Reference
        • Request status
        • Card status
      • List
      • Issue
      • Confirm
      • Resend
      • Resend code
      • Status
  • Partner API
    • Rates
      • Introduction
      • Rates
    • Products
      • Introduction
      • Reference
        • Request
        • Product
        • Freedom POS
        • Freedom ECOM
        • Freedom BOX
        • Limits
      • Add user
      • Add product
      • Add user with product
      • Grant user
      • Send auth data
      • Request status
    • E-Money
      • Introduction
      • Reference
        • Request
        • Operation
        • Error codes
      • Add
      • Owner identification
      • Info
      • Close
      • Block
      • Balance
      • Statement
      • Request Status
    • Freedom ID
      • Introduction
      • Android SDK
      • iOS SDK
      • Reference
        • Error codes
      • Link
      • Token
      • Token refresh
      • Info
      • Profile
      • Request
  • Mobile SDK
    • Payment SDK
      • iOS
      • Android
    • Freedom QR
      • Reader SDK (Android)
      • Provider SDK (Android)
  • CMS
    • Introduction
    • Get Merchant ID and key
    • WordPress
      • Introduction
      • Installation
      • Configuration
      • Test
      • Live payments
      • Update
    • Tilda
      • Introduction
      • Installation
      • Configuration
      • Test
      • Live payments
    • InSales
      • Introduction
      • Installation
      • Configuration
      • Test
      • Live payments
    • Ecwid
      • Introduction
      • Installation
      • Configuration
      • Test
      • Live payments
    • Bitrix
      • Introduction
      • Installation
      • Configuration
      • Test
      • Live payments
    • PrestaShop
      • Introduction
      • Installation
      • Configuration
      • Test
      • Live payments
    • OpenCart
      • Introduction
      • Installation
      • Configuration
      • Test
      • Live payments
  1. Bitrix

Configuration

Getting started#

Please, pay attention!
The plugin configuration should only be performed after correct installation.

Open FreedomPay plugin settings#

To open the FreedomPay plugin settings, follow these steps:
Open your site's Dashboard:
image.png
Click on the “Store” item in the left panel, “Payment systems” in the sub-menu:
image.png
If you added the FreedomPay payment system before, choose it in the list, and click the button on the left side of the payment system name and click “Edit” button. If there's no FreedomPay system yet, click the button “Add payment system” on the right-top corner and choose “FreedomPay” handler:
image.png

Actually change the settings#

About payment system logo
To set the logo for the payment system, you can download the favicon image from our website freedompay.kz/logo-of-company and then upload it to your site in the payment system settings page.
After successfully opening the settings, you should review the list of settings available for change:
Payment system name
Deprecated - will be removed from the interface in future versions.
Allows you to set the name of the payment system that the user sees at the time of payment. It is recommended not to change the default value.
Default - FreedomPay
Merchant ID
Must be installed for the plugin to work.
Allows you to set the store ID in the payment gateway. To get it, use instructions.
Default - no text
Merchant Key
Must be installed for the plugin to work.
Allows you to set the store key that will be used to sign all incoming transactions in the payment gateway. To get it, use the instructions.
Default - no text
API URL
Must be installed for the plugin to work.
Allows you to set the payment gateway address. Select the address that matches the country in which your store is legally located:
api.freedompay.kz - Kazakhstan.
api.freedompay.kg - Kyrgyzstan.
api.freedompay.uz - Uzbekistan.
Default - api.freedompay.kz
Order status upon successful payment
Allows you to set what status the order will receive in the WooCommerce order list after successful payment.
Default - Processing
Order status when payment failed
Allows you to set what status the order will receive in the Bitrix order list after an unsuccessful payment.
Default - Failed
Test mode
Deprecated - will be removed from the interface in future versions.
Allows you to set whether the payment gateway works for test payments or real ones. When changing this parameter, be sure to contact the FreedomPay manager, since switching the store to test mode or real payments mode must be done both on the plugin side and on the FreedomPay server side.
Default - enabled
Order identifier type
Default - order ID
Time to close the payment page
Deprecated - will be removed from the interface in future versions.
It's not used.
Default - 10 seconds
FFD
Allows you to set whether it is necessary to generate fiscal documents (receipts) upon payment.
Default - disabled
FFD version
Allows you to set which version of the fiscal document format the payment gateway should use. Available options:
FFD v1 - Obsolete format of fiscal documents (Russia, atol 1.05).
Deprecated - will be removed from the interface in future versions.
FFD v2 atol - Current format of fiscal documents (Russia, atol 1.05).
Deprecated - will be removed from the interface in future versions.
FFD v2 gnk - Current format of fiscal documents (Uzbekistan).
Don't forget to fill in the VAT field for goods when choosing this format.
Also, if you choose this format, you need to fill in some fields for all your goods separately, including such fields as:
ikpu_code - IKPU product code
package_code - Product packaging code
unit_code - Product unit code
Default - FFD v1
Taxation system
Allows you to set which tax system is used by the store. Used only if FFD v2 atol is selected. Does not affect the payment, only the fiscalization process.
Default - General tax system
Calculation method indicator
Allows you to set which payment method is selected by the store. Used only if FFD v2 atol is selected. Does not influence the payment, only the fiscalization process.
Default - Prepayment
Indicator of the subject of calculation of goods
Allows you to set what exactly the store sells. Used only if FFD v2 atol is selected. Does not influence the payment, only the fiscalization process.
Default - Product
VAT on goods for FFD old version
Deprecated - will be removed from the interface in future versions.
Allows you to set the value added tax for goods. Used only if FFD v1 is selected. Does not influence the payment, only the fiscalization process.
Default - Without VAT
VAT on goods
Allows you to set the value added tax for goods. Used only if FFD v2 atol or FFD v2 gnk is selected. Does not influence the payment, only the fiscalization process.
Default - Without VAT
Append delivery to FFD
Allows you to set whether to include delivery in fiscal documents. Does not affect the payment, only the fiscalization process.
Default - disabled
Shipping calculation item indicator
Deprecated - will be removed from the interface in future versions.
Allows you to set how the store will characterize the delivery. Used only if FFD v2 atol is selected. Does not influence the payment, only the fiscalization process.
Default - Work
Delivery VAT for old version FFD
Deprecated - will be removed from the interface in future versions.
Allows you to set the value added tax for delivery. Used only if FFD v1 is selected. Does not influence the payment, only the fiscalization process.
Default - Without VAT
Delivery VAT
Allows you to set the value added tax for delivery. Used only if FFD v2 atol or FFD v2 gnk is selected. Does not affect the payment, only the fiscalization process.
Default - Without VAT
IKPU code for delivery
Allows you to set the IKPU delivery code (ikpu_code). Used only if FFD v2 gnk is selected. Does not influence the payment, only the fiscalization process.
Default - no text
Shipping Packaging Code
Allows you to set the package code for delivery (package_code). Used only if FFD v2 gnk is selected. Does not influence the payment, only the fiscalization process.
Default - no text
Shipping unit code
Allows you to set the unit code for delivery (unit_code). Used only if FFD v2 gnk is selected. Does not influence the payment, only the fiscalization process.
Default - no text
After changing the settings, click the “Save Changes” button:
image.png
Next step
integration testing

Support#

If you found an inaccuracy or need help, feel free to reach out! 👋
Email: support@freedompay.uz
Previous
Installation
Next
Test