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






Подписка на платежи


Подписка на платежи по расписанию



Сервис предназначен для инициации оплаты за продолжение предоставления услуг по подписке. Данная возможность допустима для оплат, проводимых через процессинг UCS и ОАО «Банк «Санкт-Петербург».

Для инициации рекуррентного платежа необходимо в первоначальном запросе на авторизацию передать значение параметра RecurringIndicator=1 и значения параметров, задающих диапазон сумм последующих рекуррентных платежей, периодичность оплат (в днях) и дату окончания подписки.

Затем с указанной периодичностью предприятие инициирует платеж, задавая сумму, а необходимая платежная информация (данные кредитной карты) берется из первоначальной оплаты.
Для совершения следующего рекуррентного платежа необходимо отправить запрос на сервер АПК Ассист методом HTTP POST или SOAP (в кодировке UTF-8).


Параметры запроса:

Название

Обязатель-ное поле

Принимаемые значения

Значение по умолчанию

Описание

BillNumber

Да

15 или 16 цифр


BillNumber первого заказа

OrderNumber

Да

128 символов


Номер нового заказа для рекуррентного платежа

Merchant_ID

Да

Число


Идентификатор предприятия в АПК Ассист

Login

Да

8 - 20 символов 


Логин (лат. буквы и цифры, символ _)

Password

Да

8 - 20 символов 


Пароль (лат. буквы и цифры)

Amount

Да

Число, 15 цифр (разделители «.», «,»)

Сумма рекуррентного платежа


Currency

Да

3 символа

Валюта рекуррентного платежа

OrderComment

Нет

256 символов


Комментарий

Language

Нет

RU

EN

EN

Язык вывода результатов

Format

Нет

1 – CSV
2 – WDDX
3 – XML
4 - SOAP

1 для POST запроса,

4 для SOAP

Формат выдачи результатов


Параметры ответа:

Название

Значение

billnumber

Уникальный номер заказа в системе АПК Ассист, расширенный формат

ordernumber

Номер заказа

testmode

Тестовый режим

ordercomment

Комментарий

orderamount

Оригинальная сумма заказа

ordercurrency

Оригинальная валюта заказа

firstname

Имя плательщика

lastname

Фамилия плательщика

middlename

Отчество плательщика

Email

Email плательщика

orderdate

Дата заказа по Гринвичу (GMT)

orderstate

Статус заказа

packetdate

Дата формирования запроса по Гринвичу (GMT)

signature


operationtype

Тип операции

amount

Сумма операции

currency

Валюта операции

ipaddress

IP-адрес плательщика

meantypename

Тип платежного средства

meansubtype

Подтип платежного средства

meannumber

Номер платежного средства

cardholder

Держатель платежного средства

cardexpirationdate

Срок действия карты

issuebank

Название банка-эмитента

bankcountry

Страна банка-эмитента

rate

Курс валюты

responsecode

Код возврата

message

Сообщение о результате операции

customermessage

Сообщение о результате для покупателя

recommendation

Рекомендация

approvalcode

Код авторизации

protocoltypename

Протокол

processingname

Процессинг


Описание веб-сервиса:

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions name="recurrent" targetNamespace="http://www.paysecure.ru/ws/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:tns="http://www.paysecure.ru/ws/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
<wsdl:types>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://www.paysecure.ru/ws/">
<xsd:complexType name="RecurrentPayment">
<xsd:all>
	<xsd:element name="merchant_id" type="xsd:string" />
	<xsd:element name="ordernumber" type="xsd:string" />
	<xsd:element name="billnumber" type="xsd:string" />
	<xsd:element name="login" type="xsd:string" />
	<xsd:element name="password" type="xsd:string" />
	<xsd:element minOccurs="0" name="testmode" type="xsd:string" />
	<xsd:element minOccurs="0" name="language" type="xsd:string" />
	<xsd:element minOccurs="0" name="ordercomment" type="xsd:string" />
	<xsd:element name="amount" type="xsd:string" />
	<xsd:element name="currency" type="xsd:string" />
	<xsd:element minOccurs="0" name="generatereceipt" type="xsd:byte" length="1" />
	<xsd:element maxOccurs="unbounded" minOccurs="0" name="chequeitem" type="tns:chequeitem" />
	<xsd:element minOccurs="0" name="tax" type="xsd:string" />
	<xsd:element minOccurs="0" name="receiptline" type="xsd:string" />
	<xsd:element minOccurs="0" name="fpmode" type="xsd:string" />
</xsd:all>
</xsd:complexType>
<xsd:complexType name="Result">
<xsd:all>
	<xsd:element minOccurs="0" name="ordernumber" type="xsd:string" />
	<xsd:element minOccurs="0" name="billnumber" type="xsd:string" />
	<xsd:element minOccurs="0" name="testmode" type="xsd:string" />
	<xsd:element minOccurs="0" name="ordercomment" type="xsd:string" />
	<xsd:element minOccurs="0" name="orderamount" type="xsd:string" />
	<xsd:element minOccurs="0" name="ordercurrency" type="xsd:string" />
	<xsd:element minOccurs="0" name="firstname" type="xsd:string" />
	<xsd:element minOccurs="0" name="lastname" type="xsd:string" />
	<xsd:element minOccurs="0" name="middlename" type="xsd:string" />
	<xsd:element minOccurs="0" name="email" type="xsd:string" />
	<xsd:element minOccurs="0" name="orderdate" type="xsd:string" />
	<xsd:element minOccurs="0" name="orderstate" type="xsd:string" />
	<xsd:element minOccurs="0" name="operationtype" type="xsd:string" />
	<xsd:element minOccurs="0" name="amount" type="xsd:string" />
	<xsd:element minOccurs="0" name="currency" type="xsd:string" />
	<xsd:element minOccurs="0" name="rate" type="xsd:string" />
	<xsd:element minOccurs="0" name="ipaddress" type="xsd:string" />
	<xsd:element minOccurs="0" name="meantypename" type="xsd:string" />
	<xsd:element minOccurs="0" name="meansubtype" type="xsd:string" />
	<xsd:element minOccurs="0" name="meannumber" type="xsd:string" />
	<xsd:element minOccurs="0" name="cardholder" type="xsd:string" />
	<xsd:element minOccurs="0" name="cardexpirationdate" type="xsd:string" />
	<xsd:element minOccurs="0" name="issuebank" type="xsd:string" />
	<xsd:element minOccurs="0" name="bankcountry" type="xsd:string" />
	<xsd:element minOccurs="0" name="responsecode" type="xsd:string" />
	<xsd:element minOccurs="0" name="message" type="xsd:string" />
	<xsd:element minOccurs="0" name="customermessage" type="xsd:string" />
	<xsd:element minOccurs="0" name="recommendation" type="xsd:string" />
	<xsd:element minOccurs="0" name="approvalcode" type="xsd:string" />
	<xsd:element minOccurs="0" name="protocoltypename" type="xsd:string" />
	<xsd:element minOccurs="0" name="processingname" type="xsd:string" />
	<xsd:element minOccurs="0" name="packetdate" type="xsd:string" />
	<xsd:element minOccurs="0" name="signature" type="xsd:string" />
	<xsd:element minOccurs="0" name="pareq" type="xsd:string" />
	<xsd:element minOccurs="0" name="acsurl" type="xsd:string" />
</xsd:all>
</xsd:complexType>
<xsd:complexType name="chequeitem">
	<xsd:sequence>
		<xsd:element name="id" type="xsd:string" />
		<xsd:element name="product" minOccurs="0" type="xsd:string" />
		<xsd:element name="name" minOccurs="0" type="xsd:string" />
		<xsd:element name="price" type="xsd:string" />
		<xsd:element name="quantity" type="xsd:string" />
		<xsd:element name="tax" type="xsd:string" />
	</xsd:sequence>
</xsd:complexType>
</xsd:schema>
</wsdl:types>
<wsdl:message name="RecurrentPaymentRequest">
<wsdl:part name="payment" type="tns:RecurrentPayment">
</wsdl:part>
</wsdl:message>
<wsdl:message name="RecurrentPaymentResponse">
<wsdl:part name="return" type="tns:Result">
</wsdl:part>
</wsdl:message>
<wsdl:portType name="RecurrentPaymentPortType">
<wsdl:operation name="RecurrentPayment">
<wsdl:input message="tns:RecurrentPaymentRequest">
</wsdl:input>
<wsdl:output message="tns:RecurrentPaymentResponse">
</wsdl:output>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="RecurrentPaymentBinding" type="tns:RecurrentPaymentPortType">
<soap:binding style="rpc"
transport="http://schemas.xmlsoap.org/soap/http" />
<wsdl:operation name="RecurrentPayment">
<soap:operation soapAction="http://www.paysecure.ru/ws/RecurrentPayment"
style="rpc" />
<wsdl:input>
<soap:body use="literal" namespace="http://www.paysecure.ru/ws/" />
</wsdl:input>
<wsdl:output>
<soap:body use="literal" namespace="http://www.paysecure.ru/ws/" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="RecurrentPaymentService">
<wsdl:port name="recurrent" binding="tns:RecurrentPaymentBinding">
<soap:address location=""/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>