Перейти к основному содержимому

Сценарий Cоздание платежа (редиректный)​

В этом сценарии выбор способа оплаты проходит на вашей стороне, а ввод данных для оплаты – на стороне Feennex. Принимать платежи можно через кошелек Feennex или с других способов оплаты.

Вам необходимо самостоятельно реализовать выбор способа оплаты и сообщение пользователю результатов проведения платежа.

Методы API, которые нужно использовать, отличаются в зависимости от способа оплаты.

Пример реализации

  1. Плательщик на вашей стороне переходит к оплате (например, нажимает на кнопку).
  2. Вы создаете платеж, в ответе получаете URL-адрес платежной страницы и перенаправляете на нее плательщика.
  3. Плательщик на платежной странице вводит данные банковской карты и кошелька или видит данные для перевода.
  4. Плательщик проводит оплату.
  5. Feennex возвращает плательщика на страницу завершения оплаты на вашей стороне.

Диаграмма проведения платежа при оплате кошельком Feennex

Диаграмма проведения платежа при оплате картой

Важно! Убедитесь, что перед началом интеграции вы выполнили все подготовительные шаги

Для интеграции по API нужно создать платеж, получить ссылку на платежную страницу и перенаправить на нее плательщика.

Оплата кошельком Feennex​

Обратите внимание! Для этого способа оплаты вам нужно использовать методы для приема платежей с помощью кошелька Feennex. В URL-адресе такие методы имеют префикс bill.

Шаг 1. Создайте платеж. В запросе передайте сумму, валюту, платежное направление, идентификатор вашего магазина и идентификатор заказа. В параметре sign передайте [подпись запроса(#sign).

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

curl https://core.feennex.com/bill/create \
   -H 'Content-Type: application/json' \
   -d '{
          "shop_currency": 840,
          "sign": "66c8d27b887",
          "payway": "feennex_usd",
          "payer_currency": 840,
          "shop_amount": 1000,
          "shop_id": 5,
          "shop_order_id": 4127
       }'

В запросе вы можете дополнительно передавать URL-адреса ваших страниц успеха и неудачи для редиректа пользователя после оплаты, а также URL-адрес, на который Feennex будет [присылать уведомление(#notifications).

Перед передачей URL-адресов убедитесь, что в личном кабинете вы удалили старые адреса, которые указывали при создании магазина – у этих адресов выше приоритет. [Подробнее про настройку магазина(#connection-flow)

Шаг 2. Перенаправьте пользователя на url, который вернется в ответе в объекте data. Это ссылка на платежную страницу Feennex, на которой пользователь введет данные кошелька Feennex и подтвердит платеж.

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

{
   "data":{
      "created": "Tue, 20 Feb 2024 13:58:35 GMT",
      "id": 123,
      "lifetime": 43200,
      "payer_account": null,
      "payer_currency": 840,
      "payer_price": 1000.0,
      "shop_amount": 1000.0,
      "shop_currency": 840,
      "shop_id": 5,
      "shop_order_id": "4127",
      "shop_refund": 930.0,
      "url": "https://example.com"
   },
   "error_code":0,
   "message":"Ok",
   "result":true
}

Если оплата прошла, Feennex выполняет следующие действия:

Если что-то пошло не так, Feennex выполняет следующие действия:

Дополнительно вы можете узнать статус платежа при оплате кошельком.

Оплата другими способами​

Обратите внимание! При оплате любыми способами, кроме кошелька Feennex, вам нужно использовать метод Создание платежа. В URL-адресе, на который нужно отправить запрос, есть префикс invoice.

Шаг 1. Создайте платеж. В запросе передайте сумму, валюту, платежное направление, идентификатор вашего магазина и идентификатор заказа. В параметре sign передайте [подпись запроса(#sign).

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

curl https://core.feennex.com/invoice/create \
   -H 'Content-Type: application/json' \
   -d '{
          "currency": 840,
          "sign": "c438896efecd63",
          "payway": "card_usd",
          "email": "[email protected]",
          "amount": 1000,
          "shop_id": 5,
          "shop_order_id": 4126
       }'

В запросе вы можете дополнительно передавать URL-адреса ваших страниц успеха и неудачи для редиректа пользователя после оплаты, а также URL-адрес, на который Feennex будет [присылать уведомление(#notifications).

Перед передачей URL-адресов убедитесь, что в личном кабинете вы удалили старые адреса, которые указывали при создании магазина – у этих адресов выше приоритет. Подробнее про настройку магазина

Шаг 2. Перенаправьте пользователя на url, который вернется в ответе в объекте data. Это ссылка на стороннюю платежную систему, на которой пользователь введет платежные данные и подтвердит платеж.

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

{
   "data":{
      "data":{
         "language":"en",
         "mdOrder":"0304a352-12c0-45bf-9ee8-694a2a381bcb"
      },
      "id":497063651,
      "method":"GET",
      "url":"https://payment-link-example.ru"
   },
   "error_code":0,
   "message":"Ok",
   "result":true
}

Если оплата прошла, Feennex выполняет следующие действия:

Если что-то пошло не так, Feennex выполняет следующие действия:

Дополнительно вы можете узнать статус платежа при оплате другими способами.