Для вызова методов API нужно придумать и задать свой секретный ключ в настройках магазина, на вкладке "Подключение магазина". Также, для авторизации, нужно получить Bearer токен с доп. ключом на странице Безопасность.
CreateInvoice - ВЫСТАВЛЕНИЕ СЧЁТА К ОПЛАТЕ
POST https://api.intellectmoney.ru/merchant/createInvoice
Заголовки:
Authorization: Bearer <ваш токен>
Sign: <хеш рассчитанный по шаблону ниже>
- Content-Type: application/json или application/x-www-form-urlencoded
- Accept: application/json или application/xml
eshopId::orderId::serviceName::recipientAmount::recipientCurrency::userName::email::successUrl::failUrl::backUrl::resultUrl::expireDate::holdMode::preference::signSecretKey
eshopId::orderId::serviceName::recipientAmount::recipientCurrency::userName::email::successUrl::failUrl::backUrl::resultUrl::expireDate::holdMode::preference::secretKey
| Имя параметра | Описание |
|---|---|
| eshopId Обязательный | ID магазина |
| orderId Обязательный | Уникальный идентификатор покупки из вашей системы. до 50 символов |
| recipientAmount Обязательный | Сумма платежа, разделенная точкой. Минимальное значение - 10.00.До 13 символов, до 2 цифр после точки. |
| recipientCurrency Обязательный | Валюта платежа. Допустимые значения - TST (тестовая валюта) - RUB - USD - EUR |
| email Обязательный | E-mail покупателя. До 100 символов. |
| hash Обязательный | Контрольная подпись запроса |
| serviceName | Назначение платежа - описание товара или услуги. До 1024 символов. |
| userName | Имя покупателя, До 255 символов. |
| successUrl | Адрес, на который происходит перенаправление плательщика с платежной страницы после успешной оплаты До 512 символов. |
| failUrl | Адрес, на который происходит перенаправление плательщика с платежной страницы в случае неуспешной оплаты До 512 символов. |
| backUrl | Адрес ссылки "Вернуться в магазин" на платежной странице До 512 символов. |
| resultUrl | Адрес, на который система IntellectMoney посылает HTTP/S POST запросы об изменении состояния cчёта До 512 символов. |
| expireDate | Срок существования счёта - дата и время, по достижению которых оплатить счёт станет невозможно. Формат: yyyy-MM-dd HH:mm:ss. |
| preference | Возможные способы оплаты счёта. Если не передавать, счет можно будет оплатить любым из подключенных способов. Допустимые значения - BankCard - YandexPay - Sbp Можно перечислить несколько значений через запятую, например "BankCard,YandexPay,Sbp". |
В этой таблице опущена часть параметров, например параметры связанные с холдированием, онлайн кассой, и рекаррингом. См. полный список параметров здесь: СЮДА НАДО ССЫЛКУ НА Merchant API
GetBankCardPaymentState - СОСТОЯНИЕ ПЛАТЕЖА
POST https://api.intellectmoney.ru/merchant/getbankcardpaymentstate
Authorization: Bearer <ваш токен> Sign: <хеш рассчитанный по шаблону ниже> Content-Type: application/json или application/x-www-form-urlencoded Accept: application/json или application/xml
eshopId::invoiceId::signSecretKey
eshopId::invoiceId::secretKey
Параметры
| Имя параметра | Описание |
|---|---|
| eshopId Обязательный | ID магазина, в котором был выставлен счёт |
| invoiceId Обязательный | Номер счёта |
| hash Обязательный | Контрольная подпись запроса |
Пример ответа
Чтобы получить ответ в формате JSON, нужно добавить в запрос заголовок Accept: application/json
{
"OperationState": {
"Code": 0,
"Desc": "Успешно обработана"
},
"EshopId": 465932,
"Result": {
"PaymentStep": "InProcess",
"State": {
"Code": 0,
"Desc": "Успешно обработан"
}
}
}
BankCardPayment - ОПЛАТА БАНКОВСКОЙ КАРТОЙ
POST https://api.intellectmoney.ru/merchant/bankcardpayment
Authorization: Bearer <ваш токен> Sign: <хеш рассчитанный по шаблону ниже> Content-Type: application/json или application/x-www-form-urlencoded Accept: application/json или application/xml
eshopId::invoiceId::pan::cardHolder::expiredMonth::expiredYear::cvv::returnUrl::ipAddress::signSecretKey
eshopId::invoiceId::pan::cardHolder::expiredMonth::expiredYear::cvv::returnUrl::ipAddress::secretKey
Используется для передачи реквизитов банковской карты и дальнейшей оплаты счета.
Для использования этого метода у вашей организации должна быть сертификация PCI DSS. Если у вас её нет, то оплату можно реализовать перенаправлением покупателя на нашу платежную страницу, либо внедрением нашего платежного виджета на сайт.
Параметры
| Имя параметра | Описание |
|---|---|
| eshopId Обязательный | ID магазина, где был выставлен счёт |
| invoiceId Обязательный | Номер счёта к оплате |
| ipAddress Обязательный | IP адрес сайта, с которого выставляется платеж. |
| returnUrl Обязательный | Адрес, на который перенаправляет плательщика после завершения 3DS. |
| cardHolder | Имя и фамилия с карты |
| pan Обязательный | Номер карты плательщика |
| cvv Обязательный для карт имеющих CVV2 (CVC2) | Секретный код CVV2 (CVC2), как правило написан на обороте карты (последние три цифры на полосе для подписи). Параметр не нужно передавать, если карта не имеет кода. |
| expiredYear Обязательный | Год, до которого действует карта |
| expiredMonth Обязательный | Месяц, до которого действует карта |
| hash Обязательный | Контрольная подпись запроса |
Пример ответа
Чтобы получить ответ в формате JSON, нужно добавить в запрос заголовок Accept: application/json
{
"OperationState": {
"Code": 0,
"Desc": "Успешно обработана"
},
"EshopId": 465932,
"Result": {
"State": {
"Code": 0,
"Desc": "Успешно обработан"
}
}
}