- Gateway API
- Overview
- Sync API
- Async API
- Merchant API
- 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
- Partner API
- Rates
- Products
- E-Money
- Freedom ID
- IMTS "Leskar"
- Mobile SDK
- CMS
create payment
POST
https://api.freedompay.kz/v5/g2g/create
Request
Header Params
X-JWS-Signature
string
required
Example:
{{tmp_jws_signature}}
X-Action
string
required
Example:
gateway.payment.create
X-Request-Id
string
required
Example:
{{$randomUUID}}
Body Params application/json
amount
integer
required
currency
string
required
description
string
required
order_id
string
required
user_id
string
required
auto_clearing
boolean
required
from
object
required
type
string
required
card
object
required
recurrent
object
required
device
object
required
user_ip
string
required
urls
object
required
check_url
string
required
result_url
string
required
Example
{
"amount": 10,
"currency": "KZT",
"description": "description",
"order_id": "1234",
"user_id": "12345",
"auto_clearing": false,
"from": {
"type": "card",
"card": {
"name": "Test Test",
"pan": "4400444400004440",
"cvc": "123",
"year": 24,
"month": 8
},
"recurrent": {
"lifetime": 1
}
},
"device": {
"user_ip": "84.252.158.239"
},
"urls": {
"check_url": "https://webhook.site/f99d3537-3f36-42a2-8206-67684739d51e",
"result_url": "https://webhook.site/f99d3537-3f36-42a2-8206-67684739d51e"
}
}Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.freedompay.kz/v5/g2g/create' \
--header 'X-JWS-Signature: {{tmp_jws_signature}}' \
--header 'X-Action: gateway.payment.create' \
--header 'X-Request-Id: {{$randomUUID}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"amount": 10,
"currency": "KZT",
"description": "description",
"order_id": "1234",
"user_id": "12345",
"auto_clearing": false,
"from": {
"type": "card",
"card": {
"name": "Test Test",
"pan": "4400444400004440",
"cvc": "123",
"year": 24,
"month": 8
},
"recurrent": {
"lifetime": 1
}
},
"device": {
"user_ip": "84.252.158.239"
},
"urls": {
"check_url": "https://webhook.site/f99d3537-3f36-42a2-8206-67684739d51e",
"result_url": "https://webhook.site/f99d3537-3f36-42a2-8206-67684739d51e"
}
}'Responses
🟢200Success
application/json
Body
id
string
required
status
string
required
amount
integer
required
created_at
string
required
Example
{
"id": "12cc1a13-3d44-4417-b700-039d979723d6",
"status": "process",
"amount": 100,
"created_at": "2024-08-21T10:37:32.687Z"
}🟠400Bad Request
🟠422Unprocessable Entity
Modified at 2025-01-05 06:48:21