1. Products
Freedom Pay
  • Overview
  • Gateway API
    • Overview
    • Sync API
      • Overview
      • Purchase
        • Overview
        • Create payment
        • Any amount
        • Card
        • 3DSecure
        • Recurrent
        • 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
      • read
        • read payment
        • read request
      • edit
        • edit payment.refund
        • edit payment.reverse
        • edit payment.clearing
  • Merchant API
    • Overview
    • Purchase
      • Overview
      • Checkout
      • Card token
        • Overview
        • Tokenize card
        • Delete token
        • Card token list
        • Create payment (with CVC)
        • Confirm payment (with CVC)
        • Create payment
        • Confirm payment
      • Create payment
      • Any amount
      • Reccuring payment
      • Cancel payment
      • Clearing
      • Refund payment
      • Status
    • Payout
      • Overview
      • Card token
        • Tokenize card
        • Delete token
        • Card token list
        • Create payment
      • Create payment
      • IBAN
      • Balance status
      • Status
    • Mobile balance
      • Overview
      • Init
      • Pay
      • Approve
      • Resend code
      • Status
    • Invoice
      • Overview
      • Create invoice
      • Info
      • Refund
      • Status
      • Cancel
    • SDK
      • JS SDK
      • Merchant SDK
        • Google Pay
        • Android
        • IOS
    • 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
    • Redirect back
      POST
    • Result notify
      POST
    • Payout notify
      POST
    • Check request
      POST
  • Card API
    • Overview
    • Client
      • Card link
      • Сards' list
      • Create client
      • Client info
      • Update client
      • Verify client
    • Transactions
      • Create transaction
      • Clearing transaction
      • Refund transaction
      • Transaction info
      • Transaction status (depricated)
      • Transaction status
    • Card
      • Activate card
      • Block card
      • Balance
      • Card info
      • Card update
      • Card tokenization
      • Close card
      • Find card
      • Issue card
      • Issue plastic card
      • Operations' list
      • Reset PIN counter
      • Statement extended
      • Set PIN
      • Secret data
      • Unblock card
    • Limits
      • Limits list
      • Set limits
    • Bulk issue
    • Cardholder validation
    • Request' status
  • Partner API
    • Rates
      • Overview
      • Rates
    • Products
      • Overview
      • Dictionaries
      • Add client with product
        POST
      • Client request status
        POST
      • Create terminal
        POST
      • Update terminal limits
        POST
      • Product request status
        POST
    • E-Money
      • Overview
      • Add
      • Owner identification
      • Info
      • Close
      • Block
      • Balance
      • Statement
      • Request Status
    • Device ID
      • Android SDK
      • iOS SDK
    • Implement SuperApp
      • Overview
      • Pay
      • Refund
    • Account
      • Overview
      • Create payment
      • Payment status
      • Batch statuses
      • Statement
      • Statement status
      • Balance
      • Balance status
    • Invoices
      • Info
  1. Products

Dictionaries

Request#

CodeDescription
successSuccessfully processed.
processIn progress.
errorProcessing error.

Product#

Product IDName
10001Freedom Pos
11001Freedom Box
20000Freedom Ecom

Freedom POS#

Parameter NameParameter NameParameter NameDescriptionType
productObject containing product parameters.object
product_id (required)Identifier of the product (Reference Guide).integer
mcc (required)Merchant Category Code.string
currency (required)Currency for transactions.string
name (required)Name of the trading point displayed in the softPOS application.string
descriptor (required)Terminal descriptor (Maximum 24 characters, Latin alphabet).string
address (required)Address data object where Freedom Pos will be used.object
country (required)Country (alpha-3 format).string
postal_code (required)Postal code.string
address_line1 (required)City of registration.string
address_line2 (required)Street of registration.string
address_line3 (required)Building and premises of registration.string
user (required)Cashier data object for Freedom Pos.object
name (required)Full name of the cashier.string
email (required)Email of the cashier.string
phone (required)Phone number of the cashier.string
package_name (required)Name of the softPOS application.string

Freedom ECOM#

Parameter NameParameter NameParameter NameDescriptionType
productObject containing product parameters.object
product_id (required)Identifier of the product (Reference Guide).integer
name (required)Name of the trading point displayed in the softPOS application.string
mcc (required)Merchant Category Code.string
descriptor (required)Terminal descriptor (Maximum 24 characters, Latin alphabet).string
merchant_url (required)The address where the terminal will be used.string
merchant_ip (required)IP address from where requests for operations will be initiated.string
address (required)Address data object where Freedom Pos will be used.object
country (required)Country (alpha-3 format).string
postal_code (required)Postal code.string
address_line1 (required)City of registration.string
address_line2 (required)Street of registration.string
address_line3 (required)Building and premises of registration.string
limitArray containing limits.array
typeLimit type.
See reference		string
valueValue of limits.
See reference		string
currency (required)Currency of transactions.string

Freedom BOX#

Parameter NameParameter NameParameter NameDescriptionType
productObject containing product parameters.object
product_id (required)Identifier of the product (Reference Guide).integer
mcc (required)Merchant Category Code.string
currency (required)Currency for transactions.string
package_nameName of type Freedom Box. See the reference documentation for details.string
name (required)Name of the trading point displayed in the softPOS application.string
descriptor (required)Terminal descriptor (Maximum 24 characters, Latin alphabet).string
address (required)Address data object where Freedom Pos will be used.object
country (required)Country (alpha-3 format).string
postal_code (required)Postal code.string
address_line1 (required)City of registration.string
address_line2 (required)Street of registration.string
address_line3 (required)Building and premises of registration.string
limitArray containing limits.array
typeLimit type.
See reference		string
valueValue of limits.
See reference		string

Types Freedom Box#

Descriptionpackage_nameMID, TID
With a credit limit“freedombox.credit”MID = 6*******
TID = 8*******
No credit limit“freedombox.nocredit”MID = 70******
TID = 55******
Bank POS“freedombox.posbank”MID = 70******
TID = 55******

Limits#

Limits for the Freedom Ecom Product#

Limit Type (type)Limit Value (value)Description
DAILY_LIM1MLNKZTMISDaily limit of 1 million KZT
1MLNDaily limit of 1 million KZT
2MLNDaily limit of 2 million KZT
5MLNDaily limit of 5 million KZT
10MLNDaily limit of 10 million KZT
15MLNDaily limit of 15 million KZT
20MLNDaily limit of 20 million KZT
30MLNKZTDaily limit of 30 million KZT
MAXTRAMOUNTLIMDAILYBYCARD300KKZTMISDaily per-transaction limit of 300,000 KZT per card of any bank
300KKZTDaily per-transaction limit of 300,000 KZT per card of any bank
500KKZTDaily per-transaction limit of 500,000 KZTper card of any bank
1MLNKZTDaily per-transaction limit of 1,000,000 KZT per card of any bank
3MLNKZTDaily per-transaction limit of 3,000,000 per card of any bank
5MLNKZTDaily per-transaction limit of 5,000,000 per card of any bank
DAILY_LIM_REVERS50KKZTMISDaily refund limit of 50,000 KZT
50KKZTDaily refund limit of 50,000 KZT
500KDaily refund limit of 500,000 KZT
1MLNKZTDaily refund limit of 1,000,000 KZT
3MLNKZTDaily refund limit of 3,000,000 KZT
5MLNKZTDaily refund limit of 5,000,000 KZT
MAX_TR_AMNT_LIMMAX100KMaximum transaction amount of 100,000 KZT
MAX500KMaximum transaction amount of 500,000 KZT
MAX1MLNMaximum transaction amount of 1 million KZT
VISA_MAX_TR_AMNT_LIMVMAX2500USDMaximum transaction amount with VISA: 2,500 USD
MC_MAX_TR_AMNT_LIMMCMAX5000USDMaximum transaction amount with Mastercard: 5,000 USD
MONTHLY_LIM10MLNKZTMonthly limit of 10 million KZT
30MLNKZTMonthly limit of 30 million KZT
60MLNKZTMonthly limit of 60 million KZT
300MLNKZTMonthly limit of 300 million KZT
1BILKZTMonthly limit of 1 billion KZT

Limits for the Freedom Box Product#

Limit Type (type)Limit Value (value)Description
DAILY_LIM_POS1MLNKZTMISDaily limit of 1 million KZT
1MLNKZTDaily limit of 1 million KZT
5MLNKZTDaily limit of 5 million KZT
GROUP1Daily limit of 10 million KZT
15MLNKZTDaily limit of 15 million KZT
GROUP2Daily limit of 20 million KZT
GROUP3Daily limit of 30 million KZT
GROUP4Daily limit of 40 million KZT
GROUP5Daily limit of 50 million KZT
GROUP6Daily limit of 60 million KZT
DAILY_LIM_POS_BY_CARD300KKZTMISDaily per-transaction limit of 300,000 KZT per card of any bank
300KKZTDaily per-transaction limit of 300,000 KZT per card of any bank
500KKZTDaily per-transaction limit of 500,000 KZT per card of any bank
GROUP1_2_3Daily per-transaction limit of 1,000,000 KZT per card of any bank
GROUP4_5Daily per-transaction limit of 2,000,000 KZT per card of any bank
GROUP6Daily per-transaction limit of 3,000,000 KZT per card of any bank
5MLNKZTDaily per-transaction limit of 5,000,000 KZT per card of any bank
DAILY_LIM_REVERS50KKZTMISDaily refund limit of 50,000 KZT
50KKZTDaily refund limit of 50,000 KZT
500KDaily refund limit of 500,000 KZT
1MLNKZTDaily refund limit of 1,000,000 KZT
3MLNKZTDaily refund limit of 3,000,000 KZT
5MLNKZTDaily refund limit of 5,000,000 KZT
DAILY_LIM_REVERS_BY_CARD25KKZTMISDaily refund limit of 25,000 KZT per card of any bank
25KKZTDaily refund limit of 25,000 KZT per card of any bank
300KKZTDaily refund limit of 300,000 KZT per card of any bank
500KKZTDaily refund limit of 500,000 KZT per card of any bank
1MLNKZTDaily refund limit of 1,000,000 KZT per card of any bank
3MLNKZTDaily refund limit of 3,000,000 KZT per card of any bank

Limits for the Freedom Pos Product#

Limit Type (type)Limit Value (value)Description
DAILY_LIM_SPOS1MLNKZTDaily limit of 1 million KZT
1MLNKZTMISDaily limit of 1 million KZT
GROUP1Daily limit of 5 million KZT
GROUP2Daily limit of 10 million KZT
15MLNKZTDaily limit of 15 million KZT
GROUP3Daily limit of 20 million KZT
DAILY_LIM_SPOS_BY_CARD300KKZTDaily per-transaction limit of 300,000 KZT per card of any bank
300KKZTMISDaily per-transaction limit of 300,000 KZT per card of any bank
500KKZTDaily per-transaction limit of 500,000 KZT per card of any bank
GROUP1_2_3Daily per-transaction limit of 1,000,000 KZT per card of any bank
GROUP6Daily per-transaction limit of 3,000,000 KZT per card of any bank
5MLNKZTDaily per-transaction limit of 5,000,000 KZT per card of any bank
DAILY_LIM_REVERS50KKZTMISDaily refund limit of 50,000 KZT
50KKZTDaily refund limit of 50,000 KZT
500KDaily refund limit of 500,000 KZT
1MLNKZTDaily refund limit of 1,000,000 KZT
3MLNKZTDaily refund limit of 3,000,000 KZT
5MLNKZTDaily refund limit of 5,000,000 KZT
DAILY_LIM_REVERS_BY_CARD25KKZTMISDaily refund limit of 25,000 KZT per card of any bank
25KKZTDaily refund limit of 25,000 KZT per card of any bank
300KKZTDaily refund limit of 300,000 KZT per card of any bank
500KKZTDaily refund limit of 500,000 KZT per card of any bank
1MLNKZTDaily refund limit of 1,000,000 KZT per card of any bank
3MLNKZTDaily refund limit of 3,000,000 KZT per card of any bank

Reference for daily_pos_limit sizes#

CodeDescription
GROUP110,000,000 KZT
GROUP220,000,000 KZT
GROUP330,000,000 KZT
GROUP450,000,000 KZT
GROUP570,000,000 KZT
GROUP6100,000,000 KZT

Reference for daily_card_limit sizes#

CodeDescription
GROUP1_2_31,000,000 KZT
GROUP4_52,000,000 KZT
GROUP63,000,000 KZT
Previous
Overview
Next
Add client with product