Skip to content

Kassa24

IZ Integration option

Info

This integration option supports only KZT currency.

Payment

Payment flow

  1. The customer initiates the payment on the merchant's website.
  2. The merchant sends the payment request to Overpay.
  3. Overpay sends parameters for building an HTML-form for the payment.
  4. The merchant builds an HTML-form based on the parameters from the response.
  5. The merchant redirects the customer to the form for completing the payment. The customer needs to complete the payment within 48 hours.
  6. The customer confirms the payment.
Request

Send a payment request with the following additional data:

Parameter Type Description
request object
return_url * required
 string A URL to return the customer to when the transaction is completed.
method object A section of the payment method information.
type
* required
 string kassa24
customer object A section of information about the customer.
email
* required
 string The customer's email address.
phone
* required
 string The customer's phone number without the special symbols.
Request example 
{
    "request": {
        "amount": 10,
        "currency": "KZT",
        "description": "description",
        "return_url": "https://return.com",
        "method": {
            "type": "kassa24"
        },
        "customer": {
            "email": "example@example.com",
            "phone": "79991234567"
        }
    }
}
Response

Build an HTML form based on the parameters in the form object. Redirect the customer to the form to finalize the payment.

Response example 
{
  "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://backoffice.overpay.io/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.overpay.io/beyag/transactions/returns/260ded068740631540a58d9f5c66b02506b6607ec397fa3689911bd7677e8616/67fd0d2f-b84e-431c-bde4-0f57ae278cb7",
          "type": "hidden"
        },
        {
          "name": "signature",
          "value": "2BD45B4CF9A9975DBC697FBC36FEF221",
          "type": "hidden"
        }
      ]
    }
  }
}