Прием платежей: кошелек Feennex

Group Прием платежей: кошелек Feennex

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

Создание платежа с оплатой кошельком bill/create [/bill/create]

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

Если вы хотите принять оплату другими способами, создайте платеж с помощью метода Создание платежа

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

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

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

curl https://core.feennex.com/bill/create \
   -H 'Content-Type: application/json' \
   -d '{
          "description": "Оплата заказа", 
          "payer_currency": 840, 
          "shop_amount": "23.15", 
          "shop_currency": 840, 
          "shop_id": "3", 
          "shop_order_id": 4239, 
          "sign": "ad7fbe8df102b" 
       }'

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

{
    "data": null,
    "message": "invalid sign",
    "error_code": 1,
    "result": false
}

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

POST Создать платеж для оплаты кошельком [POST]

Request (application/json)
- Attributes
  - payer_currency: 840 (number, required) - Валюта, в которой проводит оплату плательщик. Эта валюта может отличаться от валюты магазина. Возможные значения валют
  - shop_amount: 23.15 (string, required) - Сумма платежа
  - shop_currency: 840 (number, required) - Валюта, в которой оплата зачисляется в ваш магазин. Возможные значения валют
  - shop_id: 3 (number, required) - Идентификатор вашего магазина в Feennex
  - shop_order_id: 123456789 (string, required) - Уникальный номер заказа в вашей системе. Не более 255 символов
  - sign: 32b2c32caa8ad (string, required) - Подпись запроса
  - description: Оплата заказа (string, optional) - Описание платежа. Не более 255 символов
  - payer_account: 1a2b3c (string, optional) - Аккаунт Feennex плательщика, который проводит оплату
  - lifetime: 43200 (number, optional) Время жизни платежа в минутах. Когда платеж будет просрочен, его статус поменяется на Expired. Если параметр не передавать, время жизни составит 43200 минут
  - failed_url: https://feennex.com/failed (string, optional) - URL-адрес, на который перенаправляется плательщик после неуспешной оплаты. Если хотите передавать URL-адрес в запросе, удалите значение соответствущий адрес из настроек магазина
  - success_url: https://feennex.com/success (string, optional) - URL-адрес, на который перенаправляется плательщик после успешной оплаты. Если хотите передавать URL-адрес в запросе, удалите значение соответствущий адрес из настроек магазина
  - callback_url (string, optional) - URL-адрес, на который отправляется уведомление об успешной оплате. Если хотите передавать URL-адрес в запросе, удалите значение соответствущий адрес из настроек магазина
  - callback_rejected_url (string, optional) - URL-адрес, на который отправляется уведомление о неуспешной оплате. Если хотите передавать URL-адрес в запросе, удалите значение соответствущий адрес из настроек магазина
- Body
```
        { 
            "description": "Оплата заказа", 
            "payer_currency": 840, 
            "shop_amount": "23.15", 
            "shop_currency": 840, 
            "shop_id": "3", 
            "shop_order_id": 4239, 
            "sign": "ad7fbe8df102b" 
        }
```
Response 200 (application/json)
- Headers
- Body
```
        {
            "data": {
                "created": "Wed, 10 Apr 2024 14:18:19 GMT",
                "id": 26,
                "lifetime": 43200,
                "payer_account": null,
                "payer_currency": 840,
                "payer_price": 500,
                "shop_amount": 500,
                "shop_currency": 840,
                "shop_id": 3,
                "shop_order_id": "4239",
                "shop_refund": 465,
                "url": "https://wallet.feennex.com/en/bill/pay/Waptm"
            },
            "error_code": 0,
            "message": "Ok",
            "result": true
        }
```
- Attributes (object)
  - data (object, required) - Объект содержит данные для оплаты
    - created: Wed, 10 Apr 2024 14:18:19 GMT (string, required) - Дата создания платежа. Формат: RFC 5322
    - id: 26 (number, required) - Уникальный идентификатор платежа в Feennex
    - lifetime: 43200 (number, required) - Время жизни платежа в минутах. Когда платеж будет просрочен, его статус поменяется на Expired. Значение по умолчанию – 43200 минут
    - payer_account: 1a2b3c (string, optional) - Аккаунт Feennex плательщика, который проводит оплату. Возвращается, если вы передавали этот параметр в запросе
    - payer_currency: 840 (number, required) - Валюта, в которой проводит оплату плательщик. Эта валюта может отличаться от валюты магазина. Возможные значения валют
    - payer_price: 23.15 (number, required) - Сумма, которую должен оплатить плательщик. Включает в себя комиссию Feennex
    - shop_amount: 10.0 (number, required) - Сумма платежа
    - shop_currency: 840 (number, required) - Валюта, в которой оплата зачисляется в ваш магазин. Возможные значения валют
    - shop_id: 3 (number, required) - Идентификатор вашего магазина в Feennex
    - shop_order_id: 101 (string, required) - Уникальный идентификатор заказа в вашей системе. Не более 255 символов
    - url: https://wallet.feennex.com/en/bill/pay/Waptm (string, required) - URL-адрес, на который вам нужно переотправить плательщика
  - error_code: 0 (number, required) - Код ошибки. Возможные значения кодов ошибок
  - message: Ok (string, required) - Описание ошибки. По значению этого параметра можно определить успешность запроса и узнать, что пошло не так
  - result: true (boolean, required) - Успешность запроса

Запрос статуса платежа при оплате кошельком bill/shop_order_status [/bill/shop_order_status]

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

Важно! Запрос статуса необходимо делать не чаще чем раз в 10 секунд.

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

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

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

curl https://core.feennex.com/bill/shop_order_status \
   -H 'Content-Type: application/json' \
   -d '{
          "now": "2024-05-01 16:56:25.009469", 
          "shop_id": "1092", 
          "shop_order_id": "234234232323",
          "sign": "ad7fbe8df102b" 
       }'

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

{
    "data": null,
    "message": "invalid sign",
    "error_code": 1,
    "result": false
}

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

POST Запросить статус платежа при оплате кошельком [POST]

Request (application/json)
- Attributes
  - now (string, required) - Дата и время, когда вы отправляете запрос. Формат: ISO 8601
  - shop_id: 1092 (number, required) - Идентификатор вашего магазина в Feennex
  - shop_order_id: 123456789 (string, required) - Уникальный номер заказа в вашей системе. Не более 255 символов
  - sign: 32b2c32caa8ad (string, required) - Подпись запроса
- Body
```
        { 
            "now": "2024-05-01 16:56:25.009469", 
            "shop_id": "1092", 
            "shop_order_id": "234234232323",
            "sign": "ad7fbe8df102b" 
        } 
```
Response 200 (application/json)
- Headers
- Body
```
        {
            "data": 
            {
              "client_price": 1.16, 
              "created": "2024-10-20 14:01:28", 
              "description": "Main account", 
              "is_unique": true, 
              "payment_id": 852095, 
              "payway": "feennex_usd", 
              "processed": "2024-10-20 14:01:33", 
              "ps_currency": 840, 
              "ps_data": {
                "ps_payer_account": "201538122124"
              }, 
              "shop_amount": 1.1, 
              "shop_currency": 840, 
              "shop_id": 1092, 
              "shop_order_id": "234234232323", 
              "shop_refund": 1.1, 
              "status": 2
            }, 
            "error_code": 0, 
            "message": "Ok", 
            "result": true
        }
```
- Attributes (object)
  - data (object, required) - Объект содержит данные о платеже
    - client_price: 1.16 (number, required) - Сумма, которую фактически перевел плательщик
    - created: 2024-10-20 14:01:28 (string, required) - Дата и время создания платежа. Формат: ISO 8601
    - is_unique (boolean, required) - Уникальность номера заказа на стороне вашего магазина. Если вы уже создавали платеж с таким номером заказа, возвращается false. В этом случае метод возвращает информацию о последнем созданном платеже с оплатой кошельком
    - payment_id: 852095 (number, required) - Идентификатор платежа на стороне Feennex
    - payway: feennex_usd (string, required) - Платежное направление
    - processed (string, required) - Дата проведения платежа. Формат: ISO 8601
    - ps_currency: 840 (number, required) - Валюта получения платежа в платежной системе
    - ps_data (object, required) - Дополнительная информация от платежной системы, например аккаунт плательщика ps_payer_account: 201538122124 (string, required) - Аккаунт плательщика в Feennex
    - shop_amount: 10.0 (number, required) - Сумма платежа
    - shop_currency: 840 (number, required) - Валюта, в которой платеж зачисляется в магазин
    - shop_id: 3 (number, required) - Идентификатор вашего магазина в Feennex
    - shop_order_id: 101 (string, required) - Уникальный номер заказа в вашей системе. Не более 255 символов
    - shop_refund: 1.1 (number, required) - сумма зачисления на баланс магазина, в валюте счета
    - status: 2 (number, required) - Статус платежа. Подробнее про статусы
    - description: Main account (string, optional) - Описание платежа. Не более 255 символов
  - error_code: 0 (number, required) - Код ошибки. Возможные значения кодов ошибок
  - message: Ok (string, required) - Описание ошибки. По значению этого параметра можно определить успешность запроса и узнать, что пошло не так
  - result: true (boolean, required) - Успешность запроса

Group Прием платежей: кошелек Feennex​

Создание платежа с оплатой кошельком bill/create [/bill/create]​

POST Создать платеж для оплаты кошельком [POST]​

Запрос статуса платежа при оплате кошельком bill/shop_order_status [/bill/shop_order_status]​

POST Запросить статус платежа при оплате кошельком [POST]​

Group Прием платежей: кошелек Feennex

Создание платежа с оплатой кошельком bill/create [/bill/create]

POST Создать платеж для оплаты кошельком [POST]

Запрос статуса платежа при оплате кошельком bill/shop_order_status [/bill/shop_order_status]

POST Запросить статус платежа при оплате кошельком [POST]