Skip to main content

Сценарій Створення платежу (редиректний)​

У цьому сценарії вибір способу оплати відбувається на вашому боці, а введення даних для оплати – на боці Feennex. Приймати платежі можна через гаманець Feennex або за допомогою інших способів оплати.

Вам необхідно самостійно реалізувати вибір способу оплати та повідомлення користувачу результатів проведення платежу.

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

Приклад реалізації

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

Діаграма проведення платежу при оплаті гаманцем Feennex

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

Важливо! Переконайтеся, що перед початком інтеграції ви виконали всі підготовчі кроки

Для інтеграції по API потрібно створити платіж, отримати посилання на платіжну сторінку та перенаправити на неї платника.

Оплата гаманцем Feennex​

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

Крок 1. Створіть платіж. У запиті передайте суму, валюту, платіжний напрям, ідентифікатор вашого магазину та ідентифікатор замовлення. У параметрі 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 буде надсилати сповіщення.

Перед передачею URL-адрес переконайтеся, що в особистому кабінеті ви видалили старі адреси, які вказували при створенні магазину – у цих адрес вище пріоритет. Докладніше про налаштування магазину

Крок 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 передайте підпис запиту.

Приклад запиту

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 буде надсилати сповіщення.

Перед передачею 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 виконує наступні дії:

Додатково ви можете дізнатися статус платежу при оплаті іншими способами.