You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 43 Next »

ОБЩАЯ ИНФОРМАЦИЯ

Данное API позволит Вам выставить счёт, контролировать состояние счёта, отправлять пользователя (покупателя) на выбранный способ оплаты или получить необходимые данные для оплаты.

Все запросы необходимо передавать в кодировке UTF-8.

В ответ возвращается XML (по-умолчанию) или JSON. Что бы получить ответ как JSON надо передавать параметр "Accept: text/json".

ВЫСТАВЛЕНИЕ СЧЁТА

Запрос выставления счёта

Для выставления счета необходимо отправить GET- или POST-запрос на следующий адрес URL

https://api.intellectmoney.ru/merchant/createinvoice

В запросе необходимо передать следующие параметры:

 

НазваниеИмя параметраОбязательныйОписание

ID магазина

eshopId

Да

Номер сайта интернет-магазина, на который пользователь (покупатель) должен совершить платеж. Можно увидеть на странице   https://www.intellectmoney.ru/ru/enter/ps_organization_shop/ в столбце "ID"

Внутренний номер покупки интернет-магазина

orderId

Да

В этом поле интернет-магазин задает номер покупки в соответствии со своей системой учета. Уникальный номер для каждого платежа.

Максимальная длина - 50 символов.

Назначение платежа

serviceName

Нет

Описание товара или услуги. Формируется интернет-магазином.

Максимальная длина - 1024 символов.

Сумма

платежа

recipientAmount

Да

Сумма платежа, которую Интернет-магазин желает получить от пользователя (покупателя). Сумма должна быть больше нуля, дробная часть отделяется точкой, два знака после точки.

Максимальная длина - 13 цифр вместе с десятичными знаками.

Валюта

платежа

recipientCurrency

Да

Валюта платежа. Может принимать значения: RUB и RUR для  платежей в рублях и TST для тестовых платежей

Имя Пользователя

userName

Нет

Полное имя пользователя (покупателя). Вводится самим пользователем (покупателем).

Максимальная длина – 255 символов.

E-mail пользователя

email

Да

Email пользователя (покупателя).

Максимальная длина – 100 символов.

Адрес удачного платежа

successUrl

Нет

Адрес, на который будет перенаправлен пользователь (покупатель) в случае успешной оплаты

Максимальная длина - 512 символов.

Адрес не удачного платежаfailUrl

Нет

Адрес, на который будет перенаправлен пользователь (покупатель) в случае не успешной оплаты

Максимальная длина - 512 символов.

Адрес окончания платежаbackUrl

Нет

Адрес, на который будет перенаправлен пользователь (покупатель) при выборе не моментального способа оплаты

Максимальная длина - 512 символов.

АдресresultUrl

Нет

Адрес, на который система IntellectMoney посылает HTTP/S POST запросы об изменении состояния СКО

Максимальная длина - 512 символов.

Дата и время истечения срока блокировки

expireDate

Нет

Дата и время, через которое заблокированные средства зачислятся на счет магазина, либо будут возвращены пользователю (формат “yyyy-MM-dd HH:mm:ss”). Используется в случае использования блокировки (холдирования) средств на СКО.

Режим холдирования

holdMode

Нет

Устанавливает режим холдированного счета.
Boolean (1 или 0) 

Способ оплаты

preference

Нет

Способы оплаты, которые будут доступны для выбора при оплате покупки. В случае указания одного параметра пользователь будет перенаправлен на страницу ввода реквизитов. (при задании параметра  bankCard и указании email пользователя,  пользователь перейдет сразу к вводу номера банковской карты, при этом счёт уже будет создан. В случае, если не указан email ,то пользователь будет перенаправлен на страницу ввода email)

Подробное описание доступно по ссылке

Дополнительные параметры интернет-магазина

Определяется интернет-магазином

Нет

Все поля формы, имеющие в названии префикса "userField_N", "userFieldName_N" (где N порядковый номер), обрабатываются системой IntellectMoney автоматически и передаются на сайт интернет-магазина.

Максимальная длина всех дополнительных полей в сумме - 4000 символов

Подпись для преданных данных

hash

Да

Контрольная подпись запроса, которая используется для проверки целостности полученной от магазина информации и однозначной идентификации отправителя.

Алгоритм формирования описан в разделе " Подпись запроса выставления счета ".

В ответ возвращается  код операции и возможны 3 варианта:

  1. Запрос обработался моментально. Ответ типа  <Response> будет содержать структуру  <CreateInvoiceData> (синхронная обработка). ( Код операции - 0 )

  2. Запрос был поставлен в очередь на обработку. Ответ типа  <Response> будет содержать идентификатор операции, по которому можно запросить результат выполнения операции (асинхронная обработка). ( Код операции - 1 )

  3. Ошибка обработки операции. Операция выполнена не будет. ( Код операции - 2 )

Пример запроса
Post /merchant/createInvoice/  HTTP/1.1  
Host: api.intellectmoney.ru 
Content-Type: application/x-www-form-urlencoded; charset=utf-8

eshopId=450123
orderId=test_order
recipientAmount=10.00
recipientCurrency=RUB
hash=dHA6Ly9jcmwuZ2xvYmFsc2lnbi5jb20v3MvZ3Nkb21haW52YWxzaGEyZzIuY3JsMIG
Пример ответа
HTTP/1.1 200 OK
Content-Type: text/xml

<?xml version="1.0" encoding="utf-8"?>
<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<OperationState>
		<Code>0</Code>
 		<Desc>Успешно обработана</Desc>
   	</OperationState>
 	<OperationId>8f6a8487-98a6-4c03-b8b6-904cffd91749</OperationId>
   	<EshopId>700025</EshopId>
   	<Result>
     	<State>
 			<Code>0</Code>
       		<Desc>Успешно обработан</Desc>
     	</State>
     	<InvoiceId>3470488641</InvoiceId>
   	</Result>
</Response>

Подпись запроса выставления счёта

Строка для подписи получается путем конкатенации параметров с разделителем “::“ и формируется из следующих параметров в строгой последовательности:

Пример формирования строки
eshopId::orderId::serviceName::recipientAmount::recipientCurrency::userName::email::successUrl::failUrl::backUrl::resultUrl::expireDate::holdMode::preference

Далее, к этой строке применяется алгоритм криптографии из пункта   ФОРМИРОВАНИЕ КОНТРОЛЬНОЙ ПОДПИСИ

ПЕРЕДАЧА РЕКВИЗИТОВ БАНКОВСКОЙ КАРТЫ

Запрос регистрации реквизитов

Для передачи реквизитов банковской карты и для дальнейшей оплаты счета необходимо отправить GET- или POST-запрос на следующий адрес URL:

https://api.intellectmoney.ru/merchant/bankcardpayment

В запросе необходимо передать следующие параметры: 

Название

Имя параметра

Обязательный

Описание

ID магазина

eshopId

Да

Номер сайта интернет-магазина, на который пользователь (покупатель) должен совершить платеж.

Номер СКО

invoiceId

Да

СКО, в пользу которого производится попытка полаты, полученный операцией “ Запрос выставления счета

Номер карты плательщика

pan

Да

Номер карты плательщика

Дрежатель карты

cardHolder

Нет

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

Срок действия месяц

expiredMonth

Да

Месяц, до которого действует карта

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

expiredYear

Да

Год, до которого действует карта

CVV2/CVC2 код

cvv

Нет

CVV2 (CVC2) как правило написан на обороте карты (последние три цифры на полосе для подписи).

Максимальная длина - 512 символов.

Подпись для преданных данных

hash

Да

Контрольная подпись запроса, которая используется для проверки целостности полученной от магазина информации и однозначной идентификации отправителя.

Алгоритм формирования описан в разделе " Подпись запроса передачи данных карты ".

В ответ возвращается код операции и возможны 3 варианта:

  1. Запрос обработался моментально. Ответ типа <Response> будет содержать структуру <PayInvoiceBankCardData> (синхронная обработка). ( Код операции - 0 )
  2. Запрос был поставлен в очередь на обработку. Ответ типа <Response> будет содержать идентификатор операции, по которому можно запросить результат выполнения операции (асинхронная обработка). ( Код операции - 1 )
  3. Ошибка обработки операции. Операция выполнена не будет. ( Код операции - 2 )
Пример запроса
Post /merchant/createInvoice/ HTTP/1.1
Host: api.intellectmoney.ru
Content-Type: application/x-www-form-urlencoded; charset=utf-8

eshopId=450123
invoiceId=356421216
pan=55555555444444
cardHolder=DEFAULT CARDHOLDER
expiredMonth=10
expiredYear=19
cvv=123
hash=dHA6Ly9jcmwuZ2xvYmFsc2lnbi5jb20v3MvZ3Nkb21haW52YWxzaGEyZzIuY3JsMIG
Пример ответа
HTTP/1.1 200 OK
Content-Type: text/xml

<?xml version="1.0" encoding="utf-8"?>
<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<OperationState>
		<Code>0</Code>
		<Desc>Успешно обработана</Desc>
	</OperationState>
	<OperationId>8f6a8487-98a6-4c03-b8b6-904cffd91749</OperationId>
	<EshopId>700025</EshopId>
	<Result>
		<State>
			<Code>0</Code>
			<Desc>Успешно обработан</Desc>
		</State>
	</Result>
</Response>

Подпись запроса передачи данных карты

Строка для подписи получается путем конкатенации параметров с разделителем “::“ и формируется из следующих параметров в строгой последовательности:

Пример формирования строки
eshopId::invoiceId::pan::cardHolder::expiredMonth::expiredYear::cvv::returnUrl

Далее, к этой строке применяется алгоритм криптографии из пункта   ФОРМИРОВАНИЕ КОНТРОЛЬНОЙ ПОДПИСИ

СОСТОЯНИЕ ПЛАТЕЖА

Запрос состояния платежа

Для запроса состояния оплаты счета необходимо отправить GET- или POST-запрос на следующий адрес URL:

https://api.intellectmoney.ru/merchant/getbankcardpayment

В запросе необходимо передать следующие параметры:

 

Название

Имя параметра

Обязательный

Описание

ID магазина

eshopId

Да

Номер сайта интернет-магазина, на который пользователь (покупатель) должен совершить платеж.

Номер СКО

invoiceId

Да

СКО, в пользу которого производится попытка полаты, полученный операцией “ Запрос выставления счета

Подпись для преданных данных

hash

Да

Контрольная подпись запроса, которая используется для проверки целостности полученной от магазина информации и однозначной идентификации отправителя.

Алгоритм формирования описан в разделе " Подпись запроса состояния платежа ".

В ответ возвращается код операции и возможны 3 варианта:

  1. Запрос обработался моментально. Ответ типа <Response> будет содержать структуру <CheckInvoiceData> (синхронная обработка). ( Код операции - 0 )

  2. Запрос был поставлен в очередь на обработку. Ответ типа <Response> будет содержать идентификатор операции, по которому можно запросить результат выполнения операции (асинхронная обработка). ( Код операции - 1 )

  3. Ошибка обработки операции. Операция выполнена не будет. ( Код операции - 2 )

Пример запроса
Post /merchant/createInvoice/ HTTP/1.1
Host: api.intellectmoney.ru
Content-Type: application/x-www-form-urlencoded; charset=utf-8

eshopId=450123
invoiceId=356421216
activationAmount=8.14
hash=dHA6Ly9jcmwuZ2xvYmFsc2lnbi5jb20v3MvZ3Nkb21haW52YWxzaGEyZzIuY3JsMIG
Пример ответа
HTTP/1.1 200 OK
Content-Type: text/xml

<?xml version="1.0" encoding="utf-8"?>
<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<OperationState>
		<Code>0</Code>
		<Desc>Успешно обработана</Desc>
	</OperationState>
	<OperationId>8f6a8487-98a6-4c03-b8b6-904cffd91749</OperationId>
	<EshopId>700025</EshopId>
	<Result>
		<State>
			<Code>0</Code>
			<Desc>Успешно обработан</Desc>
		</State>
	</Result>
</Response>

Подпись запроса состояния платежа

Строка для подписи получается путем конкатенации параметров с разделителем “::“ и формируется из следующих параметров в строгой последовательности:

Пример формирования строки
eshopId::invoiceId

Далее, к этой строке применяется алгоритм криптографии из пункта   ФОРМИРОВАНИЕ КОНТРОЛЬНОЙ ПОДПИСИ

АКТИВАЦИОННЫЙ ПЛАТЁЖ

Передача параметров платежа

Для завершения активационного платежа необходимо отправить GET- или POST-запрос на следующий адрес URL:

https://api.intellectmoney.ru/merchant/activationpay

В запросе необходимо передать следующие параметры:

 

Название

Имя параметра

Обязательный

Описание

ID магазина

eshopId

Да

Номер сайта интернет-магазина, на который пользователь (покупатель) должен совершить платеж.

Номер СКО

invoiceId

Да

СКО, в пользу которого производится попытка полаты, полученный операцией “ Запрос выставления счета

Сумма активационного платежа

activationAmount

Да

Сумма, которая заблокирована у клиента на карте.

Сумму блокировки можно узнать в банке, либо из СМС, в случае если услуга поключена

CVV2/CVC2 код

cvv

Нет

CVV2 (CVC2) как правило написан на обороте карты (последние три цифры на полосе для подписи).

Подпись для преданных данных

hash

Да

Контрольная подпись запроса, которая используется для проверки целостности полученной от магазина информации и однозначной идентификации отправителя.

Алгоритм формирования описан в разделе " Подпись запроса активационного платежа ".

В ответ возвращается код операции и возможны 3 варианта:

  1. Запрос обработался моментально. Ответ типа <Response> будет содержать структуру <ActivationPayData> (синхронная обработка). ( Код операции - 0 )

  2. Запрос был поставлен в очередь на обработку. Ответ типа <Response> будет содержать идентификатор операции, по которому можно запросить результат выполнения операции (асинхронная обработка). ( Код операции - 1 )

  3. Ошибка обработки операции. Операция выполнена не будет. ( Код операции - 2 )

 

Пример запроса
Post /merchant/createInvoice/ HTTP/1.1
Host: api.intellectmoney.ru
Content-Type: application/x-www-form-urlencoded; charset=utf-8

eshopId=450123
invoiceId=356421216
activationAmount=8.14
hash=dHA6Ly9jcmwuZ2xvYmFsc2lnbi5jb20v3MvZ3Nkb21haW52YWxzaGEyZzIuY3JsMIG
Пример ответа
HTTP/1.1 200 OK
Content-Type: text/xml

<?xml version="1.0" encoding="utf-8"?>
<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<OperationState>
		<Code>0</Code>
		<Desc>Успешно обработана</Desc>
	</OperationState>
	<OperationId>8f6a8487-98a6-4c03-b8b6-904cffd91749</OperationId>
	<EshopId>700025</EshopId>
	<Result>
		<State>
			<Code>0</Code>
			<Desc>Успешно обработан</Desc>
		</State>
	</Result>
</Response>

Подпись запроса активационного платежа

Строка для подписи получается путем конкатенации параметров с разделителем “::“ и формируется из следующих параметров в строгой последовательности:

Пример формирования строки
eshopId::invoiceId::activationAmount::cvv

Далее, к этой строке применяется алгоритм криптографии из пункта     ФОРМИРОВАНИЕ КОНТРОЛЬНОЙ ПОДПИСИ

ЗАПРОС СПОСОБОВ ОПЛАТЫ

Передача параметров

Для завершения активационного платежа необходимо отправить GET- или POST-запрос на следующий адрес URL:

https://api.intellectmoney.ru/merchant/getpaymentways

В запросе необходимо передать следующие параметры:

 

Название

Имя параметра

Обязательный

Описание

ID магазина

eshopId

Да, если не передан invoiceId

Номер сайта интернет-магазина, на который пользователь (покупатель) должен совершить платеж.

Номер СКО

invoiceId

Да, если не передан eshopId

СКО, в пользу которого производится попытка полаты, полученный операцией “ Запрос выставления счета

Сумма платежа

amount

нет

Сумма платежа, которую Интернет-магазин желает получить от пользователя (покупателя). Сумма должна быть больше нуля, дробная часть отделяется точкой, два знака после точки.

Максимальная длина - 13 цифр вместе с десятичными знаками.

Способ оплаты

preferences

Нет

Способы оплаты, которые будут доступны для выбора при оплате покупки. В случае указания одного параметра пользователь будет перенаправлен на страницу ввода реквизитов. (при задании параметра  bankCard и указании email пользователя,  пользователь перейдет сразу к вводу номера банковской карты, при этом счёт уже будет создан. В случае, если не указан email ,то пользователь будет перенаправлен на страницу ввода email). Если передан пустым, то пользователю () будут показаны все способы доступные магазину.

Подробное описание доступно по ссылке

Подпись для преданных данных

hash

Да

Контрольная подпись запроса, которая используется для проверки целостности полученной от магазина информации и однозначной идентификации отправителя.

Алгоритм формирования описан в разделе " Подпись запроса активационного платежа ".

В ответ возвращается  код операции  и возможны 3 варианта:

  1. Запрос обработался моментально. Ответ типа  <Response> будет содержать структуру  <PaymentWayListData> (синхронная обработка). ( Код операции - 0 )

  2. Запрос был поставлен в очередь на обработку. Ответ типа  <Response> будет содержать идентификатор операции, по которому можно запросить результат выполнения операции (асинхронная обработка). ( Код операции - 1 )

  3. Ошибка обработки операции. Операция выполнена не будет. (  Код операции - 2  )

 

Пример запроса
Post /merchant/createInvoice/ HTTP/1.1
Host: api.intellectmoney.ru
Content-Type: application/x-www-form-urlencoded; charset=utf-8

eshopId=450123
invoiceId=356421216
activationAmount=8.14
hash=dHA6Ly9jcmwuZ2xvYmFsc2lnbi5jb20v3MvZ3Nkb21haW52YWxzaGEyZzIuY3JsMIG
Пример ответа
HTTP/1.1 200 OK
Content-Type: text/xml

<?xml version="1.0" encoding="utf-8"?>
<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <OperationState>
        <Code>0</Code>
        <Desc>Успешно обработана</Desc>
    </OperationState>
    <OperationId>3cf78bc5-63f4-4fe3-86a0-8ce9d60e8228</OperationId>
    <EshopId>455551</EshopId>
    <Result>
        <State>
            <Code>0</Code>
            <Desc>Успешно обработан</Desc>
        </State>
        <PaymentWays>
            <PaymentWayData>
                <Id>1</Id>
                <Amount>
                    <Amount>10.0000</Amount>
                    <Currency>TST</Currency>
                </Amount>
                <Preference>Inner</Preference>
                <InputType>InnerPayment</InputType>
                <PreferenceTypes>
                    <PreferenceTypeSpecification>All</PreferenceTypeSpecification>
                    <PreferenceTypeSpecification>Online</PreferenceTypeSpecification>
                    <PreferenceTypeSpecification>NonComission</PreferenceTypeSpecification>
                    <PreferenceTypeSpecification>Flash</PreferenceTypeSpecification>
                </PreferenceTypes>
                <ServiceTimeOfEnrollmentType>Flash</ServiceTimeOfEnrollmentType>
                <Commission>0</Commission>
            </PaymentWayData>
        </PaymentWays>
    </Result>
</Response>

Подпись запроса способов оплаты

Строка для подписи получается путем конкатенации параметров с разделителем “::“ и формируется из следующих параметров в строгой последовательности:

Пример формирования строки
eshopId::invoiceId::amount::preferences

Далее, к этой строке применяется алгоритм криптографии из пункта      ФОРМИРОВАНИЕ КОНТРОЛЬНОЙ ПОДПИСИ

ОПЛАТА ВНУТРЕННИМ ПЛАТЕЖОМ

Передача параметров

Для оплаты в системе IntellectMoney необходимо отправить GET- или POST-запрос на следующий адрес URL:

https://api.intellectmoney.ru/merchant/innerpayment

В запросе необходимо передать следующие параметры:

 

Название

Имя параметра

Обязательный

Описание

ID магазина

eshopId

Да

Номер сайта интернет-магазина, на который пользователь (покупатель) должен совершить платеж.

Номер СКО

invoiceId

Да

СКО, в пользу которого производится попытка полаты, полученный операцией “ Запрос выставления счета

Сумма платежа

userToken

Да

Цифровая подпись пользователя (покупателя).

Алгоритм получения userToken описан в разделе Как получить userToken

.Способ оплаты

pinCode

Нет

Код для подтверждения платёжных операций. Указывается пользователем (покупателем) при регистрации на сайте IntellectMoney.
Состоит из 4 цифр.

Подпись для преданных данных

hash

Да

Контрольная подпись запроса, которая используется для проверки целостности полученной от магазина информации и однозначной идентификации отправителя.

Алгоритм формирования описан в разделе " Подпись запроса активационного платежа ".

В ответ возвращается   код операции  и возможны 3 варианта:

  1. Запрос обработался моментально. Ответ типа  <Response> будет содержать структуру  <MerchantServiceData> (синхронная обработка). ( Код операции - 0 )

  2. Запрос был поставлен в очередь на обработку. Ответ типа  <Response> будет содержать идентификатор операции, по которому можно запросить результат выполнения операции (асинхронная обработка). ( Код операции - 1 )

  3. Ошибка обработки операции. Операция выполнена не будет. (  Код операции - 2  )

 

Пример запроса
Post /merchant/createInvoice/ HTTP/1.1
Host: api.intellectmoney.ru
Content-Type: application/x-www-form-urlencoded; charset=utf-8

eshopId=450123
invoiceId=356421216
userToken=BD2rQq%2Fh6P6tUEeSWLb5ur%2BIX3TIKckWjTKzmNwDoUI%3D
pinCode=4562
hash=dHA6Ly9jcmwuZ2xvYmFsc2lnbi5jb20v3MvZ3Nkb21haW52YWxzaGEyZzIuY3JsMIG
Пример ответа
HTTP/1.1 200 OK
Content-Type: text/xml

<?xml version="1.0" encoding="utf-8"?>
<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <OperationState>
        <Code>0</Code>
        <Desc>Успешно обработана</Desc>
    </OperationState>
    <OperationId>3cf78bc5-63f4-4fe3-86a0-8ce9d60e8228</OperationId>
    <EshopId>455551</EshopId>
    <Result>
		<State>
			<Code>0</Code>
			<Desc>Успешно обработан</Desc>
		</State>
	</Result>
</Response>

Подпись запроса способов оплаты

Строка для подписи получается путем конкатенации параметров с разделителем “::“ и формируется из следующих параметров в строгой последовательности:

Пример формирования строки
eshopId::invoiceId::userToken::pinCode

Далее, к этой строке применяется алгоритм криптографии из пункта      ФОРМИРОВАНИЕ КОНТРОЛЬНОЙ ПОДПИСИ

ПОЛУЧИТЬ БЛАНК ДЛЯ ОПЛАТЫ ПОЧТОВЫМ ПЕРЕВОДОМ

Передача параметров

Для получения бланка оплаты необходимо отправить GET- или POST-запрос на следующий адрес URL:

https://api.intellectmoney.ru/merchant/getpostpayblank

В запросе необходимо передать следующие параметры:

 

Название

Имя параметра

Обязательный

Описание

ID магазина

eshopId

Да

Номер сайта интернет-магазина, на который пользователь (покупатель) должен совершить платеж.

Номер СКО

invoiceId

Да

СКО, в пользу которого производится попытка оплаты, полученный операцией “ Запрос выставления счета

Сумма платежа

amount

Да

Сумма платежа, которую Интернет-магазин желает получить от пользователя (покупателя). Сумма должна быть больше нуля, дробная часть отделяется точкой, два знака после точки.

Максимальная длина - 13 цифр вместе с десятичными знаками.

Адрес

address

Нет

Указывается полностью без сокращений

Почтовый индексpostcodeНетПочтовый индекс
Имя покупателяfioНетФамилия Имя Отчество пользователя (покупателя). Указывается полностью без сокращений.
ИННinnНетИндивидуальный номер налогоплательщика (покупателя).
ГражданствоresidentofrussiaДаПередать 1, если пользователь (покупатель) является гражданином РФ.
Передать 0, пользователь (покупатель) не является гражданином РФ.
Серия

series

ДаСерия паспорта.
НомерnumberДаНомер паспорта.
День выдачи паспорта

day

Нет

 

 

Дата выдачи паспорта.

Месяц выдачи пасспортаmonthНет
Год выдачи пасспортаyearНет
Кем выданkemНетУправление выдавшее паспорт.
Если пользователь (покупатель) не резидент РФ, передаются данные о сроке пребывания.
ДеньbegindayНет


С какого числа начинает действовать.

 

МесяцbeginmonthНет
ГодbeginyearНет
ДеньenddayНет

 

Срок окончания.

МесяцendmonthНет
ГодendyearНет

Подпись для преданных данных

hash

Да

Контрольная подпись запроса, которая используется для проверки целостности полученной от магазина информации и однозначной идентификации отправителя.

Алгоритм формирования описан в разделе " Подпись запроса активационного платежа ".

В ответ возвращается   код операции  и возможны 3 варианта:

  1. Запрос обработался моментально. Ответ типа  <Response> будет содержать структуру  <PostPayBlankData> (синхронная обработка). ( Код операции - 0 )

  2. Запрос был поставлен в очередь на обработку. Ответ типа  <Response> будет содержать идентификатор операции, по которому можно запросить результат выполнения операции (асинхронная обработка). ( Код операции - 1 )

  3. Ошибка обработки операции. Операция выполнена не будет. (  Код операции - 2  )

 

Пример запроса
Post /merchant/createInvoice/ HTTP/1.1
Host: api.intellectmoney.ru
Content-Type: application/x-www-form-urlencoded; charset=utf-8

eshopId=450123
invoiceId=356421216
activationAmount=8.14
hash=dHA6Ly9jcmwuZ2xvYmFsc2lnbi5jb20v3MvZ3Nkb21haW52YWxzaGEyZzIuY3JsMIG
Пример ответа
HTTP/1.1 200 OK
Content-Type: text/xml

<?xml version="1.0" encoding="utf-8"?>
<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <OperationState>
        <Code>0</Code>
        <Desc>Успешно обработана</Desc>
    </OperationState>
    <OperationId>3cf78bc5-63f4-4fe3-86a0-8ce9d60e8228</OperationId>
    <EshopId>455551</EshopId>
    <Result>
        <State>
            <Code>0</Code>
            <Desc>Успешно обработан</Desc>
        </State>
        <PostPayBlank>
            iVBORw0KGgoAAAANSUhEUgAABHQAAASkCAI...
        </PostPayBlank>
    </Result>
</Response>

Подпись для оплаты почтовым переводом

Строка для подписи получается путем конкатенации параметров с разделителем “::“ и формируется из следующих параметров в строгой последовательности:

Пример формирования строки
eshopId::invoiceId::amount::address::postcode::fio::inn::residentofrussia::series::number::day::month::year::kem::beginday::beginmonth::beginyear::endday::endmonth::endyear

Далее, к этой строке применяется алгоритм криптографии из пункта  ФОРМИРОВАНИЕ КОНТРОЛЬНОЙ ПОДПИСИ

ОПЛАТА ЧЕРЕЗ ОБМЕННИКИ

Альфа-Клик

Для оплаты через Альфа-Клик необходимо отправить GET- или POST-запрос на следующий адрес URL:

https://api.intellectmoney.ru/merchant/alfaclickpayment

Сбербанк Онлайн

Для оплаты через Сбербанк Онлайн необходимо отправить GET- или POST-запрос на следующий адрес URL:

https://api.intellectmoney.ru/merchant/sberbankpayment

Яндекс.Деньги

Для оплаты через Яндекс.Деньги необходимо отправить GET- или POST-запрос на следующий адрес URL:

https://api.intellectmoney.ru/merchant/yandexpayment

WebMoney

Для оплаты через Yandex.Money необходимо отправить GET- или POST-запрос на следующий адрес URL:

https://api.intellectmoney.ru/merchant/wmrpayment

QIWI Кошелёк

Для оплаты через QIWI Кошелёк необходимо отправить GET- или POST-запрос на следующий адрес URL:

https://api.intellectmoney.ru/merchant/qiwipursepayment

В запросе необходимо передать следующие параметры из таблицы 

 

Название

Имя параметра

Обязательный

Методы, в которых используется

Описание

ID магазина

eshopId

Да

Во всех

Номер сайта интернет-магазина, на который пользователь (покупатель) должен совершить платеж.

Номер СКО

invoiceId

Да

Во всех

СКО, в пользу которого производится попытка оплаты, полученный операцией “ Запрос выставления счета

Адрес удачного платежа

successUrlНетalfaclickpayment, wmrpayment, qiwipursepayment

Адрес, на который будет перенаправлен пользователь (покупатель) в случае успешной оплаты


Адрес не удачного платежаfailUrlНетwmrpayment, qiwipursepayment

Адрес, на который будет перенаправлен пользователь (покупатель) в случае успешной оплаты


Дополнительные параметрыadditionalParamsНетqiwipursepaymentДополнительные параметры.Строка вида "to=+39106231449|from=+569323442", где "|" - разделитель между параметрами, а "=" разделитель в паре ключ-значение.

Подпись для преданных данных

hash

Да

Во всех

Контрольная подпись запроса, которая используется для проверки целостности полученной от магазина информации и однозначной идентификации отправителя.

Алгоритм формирования описан в разделе " Подпись запроса активационного платежа ".

В ответ возвращается   код операции  и возможны 3 варианта:

  1. Запрос обработался моментально. Ответ типа  <Response> будет содержать структуру  <PostPayBlankData> (синхронная обработка). ( Код операции - 0 )

  2. Запрос был поставлен в очередь на обработку. Ответ типа  <Response> будет содержать идентификатор операции, по которому можно запросить результат выполнения операции (асинхронная обработка). ( Код операции - 1 )

  3. Ошибка обработки операции. Операция выполнена не будет. (  Код операции - 2  )

 

Пример запроса
Post /merchant/createInvoice/ HTTP/1.1
Host: api.intellectmoney.ru
Content-Type: application/x-www-form-urlencoded; charset=utf-8

eshopId=450123
invoiceId=356421216
successUrl=http://Ваш_сайт/successUrl.php
failUrl=http://Ваш_сайт/failUrl.php
additionalParams=to=+791085488
hash=dHA6Ly9jcmwuZ2xvYmFsc2lnbi5jb20v3MvZ3Nkb21haW52YWxzaGEyZzIuY3JsMIG
Пример ответа
HTTP/1.1 200 OK
Content-Type: text/xml

<?xml version="1.0" encoding="utf-8"?>
<Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <OperationState>
        <Code>0</Code>
        <Desc>Успешно обработана</Desc>
    </OperationState>
    <OperationId>3cf78bc5-63f4-4fe3-86a0-8ce9d60e8228</OperationId>
    <EshopId>455551</EshopId>
    <Result>
        <State>
            <Code>0</Code>
            <Desc>Успешно обработан</Desc>
        </State>
        <PostPayBlank>
            iVBORw0KGgoAAAANSUhEUgAABHQAAASkCAI...
        </PostPayBlank>
    </Result>
</Response>

Подпись для оплаты через обменники

Строка для подписи получается путем конкатенации параметров с разделителем “::“ и формируется из следующих параметров в строгой последовательности:

Пример формирования строки
eshopId::invoiceId::successUrl::failUrl::additionalParams

Далее, к этой строке применяется алгоритм криптографии из пункта  ФОРМИРОВАНИЕ КОНТРОЛЬНОЙ ПОДПИСИ

АСИНХРОННЫЕ ОПЕРАЦИИ

Для получения результата по операциям, обработка по которым была поставленна в очередь необходимо отправить GET- или POST-запрос на URL по целевым методам, добавив в окончание адреса “State”:

https://api.intellectmoney.ru/merchant/createinvoicestate

https://api.intellectmoney.ru/merchant/bankcardpaymentstate

https://api.intellectmoney.ru/merchant/getbankcardpaymentstate

https://api.intellectmoney.ru/merchant/activationpaystate

https://api.intellectmoney.ru/merchant/getpurchaseinfostate

https://api.intellectmoney.ru/merchant/getpaymentwaysstate

В запросе к любому методу необходимо передать следующие параметры:

 

Название

Имя параметра

Обязательный

Описание

ID магазина

eshopId

Да

Номер сайта интернет-магазина, на который пользователь (покупатель) должен совершить платеж.

Операция

operationId

Да

Идентификатор операции

Подпись для преданных данных

hash

Да

Контрольная подпись запроса, которая используется для проверки целостности полученной от магазина информации и однозначной идентификации отправителя.

Алгоритм формирования описан в разделе " Подпись запроса статуса асинхронной операции ".

В ответ возвращается код операции и возможны 3 варианта:

  1. Запрос обработался. Ответ типа <Response> будет содержать структуру одного из методов. ( Код операции - 0 )

  2. Запрос еще находится в очереди на обработку. Нужно запросить статус позже. ( Код операции - 1 )

  3. Ошибка обработки операции. Операция выполнена не будет. ( Код операции - 2 )

Подпись запроса статуса асинхронной операции

Строка для подписи получается путем конкатенации параметров с разделителем “::“ и формируется из следующих параметров в строгой последовательности:

 

Пример формирования строки
eshopId::operationId

Далее, к этой строке применяется алгоритм криптографии из пункта   ФОРМИРОВАНИЕ КОНТРОЛЬНОЙ ПОДПИСИ

ИНТЕРФЕЙС УВЕДОМЛЕНИЙ ПРОВАЙДЕРА

В протоколе предусмотрена стандартная возможность получения провайдером уведомлений о статусе платежа. Если в настройках магазина в личном кабинете IntellectMoney выбран протокол IntellectMoney, то данные передаются в соответствии с п.3.2.2. Форма оповещения о платеже протокола IntellectMoney . Если в настройках магазина в личном кабинете IntellectMoney выбран протокол WebMoney, то данные передаются в соответствии с п.3.3.3. Форма оповещения о платеже протокола WebMoney . Какой протокол указан можно посмотреть на странице https://intellectmoney.ru/ru/enter/options/ps_organization_shop/ в столбце “Протокол“.

ФОРМИРОВАНИЕ КОНТРОЛЬНОЙ ПОДПИСИ

К строке для подписи (сформированной по правилам формирования подписи отдельного метода) в конец добавляется параметр “Секретный ключ ( secretKey )” из настроек магазина ЛК IntellectMoney через разделитель “::“, после чего к итоговой строке применяется хеш-функция MD5, результат работы который считается подписью запроса.

КАК ПОЛУЧИТЬ userToken

Для получения userToken нужно перенаправить пользователя (покупателя) на страницу https://intellectmoney.ru/ru/enter/ с параметрами:

ПараметрОписание
returnUrlURL куда перенаправить пользователя (покупателя) после регистрации
emailemail пользователя (покупателя)

Пример:https://intellectmoney.ru/ru/enter/?returnUrl=https://Ваш_сайт.ru/returnUrl.php&email=Почта_покупателя%40mail.ru 

После того, как пользователь (покупатель) авторизуется, он будет перенаправлен на страницу указанную в returnUrl с параметром UserToken.

Пример:https://Ваш_сайт.ru/returnUrl.php?&userToken=5a8WAwjuOb5g7P5VGdmxSt2ogNCysC7UirnQDmWFNP4%3D 

ТИПЫ ДАННЫХ

<Response>

 

Поле

Тип

Описание

OperationState

<OperationState>

Статус выполнения операции

OperationId

GUID

Идентификатор операции

EshopId

int

ID магазина

Result

MethodResult

Результат выполнения запроса. Зависит от типа запроса. В случае асинхронной обработки запроса данного поля не будет.

<OperationState>

 

Поле

Тип

Описание

Code

int

Код статуса выполнения операции

Desc

string

Описание кода статуса выполнения запроса

<CreateInvoiceData>

 

Поле

Тип

Описание

State

<RequestState>

Статусы выполнения запросов

InvoiceId

long

Номер выставленного СКО

<PayInvoiceBankCardData>

 

Поле

Тип

Описание

State

<RequestState>

Статусы выполнения запросов  

<CheckInvoiceData>

 

Поле

Тип

Описание

State

<RequestState>

Статусы выполнения запросов

PaymentStep

<PaymentStep>

Статусы платежа

Message

text

Текстовое представление последнего статуса операции в банке (RC)

Form3DS

text

Обыно это html, выданный эмитентом для прохождения процедуры прохождения 3ds

<ActivationPayData>

 

Поле

Тип

Описание

State

<RequestState>

Статусы выполнения запросов

<PaymentWayListData>
ПолеТипОписание
State<RequestStata>  Статусы выполнения запросов
PaymentWays<PaymentWayData>  Описание возвращаемых параметров
<PaymentWayData>
ПолеТипОписание
IdintУникальный идентификатор способа оплаты
Amount<Money>

Статусы выполнения запросов

InputType<InputType>Способы оплаты
PreferenceTypes<PreferenceTypeSpecification>1
ServiceTimeOfEnrollmentType<MerchantServiceTimeOfEnrollmentType>Сроки зачисления
Commissiondecimal 
<Money>

<MerchantServiceData>

Поле

Тип

Описание

State

<RequestState>

Статусы выполнения запросов

<PostPayBlankData>
ПолеТипОписание
State<RequestStata>  Статусы выполнения запросов
PostPayBlankТекст

Возвращает строку для вставки в html. Пример обработки данной строки, где {$PostPayBlank} результат запроса:

Пример кода
<img class="printed__img" src="data:image/png;base64,{$PostPayBlank}">
<script>
    var PostPayBlank = "data:image/png;base64,{$PostPayBlank}";
</script>

<ExchangerData>

Поле

Тип

Описание

State

<RequestState>

Статусы выполнения запросов

ExchangerData<ExchangerPaymentData>Информация о способе оплаты
<ExchangerPaymentData>

Поле

Тип

Описание

ExchangeCurrency

Текст

Способ оплаты

ExchangeAmountТекстСумма оплаты 
RedirectToUrlСсылкаАдрес, куда отправлять запрос
ExchangeStateТекстСостояние способа оплаты.
OK - способ работает
ERROR - способ не работает
IsNewWindowТекст

Если true, отображение в новом окне.

Если false, отображается в ом же окне

FormFields  
ShowFields  
Method  

ПЕРЕЧИСЛЕНИЯ

Коды операций

 

Код ошибки

Описание

0

Успешно обработана

1

В процессе выполнения

2

Ошибка

Статусы запросов

 

Код ошибки

Описание

0

Успешно обработан

1

Ошибка сервера

2

Не защищенное соединение. Отправляйте запрос по https

50

Ошибка. Счет уже был оплачен ранее

150Ошибка. Параметр eshopId передан неверно
151Ошибка. Параметр invoiceId передан неверно
152Ошибка. Обязательно должен быть передан либо eshopId либо invoiceId
153Ошибка. Параметр inputType передан неверно
154Ошибка. Не передан обязательный параметр hash или передан неверно
155Ошибка. Не передан обязательный параметр amount или передан неверно
156Ошибка. Параметр preferences передан неверно
157Ошибка. Не передан обязательный параметр recipientAmount или передан неверно
158Ошибка. Не передан обязательный параметр recipientCurrency или передан неверно
159Ошибка. Не передан обязательный параметр email или передан неверно
160Ошибка. Параметр serviceName передан неверно
161Ошибка. Не передан обязательный параметр userName или передан неверно
162Ошибка. Параметр successUrl передан неверно
163Ошибка. Параметр failUrl передан неверно
164Ошибка. Параметр backUrl передан неверно
165Ошибка. Параметр resultUrl передан неверно
166Ошибка. Параметр returnUrl передан неверно
167Ошибка. Параметр expireDate передан неверно
168Ошибка. Параметр holdMode передан неверно
169Ошибка. Параметр(ы) userFields передан(ы) неверно
170Ошибка. Не передан обязательный параметр orderId или передан неверно
200Ошибка. Не передан обязательный параметр pinCode или передан неверно
201Ошибка. Не передан обязательный параметр userToken или передан неверно
202Ошибка. Данный счет не принадлежит владельцу кошелька IntellectMoney
203Ошибка. В кошельке IntellectMoney нет подходящего счета с нужной валютой
204Ошибка. Для проведения оплаты необходимо пройти идентификацию в личном кабинете IntellectMoney
205Ошибка. Превышен лимит на оплату для кошелька IntellectMoney
250Ошибка. Не передан обязательный параметр pan или передан неверно.
251Ошибка. Не передан обязательный параметр cvv или передан неверно
252Ошибка. Не передан обязательный параметр cardHolder или передан неверно
253Ошибка. Не передан обязательный параметр expiredYear или передан неверно
254Ошибка. Не передан обязательный параметр expiredMonth или передан неверно
255Ошибка. Не передан обязательный параметр activationAmount или передан неверно
256Ошибка. Карта плательщика заблокирована.
257Ошибка. Счет в неверном статусе. Оплата не возможна.
258Ошибка. Есть не завершенные платежи. Дождитесь обработки.
259Ошибка. Платеж запрещен.
300Ошибка. Неверно передан параметр Pparameter.
301Ошибка. Неверно передан параметр inn.
302Ошибка. Неверно передан параметр residentofrussia.
303Ошибка. Неверно передан параметр series.
304Ошибка. Неверно передан параметр number.

Статусы платежа

 

Код ошибки

Описание

0

Успешно завершен (Счет оплачен)

1

Создан

2

В обработке

3

Отправлен на 3DS

4

Отправлен на активационный платеж

10

Ошибка платежа

 

Группы способов оплаты

 

Название группы

Описание

AllВсе
PopularПопулярные
OnlineОнлайн
NonComissionБез комиссии
FlashМгновенные

Сроки зачисления

Название

Описание

NoneДо 30 рабочих дней
FlashМгновенно
FiveDaysДо 5 рабочих дней
ThreeDaysДо 3 рабочих дней


Способы оплаты

InputTypeОписание

InnerPayment

Внутренний перевод
AcquiringОплата с банковской карты
BankRFБанковский перевод
WMRWebMoney
YandexЯндекс.Деньги
QiwiPurseQIWI Кошелёк
AlfaClickPayUАльфа-Клик
IBankИнтернет банкинг

Bankomats

В банкоматах
TerminalsВ терминалах
RapidaOnlineRapidaOnline
GoogleADSGoogleADS
PostPayЧерез почту РФ
MvideoMvideo
QBankQBank через Rapida
SberBankСбербанк Онлайн
AlfaClickАльфаКлик
EurosetВ салонах Евросеть
SvyaznoyВ салонах Связной

 


  • No labels