API услуги - Элсом

ПОДКЛЮЧЕНИЕ К ЭЛСОМ

У вас есть сайт и вы хотели бы подключить Элсом? То наша компания сделает вам это в кратчайшие сроки!

Если у вас есть вопросы апо подключению впервые, пожалуйста обращайтесь по номерам на странице контакты или на сайте Элсом.

Стоимость подключения

1) 3000 сомов , если у вас агентский договор, где мы оформим вам стиль при оформлении заказа с вашим кодом.

2) от 20000 до 40000 сомов, если у вас биллерский, в зависимости от сложности

Подробная информация для тех кто хочет подключить самостоятельно, нуждается в дополнительной информации или для студентов в области веб программирования.

Сначала определимся какой у вас сайт. Обычный интернет магазин как у svetofor.kg или сайт с внутренним кошелком для личного кабинета, где будет пополнятся отдельный счет для каждого пользователя.В первом случае, указываете ваш код для пополнения при оформлении определенного товара .Во втором же все гораздо сложнее, тут нужно уже создать собственный Веб-сервис приемник а так же нужно будет подписать биллерский договор, доп тому что у вас есть или вместо агентского.

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

1. авторизация платежа (на вашей стороне проверяется л/счет, сумма, лимиты и др.)

2. проведение платежа. Они предоставят вам API документацию для партнеров, это документ описание приема платежей за товары и услуги.

Описание API документации:

1.  
   1. ЦЕЛЬ
   1. ОПИСАНИЕ СЕРВЕРНОГО ПРИЛОЖЕНИЯ.
   1. ТРЕБОВАНИЕ К СИСТЕМЕ ПАРТНЕРА
   1. ГЕНЕРАЦИЯ ОДНОРАЗОВОГО ПИНА.
   1. ОТМЕНА ПЛАТЕЖА.
   1. ЗАПРОС О СТАТУСЕ ПЛАТЕЖА
   1. ОПОВЕЩЕНИЕ ПАРТНЕРА О СТАТУСЕ ПЛАТЕЖА
   1. СТАТУСЫ ПЛАТЕЖЕЙ.
   1. КОДЫ ОШИБОК. 11

Система электронного кошелька предоставляет средства для интеграции с системой партнера, мерчанта и позволяет принимать платежи за услуги и товары. Для проведения платежей Партнер отправляет JSON объект, POST запросом в систему электронного кошелька и получает ответ в JSON формате. Для дополнительной аутентификации систему партнера используется пароль, выданный поставщиком услуг.

Цель:

Цель данного документа описать протокол взаимодействия между партнером и поставщиком услуг для покупки товаров и услуг.

Описание серверного приложения:

 Сервер: https://XX.XXX.X.XX:YYYY/MerchantAPI Метод отправки запроса: POST Заголовок: Content-Type: text/json; charset=utf-8 Тело: JSON Формат обмена данными: JSON (JavaScript Object Notation) Прием платежей за товары и услуги состоит из четырех шагов: 1. Партнер, Мерчант генерирует одноразовый ПИН код. Кассир или система Партнера оповещает клиенту OTP. 2. Клиент вводит OTP через приложение Элсом. И клиенту отображается данные по платежу. 3. Клиент подтверждает платеж ПИН кодом. 4. Элсом отправляет Партнеру запрос со статусом успешности платежа или Система партнера может запрашивать информацию о статусе успешности платежа.

Требование к системе Партнера:

 Система партнера может взаимодействовать с Элсом по нескольким алгоритмам: 1. Взаимодействие систем, по алгоритму запроса статуса транзакции в установленный промежуток времени (Рекомендуется установить паузу перед повторной отправкой запроса на статус)

Генерация одноразового ПИНа

Генерация уникального одноразового ПИН кода. Инициатор: система партнера.Запрос:

{ "PartnerGenerateOTP": { "CultureInfo": "ru-Ru", "MSISDN": "номер", "PartnerCode": "кодпартнера", "ChequeNo": "номер чека", "PartnerTrnID": "номер партнера", "Amount": "сумма", "CashierNo": "123кпримеру", "UDF": "TEST", "Password": "Password1" } }

№ Метка Обязательно Тип данных Описание 1 PartnerGenerate OTP M Имя метода JSON 2 CultureInfo M Varchar(10) Язык-Культура в стандарте RFC 4646 3 MSISDN M Varchar(10) Номер кошелька (10 знаков, начинается на 0) мерчанта/партнера 4 PartnerCode М Varchar(100) Код партнера, мерчанта. Обычно пятизначный код. 5 Password M Varchar(100) Пароль партнера, мерчанта. 6 ChequeNo O Varchar(100) Номер чека из системы мерчанта. Не обязательно. 7 PartnerTrnID M Varchar(20) Код транзакции из системы партнера/мерчанта 8 Amount M Varchar(30) Окончательная сумма оплаты к снятию с кошелька клиента (разделитель дробной точка) 9 CashierNo O Varchar(100) Код кассира. Не обязательно. 10 UDF O Varchar(100) Доп. поле для буд. использования

Ответ:

{ "Response": { "ErrorCode": "0", "ErrorMsg": "Success", "Result": { "OTP": "1234" } } }

№ Метка Обязательно Тип данных Описание 1 Response M Корневой элемент JSON 2 ErrorCode M Varchar(20) Код ошибки 3 ErrorMsg O Varchar (250) Текст ошибки 5 Result O Вложенный JSON объект. Содержит доп. Информацию. 6 OTP O Numeric(6) Одноразовый ПИН.

В общем все а таком же порядке и легче посмотреть в API документации.

Здесь так же можете посмотреть коды ошибок если вы у вас возникают проблемы после подключения:

00409 Summa men'she minimal'nogo znachenija, opredelennogo dlja etoj uslugi

8000 Vremja tranzakcii isteklo

00410 Summa bol'she maksimal'nogo znachenija, opredelennogo dlja etoj uslugi

00042 Zaprashivaemaja summa ne kratnaja razreshennogo znachenija.

5001 Pravilo perevoda ne opredeleno 00084 Stoimost' uslugi ne opredelena.

99999 Identichnaja tranzakcija uspeshno otklonena.

60019 Nedostatochno sredstv na balanse klienta ili terminala.

99046 Summa tranzakcii platel'shhika men'she opredelennogo znachenija.

60014 Maksimal'naja summa tranzakcij v den' dlja platel'shhika

0100006 Maksimal'noe obshhee kolichestvo tranzakcij v den' dlja platel'shhika dostignuto

00027 Blank requested amount 00028 Reqested amount not numeric

00029 Requested amount less then zero

00030 Requested amount less then allowed in the network 00031 Requested amount more then allowed in the network

00032 Genaral fail exception

00036 User is Blacklisted

00043 No slab found for requested amount

00075 You do not have permission for this request 00081 Insert amount or points

00317 Receiver is barred

00409 The transaction amount is less than the minimum value defined for this service

00410 The transaction amount is more than the maximum value defined for this service

00411 Authentication failed.

00641 Second MSISDN blank

00651 Second MSISDN Invalid length

00661 Second msisdn is not numeric

00671 Second MSISDN is not registered in Mobiquity network

0100005 Amount is greater than payee per txn amount

010022 Amount should be numeric.

01021 User is not allowed as a payee

01035 Transaction is temporarily unavailable. Please try again later. 1

1003 User Authentication Failed.

2000 This is a identical transaction

46068 Transaction is already Successful

46070 Transaction is Failed Already

60019 Insufficient balance for transaction.

60021 Maximum count of transaction per day for payee reached

60022 Maximum count of transaction per week for payee reached

60023 Maximum count of transaction per month for payee reached

60024 Maximum amount of transaction per day for payee reached

60025 Maximum amount of transaction per week for payee reached

60026 Maximum amount of transaction per month for payee reached

60027 Payee transaction amount less than defined value.

60028 Payee transaction amount more than defined value.

60029 Payee Residual minimum balance limit being crossed.Transaction failed.

60030 Payee maximum balance limit reached.

88852 No Accounts Found

90023 User Barred as sender

90025 User Barred as both

99040 User can not transfer from his wallet to same wallet

99051 Initiatee is invalid

 ИНФО:

JSON это текстовый формат обмена данными, основанный на JavaScript

Партнер это партнерские компании системы электронного кошелька Элсом.

OTP это Аббревиатура сокрашение от «One time password-Одноразовый пароль»

ПСП это Промежуточное серверное приложение - Элсом

Мерчант это (от англ. Merchant — купец, торговец, коммерсант) — принимающий платеж за товар или услугу.