Freedom Pay
  1. CMS
  2. Bitrix
Freedom Pay
  • Gateway API
    • Overview
    • Sync API
      • Overview
      • Purchase
        • Overview
        • Create payment
        • Any amount
        • Card
        • 3DSecure
        • Cancel
        • Clearing
        • Refund
        • Status
      • Payout
        • Overview
        • Card
        • IBAN
        • Balance
        • Status
      • Transfer
        • Overview
        • Card
        • 3DSecure
        • Rates
        • Status
      • Card
        • Overview
        • Add
        • 3DSecure
        • List
        • Remove
        • Status
      • Token
        • Overview
        • Token Pay
        • Apple Pay
        • Google Pay
        • Token Payout
        • Status
    • Async API
      • Overview
      • create
        • create payment
        • create payment recurrent
      • read
        • read payment
        • read request
      • edit
        • edit payment.refund
        • edit payment.reverse
        • edit payment.clearing
      • delete
  • Merchant API
    • Overview
    • Purchase
      • Overview
      • Checkout
      • JS SDK
      • Create payment
      • Any amount
      • Cancel payment
      • Clearing
      • Refund payment
      • Status
    • Payout
      • Overview
      • Create payment
      • IBAN
      • Balance status
      • Status by order_id
      • Status by Payment ID
      • Status by Payment ID V2
    • Mobile balance
      • Overview
      • Init
      • Pay
      • Approve
      • Resend code
      • Status
    • Card
      • Overview
      • Add
      • Add for payout
      • Remove
      • List
      • Status
    • Token
      • Overview
      • Saved card with CVC input (Init)
      • Saved card with CVC input (Pay)
      • Non-acceptance payments
      • Non-acceptance payments (Pay)
      • Token payout
      • Status
    • Invoice
      • Overview
      • Init
      • Info
      • Pay
      • Status
    • ATM
      • Request for payment generation
      • Withdraw request
      • Request for the status of the operation
    • Additional
      • Overview
      • Check request
      • Result notify
      • Payout notify
      • Redirect back
  • Card API
    • Overview
    • Payment Cards
      • Overview
      • Dictionaries
      • Bulk issue
      • Issue card
      • Issue plastic card
      • Activate card
      • Block card
      • Unblock card
      • Set PIN
      • Reset PIN counter
      • Close card
      • Update client
      • Card info
      • Balance
      • Secret data
      • Statement
      • Statement extended
      • Create client
      • Edit client
      • Сards' list
      • Request' status
      • Create transaction
      • Clearing transaction
      • Refund transaction
      • Transaction request' status
      • Transaction info
    • Gift Cards
      • Overview
      • List
      • Issue
      • Confirm
      • Resend
      • Resend code
      • Status
  • Partner API
    • Rates
      • Overview
      • Rates
    • Products
      • Overview
      • Dictionaries
      • Add client with product
      • Request status
    • E-Money
      • Overview
      • Add
      • Owner identification
      • Info
      • Close
      • Block
      • Balance
      • Statement
      • Request Status
    • Freedom ID
      • Overview
      • Design
      • iOS SDK
      • Android SDK
      • OAuth2
        • Authorization link
        • Token exchange
        • Token refresh
        • User info
        • Request profile
        • Get profile status
      • OIDC
        • Authorization endpoint
        • Token exchange
        • Userinfo
      • Error codes
      • Examples
        • Keycloak
    • IMTS "Leskar"
      • Overview
      • Token Generation
      • Token Refresh
      • Agent List
      • Fee Calculation
  • Mobile SDK
    • Payment SDK
      • iOS
      • Android
    • Freedom QR
      • Reader SDK (Android)
      • Provider SDK (Android)
  • CMS
    • Overview
    • Get Merchant ID and key
    • WordPress
      • Overview
      • Installation
      • Configuration
      • Test
      • Live payments
      • Update
    • Tilda
      • Overview
      • Installation
      • Configuration
      • Test
      • Live payments
    • InSales
      • Overview
      • Installation
      • Configuration
      • Test
      • Live payments
    • Ecwid
      • Overview
      • Installation
      • Configuration
      • Test
      • Live payments
    • Bitrix
      • Overview
      • Installation
      • Configuration
      • Test
      • Live payments
    • PrestaShop
      • Overview
      • Installation
      • Configuration
      • Test
      • Live payments
    • OpenCart
      • Overview
      • Installation
      • Configuration
      • Test
      • Live payments
  1. CMS
  2. 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
Modified at 2025-02-18 06:28:11
Previous
Installation
Next
Test