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

Group Bыплата на кошелек Feennex

Перед интеграцией ознакомьтесь с разделом Началo работы с API

Предварительный расчет выплаты на кошелек Feennex transfer/try [/transfer/try]

Метод не обязательный для создания выплаты на кошелек. Возвращает дополнительную информацию для создания выплаты на кошелек с предварительным расчетом комиссии.

Для метода нужно сформировать подпись с помощью обязательных параметров запроса: amount, amount_type, payee_currency, shop_currency и shop_id. Сформированную подпись нужно передать в параметре sign.

Нажмите на кнопку в конце описания метода, чтобы увидеть описание параметров запроса и ответа.

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

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

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

POST Предварительный расчет выплаты [POST]

Request (application/json)
- Attributes
  - amount: 1 (number, required) - Сумма получения или списания, зависит от значения amount_type
  - amount_type: receive_amount (string, required) - Определяет тип суммы. receive_amount – сумма выплаты, которая поступит на кошелек, writeoff_amount - сумма, которая спишется с баланса вашего магазина
  - payee_currency: 840 (string, required) - Валюта, в которой выплата поступит на кошелек Feennex. Возможные значения валют
  - shop_currency: 840 (number, required) - Валюта, с которой выплата спишется со счета вашего магазина. Возможные значения валют
  - shop_id: 1 (number, required) - Идентификатор вашего магазина, с которого проходит выплата
  - sign: cea33ec0eeeef98 (string, required) - Подпись запроса
- Body
```
        {
           "amount": 1.11,
           "amount_type": "receive_amount",
           "payee_currency": 978,
           "shop_currency": 840,
           "shop_id": 6,
           "sign": "cea33ec0eeeef98"
        }
```

Response 200 (application/json)

Headers
Body

        {
            "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
        }   

Attributes (object)
- data (object, required) - Объект содержит информацию о выплате
  - account_info_config (object, required) - Информация об аккаунте, на который будет выплата
    - payee_account (object, required) - Дополнительная информация об аккаунте, на который будет выплата. Параметры в объекте могут отличаться для каждого направления на выплату
  - info (object, required) - Служебный параметр
  - payee_amount: 1.11 (number, required) - Сумма, которая поступит на ваш счет
  - payee_currency: 978 (number, required) - Валюта суммы, которая поступит на ваш счет
  - shop_currency: 840 (number, required) - Валюта суммы, которая спишется со счета вашего магазина
  - write_off_amount (number, required) - Сумма, которая спишется со счета магазина
- error_code: 0 (number, required) - Код ошибки. Возможные значения кодов ошибок
- message: Ok (string, required) - Описание ошибки. По значению этого параметра можно определить успешность запроса и узнать, что пошло не так
- result: true (boolean, required) - Успешность запроса

Выплaта на кошелек Feennex transfer/create [/transfer/create]

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

Важно! После создания выплаты на кошелек в ответе не возвращается статус. Если выплата на кошелек создана, а в ответе вернулся идентификатор выплаты (параметр id), то выплата считается успешной. Больше делать ничего не нужно.

Для метода нужно сформировать подпись с помощью обязательных параметров запроса: amount, amount_type, payee_account, payee_currency, shop_currency, shop_id и shop_payment_id. Сформированную подпись нужно передать в параметре 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"
       }'

Подробнее про выплаты на кошелек Feennex

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

Создание выплаты на кошелек [POST]

Request (application/json)
- Headers
- Attributes
  - amount: 1 (number, required) - Сумма получения или списания. Зависит от параметра amount_type
  - amount_type: receive_amount (string, required) - Определяет тип суммы. Возможные значения: receive_amount – сумма, которая поступит на ваш аккаунт с учетом всех комиссий. writeoff_amount - сумма, которая спишется с баланса магазина. Не включает в себя комиссию
  - payee_account: 201497141132 (string, required) - Аккаунт получателя денег в Feennex. Можно передать номер кошелька или email
  - payee_currency: 840 (string, required) - Валюта, в которой выплата поступит на аккаунт в Feennex. Возможные значения валют
  - shop_currency: 840 (number, required) - Валюта, в которой выплата спишется с вашего магазина. Возможные значения валют
  - shop_id: 1 (number, required) - Идентификатор вашего магазина, с которого осуществляется выплата
  - shop_payment_id (string, required) - Идентификатор выплаты на вашей стороне. Должен быть уникальным для каждой новой выплаты.
  - sign: cd30ba2b6e29f5 (string, required) - Подпись запроса
- Body
```
        {
            "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"
        }
```
Response 200 ()
- Body
```
        {
            "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
        }
```
- Attributes (object)
  - data (object, required) - Объект содержит данные о выплате
    - balance: 88.91 (number, required) - Баланс вашего магазина после выплаты
    - id (number, required) - Уникальный идентификатор выплаты
    - payee_account: 201497141132 (number, required) - Аккаунт получателя денег в системе Feennex. Можно передать номер кошелька или email
    - payee_currency: 840 (number, required) - Валюта, в которой выплата поступит на кошелек
    - shop: 112 (number, required) - Идентификатор магазина Feennex
    - shop_currency (number, required) - Валюта, в которой выплата спишется со счета вашего магазина
    - write_off_amount (number, required) - Сумма, которая спишется со счета магазина
  - error_code: 0 (number, required) - Код ошибки. Возможные значения кодов ошибок
  - message: Ok (string, required) - Описание ошибки. По значению этого параметра можно определить успешность запроса и узнать, что пошло не так
  - result: true (boolean, required) - Успешность запроса

Запрос статуса выплаты на кошелек transfer/shop_payment_status [/transfer/shop_payment_status]

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

Если в ответе возвращается id и данные по переводу, выплата создана и успешно проведена.
Если возвращается ошибка, что выплата не найдена, то нужно повторно создать выплату на кошелек.

Для метода нужно сформировать подпись с помощью обязательных параметров запроса: now, shop_id и shop_payment_id. Сформированную подпись нужно передать в параметре sign.

Нажмите на кнопку в конце описания метода, чтобы увидеть описание параметров запроса и ответа.

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

curl https://core.feennex.com/transfer/shop_payment_status \
   -H 'Content-Type: application/json' \
   -d '{
          "shop_id": 112, 
          "shop_payment_id": "55ac443d-958b-40e3-8956-e04e72561322", 
          "now": "2024-12-06 16:07:28.878200", 
          "sign": "e76c5ed9431d"
       }'

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

{
  "data": {
    "id": 3,
    "payee_currency": 840,
    "receive_amount": 1,
    "shop_currency": 840,
    "shop_payment_id": "55ac443d-958b-40e3-8956-e04e72561322",
    "write_off_amount": 1
  },
  "error_code": 0,
  "message": "Ok",
  "result": true
}

Пример ответа при ошибке

{ 
    "data": null, 
    "error_code": 7, 
    "message": "Transfer (shop_payment_id=test) wasn't found", 
    "result": false 
} 

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

Запросить статус выплаты на кошелек [POST]

Headers
Content-Type: application/json
Request (application/json)
- Attributes
  - now (string, required) - Дата и время, когда вы отправляете запрос. Формат: ISO 8601
  - shop_id: 1 (number, required) - Идентификатор вашего магазина, с которого осуществляется выплата
  - shop_payment_id (string, required) - Идентификатор выплаты на вашей стороне. Должен быть уникальным для каждой новой выплаты.
  - sign: cd30ba2b6e29f5 (string, required) - Подпись запроса
- Body
```
    { 
        "shop_id": 112, 
        "shop_payment_id": "55ac443d-958b-40e3-8956-e04e72561322", 
        "now": "2024-12-06 16:07:28.878200", 
        "sign": "e76c5ed9431d" 
    } 
```
Response 200 ()
- Body
```
    { 
        "data": 
            { 
                "id": 3, 
                "payee_currency": 840, 
                "receive_amount": 1, 
                "shop_currency": 840, 
                "shop_payment_id": "55ac443d-958b-40e3-8956-e04e72561322", 
                "write_off_amount": 1 
            }, 
            "error_code": 0, 
            "message": "Ok", 
            "result": true 
    }  
```
- Attributes (object)
  - data (object, required) - Объект содержит данные о выплате
    - id (number, required) - Идентификатор выплаты
    - payee_currency: 840 (number, required) - Валюта выплаты, которая поступит на ваш кошелек
    - receive_amount: 1 (number, required) – Сумма, которая поступит на ваш кошелек
    - shop_currency: 840 (number, required) - Валюта, в которой выплата спишется со счета вашего магазина
    - shop_payment_id (string, required) - Уникальный идентификатор платежа на стороне вашего магазина;
    - write_off_amount (number, required) - Сумма списания с магазина. ВАлюта этой суммы соответствует значению параметра shop_currency
  - error_code: 0 (number, required) - Код ошибки. Возможные значения кодов ошибок
  - message: Ok (string, required) - Описание ошибки. По значению этого параметра можно определить успешность запроса и узнать, что пошло не так
  - result: true (boolean, required) - Успешность запроса

Group Bыплата на кошелек Feennex​

Предварительный расчет выплаты на кошелек Feennex transfer/try [/transfer/try]​

POST Предварительный расчет выплаты [POST]​

Выплaта на кошелек Feennex transfer/create [/transfer/create]​

Создание выплаты на кошелек [POST]​

Запрос статуса выплаты на кошелек transfer/shop_payment_status [/transfer/shop_payment_status]​

Запросить статус выплаты на кошелек [POST]​

Group Bыплата на кошелек Feennex

Предварительный расчет выплаты на кошелек Feennex transfer/try [/transfer/try]

POST Предварительный расчет выплаты [POST]

Выплaта на кошелек Feennex transfer/create [/transfer/create]

Создание выплаты на кошелек [POST]

Запрос статуса выплаты на кошелек transfer/shop_payment_status [/transfer/shop_payment_status]

Запросить статус выплаты на кошелек [POST]