Skip to main content

Після оплати​

Повернення​

Повернення в Feennex залежать від способу оплати. Детальну інформацію вам надасть менеджер.

Неправильна сума оплати​

Зверніть увагу. Платник може перерахувати неправильну суму тільки при переказі на банківський рахунок.

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

В отриманому повідомленні та при запиті статусу платежу фактична сума, яку переказав платник, повертається в параметрі client_price. Початкова сума платежу – в параметрі shop_original_amount.

Ваші дії відрізняються залежно від того, чи достатньо платник переказав грошей для оплати, чи ні.

Недостатня оплата​

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

Переплата​

Вам потрібно самостійно домовитися з платником, як ви компенсуєте йому суму переплати.

Платник здійснив оплату переказом на банківський рахунок, але статус не змінюється​

Зверніть увагу. Тільки для способу оплати Переказ на банківський рахунок.

Якщо платник здійснив оплату переказів на банківський рахунок, але статус платежу не змінюється, платник повинен мати можливість надіслати чек з інформацією про переказ.

Ви можете самостійно реалізувати сторінку завантаження чека і надсилати в Feennex по API чек, який завантажив платник, або скористатися готовою формою для надсилання чека.

Крок 1. Реалізація сторінки завантаження чека​

Зверніть увагу! Якщо ви не хочете реалізовувати свою сторінку завантаження чека, переходьте до кроку 2.

На сторінці завантаження чека рекомендується попередити платника, що розмір зображення не повинен перевищувати 10 МБ, а на чеку має бути видно таку інформацію:

  • Час переказу
  • Відправник і одержувач переказу
  • Сума переказу

Приклад сторінки для завантаження чеків

Зверніть увагу! Для кожного платежу платник може надіслати тільки один чек. Підтримувані формати: JPEG, JPG, PNG, PDF, WebP, HEIF.

Крок 2. Запит статусу платежу​

Для роботи з чеками вам потрібно отримати значення параметра id – воно унікальне для кожного платежу. Щоб отримати значення цього параметра, запитайте статус платежу. У відповіді в об'єкті ps_data повертаються наступні параметри:

  • receipt_url – URL-адреса для завантаження чека по API
  • receipt_status_url – URL-адреса для перевірки статусу чека по API
  • receipt_web – URL-адреса для завантаження чека через форму. На цю адресу вам потрібно перенаправити платника, якщо ви не хочете реалізовувати форму завантаження чека.

Приклад параметра receipt_url

"receipt_url": "https://<baseURL>/api/v1/order/ade32e06-6fa4-425a-9c4c-e026ac6d93e6/receipt"

У цьому параметрі https://baseURL/api/v1/order/ – URL-адреса для відправлення запитів на завантаження чека. Рядок ade32e06-6fa4-425a-9c4c-e026ac6d93e6 – значення параметра id.

Тільки для тих, хто реалізував сторінку завантаження чека (крок 1).

За допомогою методу Відправлення чеків відправляйте в Feennex чек, який завантажив платник. Формувати підпис для цього методу не потрібно.

Адресу для відправлення запиту та значення параметра id ви отримали на кроці 2 в параметрі receipt_url.

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

curl -X POST \ 
--location 'https://<baseURL>/api/v1/order/ade32e06-6fa4-425a-9c4c-e026ac6d93e6/receipt' \
--form 'file=@"/home/cwm/Pictures/receipt.jpg"'

Якщо чек успішно відправлений, повертається відповідь з HTTP-кодом 200.

Приклад успішної відповіді

null

Після відправлення запиту технічна підтримка Feennex обробить переказ.

Щоб переконатися, що переказ пройшов, періодично надсилайте запити на отримання інформації про платіж

Крок 4. Відображення інформації про статус чека​

Зверніть увагу! Цей етап можна пропустити.

Ви можете запитувати актуальну інформацію про статус перевірки чека і відображати її на вашій платіжній сторінці. Для цього використовуйте метод Отримання статусу чека. Формувати підпис для цього методу не потрібно.

Для отримання статусу чека вам потрібна адреса для відправлення запиту і значення параметра id. Ці значення ви отримали на кроці 2 в параметрі receipt_ status_url.

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

curl -X GET \ 
--location 'https://<baseURL>/api/v1/order/ade32e06-6fa4-425a-9c4c-e026ac6d93e6/receipt/status' \

У відповіді повертається ідентифікатор чека, статус чека і коментар від технічної підтримки Feennex.

Приклад успішної відповіді

[
    {
        "id": "c9e35f42-62de-45c4-8092-152ba47d81e5",
        "status": "pending",
        "comment": null
    }
]

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

Неуспішна оплата​

У процесі оплати щось може піти не так. Наприклад, не вдається створити платіж або банк недоступний. Щоб ви могли краще розуміти, що сталося з платежем, Feennex повертає об'єкт платежу з параметром status.

За статусом ви можете визначити стан платежу і використовувати ці дані для аналізу та вирішення проблем, виведення повідомлень платнику та будь-яких інших цілей.

Детальніше про статуси при невдалих переказах

Реєстри​

Feennex формує реєстри успішних операцій, за допомогою яких ви можете звіряти розрахунки. До реєстрів входять такі операції:

  • Прийняті платежі
  • Проведені виплати
  • Службові операції

Feennex збирає відомості про всі операції за добу – з 00:00:00 до 23:59:59 за UTC+3. Ви можете запросити формування звіту за один день, тиждень або місяць.

В особистому кабінеті в розділі Історія ви можете самостійно генерувати реєстри для необхідних магазинів.

Якщо ви хочете періодично отримувати реєстри на електронну пошту, підпишіться на їх отримання.

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

Щоб Feennex надсилав повідомлення на електронну пошту, повідомте менеджеру наступну інформацію:

  • Електронна пошта одержувачів
  • Назви магазинів, для яких потрібно розсилати реєстри
  • Період, за який потрібно формувати реєстр – день, тиждень або місяць.

Формат файлу з реєстром – XSL. Якщо за вказану дату операцій не було, прийде порожній реєстр.

Поля в реєстрі​

Поле в реєстрі Опис
Дата Дата здійснення операції
ID операції Унікальний ідентифікатор платежу, виплати або системної операції
ID магазину Ідентифікатор вашого магазину в Feennex
Зараховано на магазин Фактична сума, зарахована у ваш магазин з урахуванням комісій. Тільки для платежів.
Списано з магазину Фактична сума, яка списана з вашого магазину при виплаті або службовій операції. Включає в себе комісію Feennex
Валюта Валюта платежу — значення параметра currency із запиту на створення платежу при оплаті гаманцем або shop_currency із запиту на створення платежу при оплаті іншими способами.

Можливі значення валют
Тип операції Тип виконуваної операції. Можливі значення: Платежі, Виплати, Службова
Сума рахунку Сума платежу — значення параметра amount із запиту на створення платежу при оплаті гаманцем або shop_amount із запиту на створення платежу при оплаті іншими способами
Валюта рахунку Валюта платіжного напрямку. Можливі значення валют
Сума отримання Сума платежу або виплати з урахуванням комісії. Тільки для виплат. Можливі значення валют
Валюта отримання Валюта напрямку на виплату. Тільки для виплат. Можливі значення валют
Номер замовлення Номер замовлення на вашій стороні
Опис Опис операції — значення параметра description із запиту на створення платежу при оплаті гаманцем і іншими способами
Баланс Поточний баланс вашого магазину після здійснення операції
Project ID Службовий параметр. Не використовується
Комісія Сума комісії платежу або виплати

Приклад реєстру​

"Дата" "ID операции" "ID магазина" "Зачислено на магазин" "Списано с магазина" "Валюта" "Тип операции" "Сумма счета" "Валюта счета" "Сумма получения" "Валюта получения" "Номер заказа" "Описание" "Баланс" "Project ID" "Комиссия"
2024-04-19 17:07:43 50000000 1234 282,94 840 Платежи 301 840 i171e2d956-d3b4-457d-a26a-52d960 i171e2d956-d3b4-457d-a26a-52d960 9393,74 18,06