Developers

API and connection documentation

Оповещение о возврате платежа (полном или частичном)

В случае полного или частичного возврата платежа на стороне PayBoxа или платежной системы платежный гейт вызывает скрипт магазина Refund URL с помощью метода Request Method. Запрос будет производиться в кодировке, установленной магазином при инициализации платежа, по умолчанию, utf-8. Гейт передает информацию о номере и свойствах заказа и ожидает ответа в течение 30 секунд. Если сервер продавца недоступен в момент вызова Refund URL (нет ответа более 30 секунд) или его ответ не удалось интерпретировать, PayBox будет предпринимать повторные попытки его вызвать в течение 2 часов.

Параметры вызова Refund URL

pg_order_id Идентификатор платежа в системе продавца
pg_payment_id Внутренний идентификатор платежа в системе paybox.money
pg_amount Сумма выставленного счета (в валюте pg_currency), совпадает с pg_amount в момент инициации платежа
pg_currency Валюта выставленного счета, совпадает с pg_currency в момент инициации платежа
pg_net_amount Сумма (в валюте pg_ps_currency), которая будет списана с магазина
pg_ps_full_amount Полная сумма (в валюте pg_ps_currency), которая будет возвращена покупателю
pg_ps_currency Валюта, в которой будет произведен возврат платежа в платежной системе
pg_payment_system Идентификатор платежной системы
pg_refund_date Дата и время совершения отмены платежа в формате YYYY- MM-DD HH:MM:SS
pg_refund_type Тип возврата: reversal – полный возврат до клиринга (для банковских карт),refund – полный или частичный возврат, moneyback – полный или частичный возврат средствами, отличными от средства платежа. Различать reversal и refund имеет смысл только для банковских карт. Reversal может произойти только до клиринга, refund только после клиринга.
pg_refund_system Система выплат, через которую произведен возврат. Имеет смысл только в случае pg_refund_type=moneyback. Возможные значения: CONTACT_O – выплата через систему денежных переводов Контакт MOBILEPHONE_O – зачисление денег на мобильный телефон.
pg_refund_id Уникальный идентификатор возврата для фильтрации повторных оповещений об одном и том же возврате. Для каждого типа возврата ведется свой ряд уникальных идентификаторов возврата.
Параметры продавца Все поля, переданные с веб-сайта продавца, не имеющие префикса "pg_"
pg_salt Случайная строка
pg_sig Подпись

Если был произведён возврат только части средств (например, частичный возврат по банковской карте), параметр pg_net_amount и pg_ps_full_amount содержат соответственно сумму, списанную с магазина и сумму, переданную на карту; pg_amount всегда содержит полную сумму счёта. Магазин должен быть готов к тому, что на один заказ может быть сделано несколько частичных возвратов.


Пример GET вызова магазина гейтом:

http://paybox.money/refund.php?pg_salt=gw41b38vc&pg_order_id=2614&pg_payment_id=825941&pg_payment_s ystem=CREDITCARD&pg_amount=100.00&pg_currency=KZT&pg_net_amount=100.00&pg_ps_currency=K ZT&pg_ps_full_amount=100.80&pg_refund_date=2009-09-30 15:32:30&pg_sig=afaef9d237932f56bd05c602d287df3a&uservar1=45363456

Пример xml вызова (POST с XML в параметре pg_xml) магазина гейтом:


gw41b38vc
2614
825941
CREDITCARD
100.00
100.00
KZT
KZT
100.00
2009-09-30 15:32:30
45363456
afaef9d237932f56bd05c602d287df3a

Получив сообщение об отмене платежа, магазин должен ответить с указанием статуса ok.


eyhfh42za22h
ok
ea362f52d23770986bd05c6fc5f9427d

Список параметров ответа магазина

Параметр Описание
pg_status ok – информация принята
error – ошибка в интерпретации данных
pg_error_description описание ошибки, в случае pg_status=error
pg_salt Случайная строка
pg_sig Подпись

Need a consultation?

Send an enquiry and our managers will contact you in 15 minutes.