Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
ВЫСТАВЛЕНИЕ СЧЁТА
Запрос выставления счёта
Для выставления счета необходимо отправить 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 варианта:
Запрос обработался моментально. Ответ типа <Response> будет содержать структуру <CreateInvoiceResult> (синхронная обработка). ( Код операции - 0 )
Запрос был поставлен в очередь на обработку. Ответ типа <Response> будет содержать идентификатор операции, по которому можно запросить результат выполнения операции (асинхронная обработка). ( Код операции - 1 )
Ошибка обработки операции. Операция выполнена не будет. ( Код операции - 2 )
Пример запроса:
Code Block language powershell theme Confluence title sd 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
Post /merchant/createInvoice/ HTTP/1.1
Host: api.intellectmoney.ruContent-Type: application/x-www-form-urlencoded; charset=utf-8
eshopId=450123
orderId=test_order
recipientAmount=10.00
recipientCurrency=RUB
hash=dHA6Ly9jcmwuZ2xvYmFsc2lnbi5jb20v3MvZ3Nkb21haW52YWxzaGEyZzIuY3JsMIGПример ответа:
Code Block language xml theme Eclipse title fasdfasf linenumbers true 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>
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
Далее, к этой строке применяется алгоритм криптографии из пункта ФОРМИРОВАНИЕ КОНТРОЛЬНОЙ ПОДПИСИ
ПЕРЕДАЧА РЕКВИЗИТОВ БАНКОВСКОЙ КАРТЫ
Запрос регистрации реквизитов
Для передачи реквизитов банковской карты и для дальнейшей оплаты счета необходимо отправить GET- или POST-запрос на следующий адрес URL:
https://api.intellectmoney.ru/merchant/payInvoiceBankCard
В запросе необходимо передать следующие параметры:
Название
Имя параметра
Обязательный
Описание
ID магазина
eshopId
Да
Номер сайта интернет-магазина, на который пользователь (покупатель) должен совершить платеж.
Номер СКО
invoiceId
Да
СКО, в пользу которого производится попытка полаты, полученный операцией “ Запрос выставления счета ”
Номер карты плательщика
pan
Да
Номер карты плательщика
Дрежатель карты
cardHolder
Нет
Имя и фамилия плательщика карты
Срок действия месяц
expiredMonth
Да
Месяц, до которого действует карта
Срок действия год
expiredYear
Да
Год, до которого действует карта
CVV2/CVC2 код
cvv
Нет
CVV2 (CVC2) как правило написан на обороте карты (последние три цифры на полосе для подписи).
Максимальная длина - 512 символов.
Подпись для преданных данных
hash
Да
Контрольная подпись запроса, которая используется для проверки целостности полученной от магазина информации и однозначной идентификации отправителя.
Алгоритм формирования описан в разделе " Подпись запроса передачи данных карты ".
В ответ возвращается код операции и возможны 3 варианта:
Запрос обработался моментально. Ответ типа <Response> будет содержать структуру <PayInvoiceBankCardResult> (синхронная обработка). (Код операции - 0)
Запрос был поставлен в очередь на обработку. Ответ типа <Response> будет содержать идентификатор операции, по которому можно запросить результат выполнения операции (асинхронная обработка). (Код операции - 1)
Ошибка обработки операции. Операция выполнена не будет. (Код операции - 2)
Table of Contents | ||
---|---|---|
|