О выплатах

О выплатаx

Выплата — это операция по перечислению денег с баланса вашего магазина на кошельки Feennex или в сторонние платежные системы.

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

Как проходят выплaты

Если вы уже принимали платежи с помощью Feennex, у вас уже есть магазин или несколько магазинов. У каждого магазина есть баланс – деньги, которые вам перечислил плательщик.

Перед выплатой:

Проверьте состояние счета вашего магазина в личном кабинете
Получите от вашего клиента данные для проведения выплаты, например номер кошелька Feennex или банковской карты, на которую нужно перевести деньги.
Проверьте, что укладываетесь в лимиты по выплатам, в зависимости способа получения денег, который выбрал клиент. Актуальные лимиты вам сообщит менеджер.

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

Способы получeния выплaт

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

Выплаты на кошельки Feennex

Сценарий проведения выплаты на кошельки Feennex

Шаг 1. Не обязательный шаг. Вы запрашиваете предварительный расчет выплаты – отправляете Feennex POST-запрос с данными о том, какую сумму списать с баланса вашего магазина и на какой кошелек ее перевести.
Шаг 2. Вы создаете выплату — отправляете Feennex POST-запрос с данными о том, какую сумму списать с баланса вашего магазина и на какой кошелек ее перевести.

Feennex проводит выплату на переданный кошелек и возвращает вам идентификатор выплаты. Это значит, что выплата успешна.

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

Шаг 1. Запросите предварительный расчет выплаты. В запросе передайте сумму выплаты, тип передаваемой суммы выплаты, валюту получения выплаты, валюту списания с магазина, идентификатор вашего магазина. В параметре sign передайте [подпись запроса(#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 передайте [подпись запроса(#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
}

Выплата успешно прошла!

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

Bыплаты на сторонние платежные системы

Шаг 1. Вы запрашиваете предварительный расчет выплаты – отправляете Feennex POST-запрос с данными о том, какую сумму списать с баланса вашего магазина и на какую платежную систему ее перевести. В параметре account_info_config могут вернуться дополнительные параметры, которые надо передавать в последующих запросах
Шаг 2. Вы проверяете возможность провести выплату в выбранную платежную систему со стороны Feennex – отправляете Feennex POST-запрос
Шаг 3. Вы создаете выплату — отправляете Feennex POST-запрос с данными о том, какую сумму списать с баланса вашего магазина и на какую платежную систему ее перевести. Feennex проводит выплату в выбранную платежную систему и возвращает вам объект выплаты с актуальным статусом.
Шаг 4. Вы, не чаще, чем раз в минуту, запрашиваете статус выплаты. Если статус — 5 (Success), выплата успешна, а деньги списаны с баланса вашего магазина.

Прoведение выплаты через API

Шаг 1. Запросите предварительный расчет выплаты. В запросе передайте сумму и валюту выплаты, тип передаваемой суммы выплаты, направление для выплаты, идентификатор вашего магазина. В параметре sign передайте [подпись запроса(#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 передайте [подпись запроса(#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 передайте [подпись запроса(#sign).

Пример запроса на создание выплаты

curl https://core.feennex.com/withdraw/create \
   -H 'Content-Type: application/json' \
   -d '{
          "account": "4111111111111111",
          "amount": 1,
          "amount_type": "ps_amount",
          "payway": "card_usd",
          "email": "[email protected]",
          "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, что соответствует успеху. Подробнее о статусах при выплатах на счет

Выплата успешно прошла!

О выплатаx​

Как проходят выплaты​

Способы получeния выплaт​

Выплаты на кошельки Feennex​

Сценарий проведения выплаты на кошельки Feennex​

Bыплаты на сторонние платежные системы​

О выплатаx

Как проходят выплaты

Способы получeния выплaт

Выплаты на кошельки Feennex

Сценарий проведения выплаты на кошельки Feennex

Bыплаты на сторонние платежные системы