Papara

Вариант интеграции 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	papara
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": "papara"
        },
        "customer": {
            "email": "example@example.com",
            "phone": "79991234567",
            "first_name": "Phil",
            "last_name": "Williams"
        }
    }
}

Ответ

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

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

{
  "transaction": {
    "uid": "6f8d889c-3b69-4a6c-9bc8-50c22a9090b0",
    "type": "payment",
    "status": "pending",
    "amount": 202,
    "currency": "TRY",
    "description": "description",
    "created_at": "2025-02-02T19:30:25Z",
    "updated_at": "2025-02-02T19:30:25Z",
    "method_type": "papara",
    "receipt_url": "https://account.freepayment.online/customer/transactions/6f8d889c-3b69-4a6c-9bc8-50c22a9090b0/33b21d418465c695a01e5aac74dd01966488c61915895bfa6423b560bfbaac1a",
    "payment": {
      "status": "pending",
      "gateway_id": 4908,
      "message": "Transaction was initialized."
    },
    "papara": {
      "type": "papara"
    },
    "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": "6f8d889c3b694a6c9bc850c22a9090b0",
          "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/6f8d889c-3b69-4a6c-9bc8-50c22a9090b0",
          "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": "038B513F6A228978F90746AADFF4E4E1",
          "type": "hidden"
        }
      ]
    }
  }
}