PayFix

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

Info

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

Оплата

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

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

Запрос

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

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

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

{
    "request": {
        "test": true,
        "amount": 202,
        "currency": "TRY",
        "description": "description",
        "return_url": "https://return.com",
        "method": {
            "type": "payfix"
        },
        "customer": {
            "email": "example@example.com",
            "phone": "79991234567",
            "first_name": "Phil",
          "last_name": "Williams"
        }
    }
}

Ответ

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

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

{
  "transaction": {
    "uid": "4bfe1d03-d549-4c21-9930-1bbf7ecb581a",
    "type": "payment",
    "status": "pending",
    "amount": 202,
    "currency": "TRY",
    "description": "description",
    "created_at": "2025-02-03T10:42:06Z",
    "updated_at": "2025-02-03T10:42:06Z",
    "method_type": "payfix",
    "receipt_url": "https://account.freepayment.online/customer/transactions/4bfe1d03-d549-4c21-9930-1bbf7ecb581a/9e618435f613ed8524d35d9d43d5cfbec074cb7110785de4a59b9f1810167565",
    "payment": {
      "status": "pending",
      "gateway_id": 4908,
      "message": "Transaction was initialized."
    },
    "payfix": {
      "type": "payfix"
    },
    "customer": {
      "first_name": "Phil",
      "last_name": "Williams",
      "email": "example@example.com",
      "phone": "79991234567",
      "ip": null
    },
    "manually_corrected_at": null,
    "version": 0,
    "message": "Transaction was initialized.",
    "test": true,
    "billing_address": {
      "first_name": "Phil",
      "last_name": "Williams",
      "email": "example@example.com",
      "phone": "79991234567"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },    
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "link-to-payment-page",
      "method": "POST",
      "fields": [
        {
          "name": "amount",
          "value": "2.02",
          "type": "hidden"
        },
        {
          "name": "amountcurr",
          "value": "TRY",
          "type": "hidden"
        },
        {
          "name": "currency",
          "value": "EXT",
          "type": "hidden"
        },
        {
          "name": "number",
          "value": "4bfe1d03d5494c2199301bbf7ecb581a",
          "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": "ACC041111",
          "type": "hidden"
        },
        {
          "name": "backURL",
          "value": "https://api.freepayment.online/beyag/transactions/returns/260ded068740631540a58d9f5c66b02506b6607ec397fa3689911bd7677e8616/4bfe1d03-d549-4c21-9930-1bbf7ecb581a",
          "type": "hidden"
        },
        {
          "name": "cf1",
          "value": "first_name:Phil;last_name:Williams",
          "type": "hidden"
        },
        {
          "name": "cf2",
          "value": "",
          "type": "hidden"
        },
        {
          "name": "cf3",
          "value": "",
          "type": "hidden"
        },
        {
          "name": "signature",
          "value": "2465DF422E5FEE4A4F20CDBE69455288",
          "type": "hidden"
        }
      ]
    }
  }
}