Добро пожаловать в ImconPay!

Наша платежная платформа позволяет подключить на ваш веб-сайт прием платежей с пластиковых карт в интернете в виде готовой платежной формы по API. С нами вы можете организовать прием платежей в интернете быстро и гибко так, как это нужно именно вам. Мы создаем продукт, который удобен не только для бизнеса, но и для разработчиков.

Взаимодействие с API

Запуск процесса оплаты посредством сервиса Imcon Pay со стороны мерчанта состоит из двух этапов:

  • Первый этап, запрос на получение подписи заказа который потребуется для дальнейшего шага.
  • Второй этап, формирование платежной ссылки и перенаправление клиента в данную ссылку.

В личном кабинете мерчанта в Мерчант > Интеграция Магазина находиться информация по ключам для взаимодействия с сервисом Imcon Pay. Ниже предоставлена таблица с наименованием данных ключей.

Имя Описание
Client Code Код мерчанта в системе
Client Api Key Секретный ключ мерчанта
Root Api Key Секретный ключ сервиса Imcon Pay

Запрос на получение подписи заказа

Данный шаг рекомендуется соверщать в закрытой части (бэкэнд) приложения мерчанта. Чтобы отправить запрос на сервис Imcon Pay для получения подписи заказа, сначала требуется формировать hash который будет отправляться в числе параметров запроса. Перечень параметров запроса отображен в нижеследующей таблице. Параметр hash это захешериваное значение по алгоритму SHA256 текстовой строки которая составляется конкатенацией некоторых параметров. Ниже показано которые параметры конкатенируются.

order_id + amount + ClientApiKey

Далее отправляем POST запрос с параметрами перечисленнемы в таблице.

POST https://pay.imcon.tj/api/pay/createQuote

Атрибут/Параметр Тип данных Описание Обяз.
client_code String Код мерчанта в системе да
order_id String Идентификатор заказа да
amount Number(8, 2) Стоимость покупки (заказа), разделитель точка да
item_url String Ссылка на продукт да
hash String Рассчитанный хэш да

При успешном запросе предоставляется ответ от сервиса Imcon Pay в данном ввиде.

    {
        "status": true,
        "signature": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
    }

Перенаправление на платежный шлюз

В указанных в примере местах вместо фигурных скобок надо подставить параметры. Параметры указаны в таблице.

Атрибут/Параметр Тип данных Описание Обяз.
signature String Подпись заказа да
order_id String Идентификатор заказа да
client_code String Код мерчанта в системе да

Пример:

GET https://pay.imcon.tj/pay/gateway/{signature}/{order_id}/{client_code}


Ответ от сервиса ImconPay

Во время регистрации со стороны мерчанта предоставляется url для success и fail. При успешном прохождение операции сервис ImconPay отправляет запрос на предоставлений success url, в ином случае запрос отправляется на fail url. С сервиса отправляется запрос ввида ниже. Signature формируется в стороне сервиса и подставляется в ответе, мерчант должен будет формировать signature заново и сверить с signature из ответа. Signature формируется следующим образом


{client_code} + & + {order_id} + & + {amount} + & + {item_url} + & + {root_api_key}


Это объединённая сторока url кодируется, после получившийся результат хэшируется по алгоритму SHA256.

Атрибут/Параметр Тип данных Описание Обяз.
signature String Подпись ответа да
order_id String Идентификатор заказа да
successUrl String Success ссылка на сайте мерчанта да
failUrl String Fail ссылка на сайте мерчанта да
status Bool Статус прохождения заказа да

Пример:

GET {successUrl/failUrl}?success={status}&order_id={order_id}&signature={signature}