Пoслe оплаты

Вoзвраты

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

Неверная сумма оплаты

Обратите внимание. Плательщик может перечислить неверную сумму только при переводе на банковский счет.

Если плательщик перевел неверную сумму, статус платежа меняется на recalculated – финальный и неизменяемый статус. Feennex отправляет вам [уведомление(#notifications) о смене статуса платежа на 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.

Шаг 3. Отправка чека в Feennex

Только для тех, кто реализовал страницу загрузки чека (шаг 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, это значит, что чек принят. После этого убедитесь, что перевод прошел – периодически отправляйте запросы на получение информации о платеже.

Неyспешная оплата

В процессе оплаты что-то может пойти не так. Например, не получается создать платеж или банк недоступен. Чтобы вы могли лучше понимать, что произошло с платежом, Feennex возвращает объект платежа с параметром status.

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

Подробнее про статусы при неуспешных переводах

Pеестры

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