Create payment

https://api.freedompay.kz

POST

/v5/g2g/create

Creates a payment by card, saved card, wallet token or recurrent profile.
The X-Action header must be gateway.payment.create.
The payment is processed asynchronously: the response returns it with status process.
Get the final status via gateway.payment.status or gateway.request.status.

Payment flow by auto_clearing

3DS challenge

Requests to the payment system are processed asynchronously: the API responds immediately, the result is available via gateway.payment.status.
With a frictionless 3DS flow (3ds.flow_type = F) there is no waiting_3ds step.
The two-step flow after approved is shown in Capture payment (clearing).

Request

Header Params

Body Params application/json

{
  "amount": 100.5,
  "currency": "KZT",
  "description": "Order #1001",
  "order_id": "order_1001",
  "auto_clearing": false,
  "from": {
    "type": "card",
    "card": {
      "name": "IVAN IVANOV",
      "pan": "4716047261941981",
      "cvc": "123",
      "year": 30,
      "month": 12
    }
  },
  "device": {
    "user_ip": "84.252.158.239"
  }
}

Responses

🟢200OK

application/json

Headers

Bodyapplication/json

Examples

Payment createdPayment declinedResult not ready (X-Request-Status: process)

{
  "id": "01978c37-a961-7d20-8434-632242b24d48",
  "status": "process",
  "amount": 100.5,
  "created_at": "2026-06-20T07:13:31.068188524Z"
}

🟠422Unprocessable Entity

🟠400Bad Request

🟠401Unauthorized

🔴500Internal Server Error

Overview

Get payment status