Kassa24

Вариант интеграции IZ

Info

Данная интеграция поддерживает только валюту KZT.

Оплата

Процесс проведения оплаты

1. Покупатель инициирует платеж на сайте торговца.
2. Торговец отправляет запрос оплаты в Freepayment.
3. Freepayment присылает в ответе параметры для создания HTML-формы для оплаты.
4. Торговец создает HTML-форму для оплаты, используя значения параметров из ответа.
5. Торговец перенаправляет покупателя на форму для оплаты. Покупатель должен завершить оплату в течение 48 часов.
6. Покупатель подтверждает оплату.

Запрос

Отправьте запрос оплаты со следующими дополнительными параметрами:

Параметр	Тип данных	Описание
request	object
return_url * обязательный	string	URL, на который будет возвращен покупатель после завершения транзакции.
method	object	Секция параметров способа оплаты.
type * обязательный	string	kassa24
customer	object	Секция информации о покупателе.
email * обязательный	string	Адрес электронной почты покупателя.
phone * обязательный	string	Номер телефона покупателя без специальных символов.

Пример запроса

{
    "request": {
        "amount": 10,
        "currency": "KZT",
        "description": "description",
        "return_url": "https://return.com",
        "method": {
            "type": "kassa24"
        },
        "customer": {
            "email": "example@example.com",
            "phone": "79991234567"
        }
    }
}

Ответ

Создайте HTML-форму, используя параметры из секции form. Отправьте покупателя на форму для завершения оплаты.

Пример ответа

{
  "transaction": {
    "uid": "67fd0d2f-b84e-431c-bde4-0f57ae278cb7",
    "type": "payment",
    "status": "pending",
    "amount": 10,
    "currency": "KZT",
    "description": "description",
    "created_at": "2025-03-04T08:55:13Z",
    "updated_at": "2025-03-04T08:55:13Z",
    "method_type": "kassa24",
    "receipt_url": "https://account.freepayment.online/customer/transactions/67fd0d2f-b84e-431c-bde4-0f57ae278cb7/284c5c71f88c2819ef8ea573c92799981e11ea8adb64e7e2655d4c5930effd70",
    "payment": {
      "status": "pending",
      "gateway_id": 4908,
      "message": "Transaction was initialized."
    },
    "kassa24": {
      "type": "kassa24"
    },
    "customer": {
      "email": "example@example.com",
      "phone": "79991234567",
      "ip": null
    },
    "manually_corrected_at": null,
    "version": 0,
    "message": "Transaction was initialized.",
    "test": false,
    "billing_address": {
      "email": "example@example.com",
      "phone": "79991234567"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "payment-link",
      "method": "POST",
      "fields": [
        {
          "name": "amount",
          "value": "0.10",
          "type": "hidden"
        },
        {
          "name": "amountcurr",
          "value": "KZT",
          "type": "hidden"
        },
        {
          "name": "currency",
          "value": "EXT",
          "type": "hidden"
        },
        {
          "name": "number",
          "value": "67fd0d2fb84e431cbde40f57ae278cb7",
          "type": "hidden"
        },
        {
          "name": "description",
          "value": "https%3A%2F%2Fexample.com",
          "type": "hidden"
        },
        {
          "name": "trtype",
          "value": "1",
          "type": "hidden"
        },
        {
          "name": "phone",
          "value": "79991234567",
          "type": "hidden"
        },
        {
          "name": "email",
          "value": "example@example.com",
          "type": "hidden"
        },
        {
          "name": "account",
          "value": "700",
          "type": "hidden"
        },
        {
          "name": "backURL",
          "value": "https://api.freepayment.online/beyag/transactions/returns/260ded068740631540a58d9f5c66b02506b6607ec397fa3689911bd7677e8616/67fd0d2f-b84e-431c-bde4-0f57ae278cb7",
          "type": "hidden"
        },
        {
          "name": "signature",
          "value": "2BD45B4CF9A9975DBC697FBC36FEF221",
          "type": "hidden"
        }
      ]
    }
  }
}