Developers

API and connection documentation

Рекуррентные платежи

Инициализация рекуррентного профиля

Для использования профиля рекуррентных платежей магазину следует инициализировать платеж обычным способом c передачей дополнительного параметра pg_recurring_start, обозначающий требование создания рекуррентного профиля. Номер профиля для повторения платежа будет передан при оповещении о результате платежа. Продавец может задать требуемый срок, в течение которого будет возможным использовать рекуррентный профиль (параметр является необязательным, и в случае, когда предприятие не передало, будет использован срок годности карты). Если предприятие задало pg_recurring_lifetime, больше чем срок годности карты, датой истечения годности рекуррентного профиля будет дата, до которой возможно использовать карту. В случае, когда продавцу нужен рекуррентный профиль без первоначального платежа, возможно задать сумму pg_amount = 0, в этом случае будет создан профиль для проведения повторных платежей.

Повторение рекуррентного платежа

Магазин может повторять платежи по рекуррентному профилю в любой момент по своему усмотрению, для этого необходимо выполнить запрос на http://www.paybox.money/make_recurring_payment.php, параметры передаются одним из методов прямого запроса. Максимальное время ожидания ответа – 30 секунд. Список параметров запроса:
Поле Значение по умолчанию Описание
pg_merchant_id Идентификатор продавца в PayBox. Выдается при подключении.
pg_order_id Идентификатор платежа в системе продавца. Рекомендуется поддерживать уникальность этого поля.
pg_recurring_profile Идентификатор рекуррентного профиля. Был получен продавцом при создании профиля рекуррентных платежей
pg_amount Значение первоначального платежа Сумма платежа в валюте pg_currency. Является необязательным параметром. В случае если не была передана сумма, в качестве суммы для повторения платежа, будет использовано значение первоначального платежа.
pg_result_url Из настроек магазина Check URL (string[256]) URL для сообщения о результате платежа. Вызывается после платежа в случае успеха или неудачи. Если параметр не указан, то берется из настроек магазина. Если параметр установлен равным пустой строке, то PayBox не сообщает магазину о результате платежа.
pg_refund_url Из настроек магазина Check URL (string[256]) URL для сообщения об отмене платежа. Вызывается после платежа в случае отмены платежа на стороне PayBoxа или ПС. Если параметр не указан, то берется из настроек магазина.
pg_request_method Из настроек магазина Check URL (string[4]) GET, POST или XML – метод вызовамагазина скриптов магазина Check URL, Result URL,Check URL Refund URL, Capture URL для передачи информации от платежного гейта.
pg_encoding UTF-8 Кодировка, в которой указаны другие поля запроса (только в случае использования методов GET или POST)
pg_description (string[1024]) Описание товара или услуги. Отображается покупателю в процессе платежа. Передается в кодировке pg_encoding.
Дополнительные параметры продавца Можно передавать произвольные дополнительные параметры, имена которых не начинаются на pg_. Все эти параметры будут переданы на pg_check_url, pg_result_url,pg_success_url, pg_failure_url. Имена дополнительных параметров продавца должны быть уникальны.
pg_salt Случайная строка
pg_sig Подпись

О результате платежа, PayBox оповестит продавца на Result URL


Пример GET запроса на создание транзакции по рекуррентному профилю:

http://paybox.money/make_recurring_payment.php?pg_merchant_id=82&pg_recurring_prof ile=109642&pg_description=example&pg_salt=my_salt&pg_sig=3fe59db16e24d78bfecfd8d 72324b83c

Ответ PayBox представляет собой XML вида:

my_salt ok 22241128 1 KZT 109642 2029-01-29 00:00:00 5b2ff43cfa1b7588e5844484f0843b11

Need a consultation?

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