Прийом платежів: гаманець Feennex

Group Прийом платежів: гаманець Feennex

Перед інтеграцією ознайомтеся з розділом Початок роботи з 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]