Skip to main content

Про виплати​

Виплата — це операція з перерахування грошей з балансу вашого магазину на гаманці Feennex або в сторонні платіжні системи.

Наприклад, ви отримали оплату від платника на рахунок вашого магазину і хочете вивести ці гроші на банківську картку.

Як проходять виплати​

Якщо ви вже приймали платежі за допомогою Feennex, у вас вже є магазин або кілька магазинів. Кожен магазин має баланс – гроші, які вам перерахував платник.

Перед виплатою:

  • Перевірте стан рахунку вашого магазину в особистому кабінеті
  • Отримайте від вашого клієнта дані для проведення виплати, наприклад номер гаманця Feennex або банківської картки, на яку потрібно переказати гроші.
  • Перевірте, що ви вкладаєтеся в ліміти по виплатах, в залежності від способу отримання грошей, який вибрав клієнт. Актуальні ліміти вам повідомить менеджер.

Розмір комісії при виплатах ви можете уточнити у менеджера.

Способи отримання виплат​

За допомогою API Feennex ви можете здійснювати виплати на гаманці Feennex і сторонні платіжні системи. Доступні платіжні системи для вашого магазину ви можете дізнатися в особистому кабінеті в налаштуваннях магазину в розділі Напрямки виведення. Для підключення додаткових платіжних систем зв'яжіться з менеджером.

Виплати на гаманці Feennex​

Сценарій проведення виплати на гаманці Feennex​

  • Крок 1. Не обов'язковий крок. Ви запитуєте попередній розрахунок виплати – надсилаєте Feennex POST-запит з даними про те, яку суму списати з балансу вашого магазину і на який гаманець її переказати.
  • Крок 2. Ви створюєте виплату – надсилаєте Feennex POST-запит з даними про те, яку суму списати з балансу вашого магазину і на який гаманець її переказати.

Feennex проводить виплату на переданий гаманець і повертає вам ідентифікатор виплати. Це означає, що виплата успішна.

Проведення виплати через API

Крок 1. Запитайте попередній розрахунок виплати. У запиті передайте суму виплати, тип суми виплати, що передається, валюту отримання виплати, валюту списання з магазину, ідентифікатор вашого магазину. У параметрі sign передайте підпис запиту.

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

curl https://core.feennex.com/transfer/try \
   -H 'Content-Type: application/json' \
   -d '{
          "amount": 10,
          "amount_type": "receive_amount",
          "payee_currency": 840,
          "shop_currency": 840,
          "shop_id": 112,
          "sign": "cd30ba2b6e29f5"
       }'

Приклад відповіді

{
  "data": {
    "account_info_config": {
      "payee_account": {
        "comment": {
          "en": "Enter Wallet Number or Email",
          "ru": "Введите номер кошелька или email"
        },
        "example": "201557414711",
        "label": {
          "en": "Wallet Number or Email",
          "ru": "Введите номер кошелька или email"
        },
        "regex": "^20[\\d]{10}$|^([a-zA-Z0-9_-]+\\.)*[a-zA-Z0-9_-]+@[a-zA-Z0-9_-]+(\\.[a-zA-Z0-9_-]+)*\\.[a-zA-Z]{2,6}$"
      }
    },
    "info": {},
    "payee_amount": 1.11,
    "payee_currency": 978,
    "shop_currency": 840,
    "write_off_amount": 1.19
  },
  "error_code": 0,
  "message": "Ok",
  "result": true
}

Крок 2. Створіть виплату на гаманець. У запиті передайте суму виплати, тип суми виплати, що передається, обліковий запис одержувача виплати в Feennex, валюту отримання виплати, валюту списання з магазину, ідентифікатор вашого магазину та унікальний ідентифікатор виплати на вашому боці. У параметрі sign передайте підпис запиту.

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

curl https://core.feennex.com/transfer/create \
   -H 'Content-Type: application/json' \
   -d '{
          "amount": 10,
          "amount_type": "receive_amount",
          "payee_account": "201497141132",
          "payee_currency": 840,
          "shop_currency": 840,
          "shop_id": 112,
          "shop_payment_id": "55ac443d-958b-40e3-8956-e04e72561324",
          "sign": "cd30ba2b6e29f5"
       }'

Приклад відповіді

{
  "data": {
    "balance": 88.91,
    "id": 12,
    "payee_account": 201497141132,
    "payee_amount": 10,
    "payee_currency": 840,
    "shop": 112,
    "shop_currency": 840,
    "write_off_amount": 10
  },
  "error_code": 0,
  "message": "Ok",
  "result": true
}

Виплата успішно пройшла!

Якщо у відповіді з'явилася помилка, ви можете запросити статус виплати на гаманець.

Виплати на сторонні платіжні системи​

  • Крок 1. Ви запитуєте попередній розрахунок виплати – надсилаєте Feennex POST-запит з даними про те, яку суму списати з балансу вашого магазину і на яку платіжну систему її переказати. У параметрі account_info_config можуть повернутися додаткові параметри, які потрібно передавати в наступних запитах
  • Крок 2. Ви перевіряєте можливість провести виплату в обрану платіжну систему з боку Feennex – надсилаєте Feennex POST-запит
  • Крок 3. Ви створюєте виплату — надсилаєте Feennex POST-запит з даними про те, яку суму списати з балансу вашого магазину і на яку платіжну систему її переказати. Feennex проводить виплату в обрану платіжну систему і повертає вам об'єкт виплати з актуальним статусом.
  • Крок 4. Ви, не частіше, ніж раз на хвилину, запитуєте статус виплати. Якщо статус — 5 (Success), виплата успішна, а гроші списані з балансу вашого магазину.

Проведення виплати через API

Крок 1. Запитайте попередній розрахунок виплати. У запиті передайте суму і валюту виплати, тип суми виплати, що передається, напрямок для виплати, ідентифікатор вашого магазину. У параметрі sign передайте підпис запиту.

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

curl https://core.feennex.com/withdraw/try \
   -H 'Content-Type: application/json' \
   -d '{
   
          "amount_type": "ps_amount",
          "shop_currency": 840,
          "sign": "f97c52fa8d273a",
          "payway": "card_usd",
          "amount": 1,
          "shop_id": 112
       }'

Приклад відповіді

{ 
"data": 
    { 
        "account_info_config"
        {
            "account": 
            {
                "regex": "\\d{9,15}$",
                "title": "79123456789"
            }
        }
     "payee_receive": 1,
    "ps_currency": 840,
    "shop_currency": 840,
    "shop_write_off": 1.02 
}, 
"error_code": 0, 
"message": "Ok", 
"result": true 
}

Якщо у відповіді повертається об'єкт account_info_config з додатковими параметрами, ці параметри, крім account, вам потрібно передавати в запиті на Створення виплати в параметрі account_details.

Крок 2. Перевірте можливість провести виплату. У запиті передайте акаунт одержувача виплати для перевірки, напрямок для виплати, суму виплати, ідентифікатор магазину на вашому боці та додаткову інформацію про акаунт, якщо є. У параметрі sign передайте підпис запиту.

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

curl https://core.feennex.com/check_account \
   -H 'Content-Type: application/json' \
   -d '{
          "account": "4111111111111111",
          "account_details": {
            "contract": "C1234"
          },
          "sign": "faf7ee6db712752f2b107e05328bbd0d",
          "payway": "card_eur",
          "amount": 10.5,
          "shop_id": 1
       }'

Приклад відповіді

{
  "data": {
    "account_info": {
      "verified": "true"
    },
    "provider_status": 1,
    "result": true
  },
  "error_code": 0,
  "message": "Ok",
  "result": true
}

Крок 3. Створіть виплату на рахунок. У запиті передайте обліковий запис одержувача виплати, суму виплати, тип суми, що передається, напрямок виплати, валюту списання з магазину, ідентифікатор вашого магазину та унікальний ідентифікатор виплати на вашому боці. У параметрі sign передайте підпис запиту.

Приклад запиту на створення виплати

curl https://core.feennex.com/withdraw/create \
   -H 'Content-Type: application/json' \
   -d '{
          "account": "4111111111111111",
          "amount": 1,
          "amount_type": "ps_amount",
          "email": "[email protected]",
          "payway": "card_usd",
          "shop_currency": 840,
          "shop_id": 112,
          "shop_payment_id": "63288d86-241c-418e-94b8-db4bbf5026f",
          "sign": "b4c3ca4b403bb"
       }'

Приклад відповіді

{
  "data": {
    "balance": 0,
    "id": 11298076,
    "payee_receive": 1,
    "ps_currency": 840,
    "shop_currency": 840,
    "shop_payment_id": "63288d86-241c-418e-94b8-db4bbf5026f",
    "shop_write_off": 1.02,
    "status": 3
  },
  "error_code": 0,
  "message": "Ok",
  "result": true
}

Крок 4. Запитуйте статус виплати за ідентифікатором виплати або номером виплати у вашій системі. У запиті вкажіть час відправлення запиту, ідентифікатор вашого магазину та ідентифікатор виплати. У параметрі sign вкажіть підпис запиту.

Приклад запиту на отримання статусу виплати за ідентифікатором виплати

curl https://core.feennex.com/withdraw/status \
   -H 'Content-Type: application/json' \
   -d '{
          "now": "2024-12-06 16:07:28.878200",
          "shop_id": 112,
          "withdraw_id": 11298076,
          "sign": "e1dfc97b2c5430"
       }'

Приклад об'єкта виплати в разі успіху


{
     "data": {
        "id": 11298076,
        "payee_receive": 1,
        "ps_currency": 840,
        "shop_currency": 840,
        "shop_payment_id": "63288d86-241c-418e-94b8-db4bbf5026f",
        "shop_write_off": 1.02,
        "status": 5
    }, 
    "result": True,
    "error_code": 0, 
    "message": "Ok"
}

Параметр status має значення 5, що відповідає успіху. Детальніше про статуси при виплатах на рахунок

Виплата успішно пройшла!