ВАЖНО. Для переписки с технической службой системы Telcell по вопросам подключения обменных пунктов или автоматических платежных систем, для реестров проведенных операций и для генерации PGP ключа используйте e-mail адреса официального домена организации.
Если организация предполагает выступать в качестве обменного пункта электронных валют и одновременно пополнять счета клиентов системы Telcell, то в таком случае потребуется выпуск двух PGP ключей.
Запросы передаются по протоколу HTTPS на определяемый Telcell URL методом POST.
Предварительно, если это применимо, происходит обмен открытыми ключами и их регистрация в криптосистемах сторон.
В запрос входят переменные:
| Переменная | Описание | Примеры значений |
|---|---|---|
| CIPHER | Код криптосистемы, при помощи которой зашифровано сообщение | 3DES PGP |
| FROM | Идентификатор (e-mail) системы, отправившей сообщение | sender@domain.zone |
| TO | Идентификатор (e-mail) системы, которой предназначается сообщение | system@TellCell.ru |
| COMMAND | Команда: – RMT_EXECUTE – зачисление, платежи; | |
| MESSAGE | Тело зашифрованного сообщения, содержащего команды для обработки. Сначала сообщение шифруется, затем подписывается цифровой подписью. Шифрованные данные передаются в ASCII формате. См. Пример в приложении 1. |
Telcell проверяет ЭЦП (если применимо) отправителя сообщения и, если это допустимо, осуществляет расшифровку сообщения (MESSAGE), обработку команд, содержащихся в сообщении, после чего формирует ответ, осуществляет его шифрование и подписание своей ЭЦП (если применимо) и выдает его в виде ответа HTTPS-сервера. Ответ при этом передается в виде: 
00:OK\n ENCRYPTED_RESPONSE_MESSAGE_BODY\n
(“\n” в примере является символом «перевод-строки» в UNIX-формате).
Если при обработке запроса системой обнаружены ошибки, сообщение об этом также выдается в виде ответа HTTPS-сервера в виде:
01:ERROR_KEY_NOT_FOUND\n 02:ERROR_CANT_DECRYPT_MESSAGE\n 03:ACCESS_DENIED\n
и т.п.
В Приложении 5 приводится пример запрос в формате HTTP методом POST.
Пакет команд состоит из строк, разделенных символом “\n” («перевод-строки» в UNIX-формате). Каждая из строк содержит наименование и значение параметра, разделяемые символом «=», например:
параметр_1=значение_параметра_1\n
В наименование параметра могут входить латинские литеры, цифры и знак «подчеркивание». Регистр написания наименований параметров значения не имеет. В значение параметра могут входить любые символы. Окончанием значения параметра является символ “\n”, в само значение параметра не входящий (далее в примерах не показывается).
Состав параметров в пакете команд определяется собственно исполняемой командой. Ответ системы формируется также в виде пакета команд.
Состав пакета команд
command=deposit_check email=email клиента value=сумма currency=код валюты суммы filial=идентификатор филиала (см. Приложение 6)
Для формирования отложенного платежа, который будет исполнен после персонификации клиента-получателя, необходимо дополнительно передать в запросе параметры исходящей операции и данные для персонификации:
deferred=1 (признак отложенного платежа)
ocode=oCode оператора
code1=параметр платежа code1
code2=параметр платежа code2
code3=параметр платежа code3
snils=СНИЛС
inn=ИНН
doc_serial=серия документа, удостоверяющего личность
doc_number=номер документа, удостоверяющего личность
doc_issuer_code=код подразделения в формате NNN-NNN
doc_issuer=название подразделения
doc_issue_date=дата выдачи в формате YYYY-MM-DD
birthday=дата рождения в формате YYYY-MM-DD
Пример пакета команд:
command=deposit_check email=tech@telcellmoney.am value=100.00 currency=RUR filial=15
Пример положительного ответа системы:
command=deposit_check
email=tech@tellcelmoney.am
value=100.00
limit=14900.00
currency=RUR
filial=15
result=ACK
Пример отрицательного ответа системы
command=deposit_check
email=tech@telcellmoney.am
value=100.00
currency=RUR
filial=15
result=NAK
result_details=01:NOT_EXISTS
Если ответ системы положительный, значение параметра “result” устанавливается “ACK”. При отрицательном ответе параметр “result” будет содержать значение “NAK”, при этом также дополнительно может передаваться параметр “result_details”, содержащий описание причины отказа.
Значение limit в положительном ответе указывает на лимит пополнения для данного клиента.
Состав пакета команд:
command=deposit email=email клиента value=сумма currency=код валюты суммы description=назначение платежа client_transaction_id=ID транзакции, заказа и т.п. в системе клиента filial=идентификатор филиала (см. Приложение 6)
Внимание! Совпадение кодов client_transaction_id во время тестов и в рабочем режиме НЕ ДОПУСКАЕТСЯ!
Пример пакета команд:
command=deposit email=tech@telcellmoney.am value=100.00 currency=RUR description=Зачисление из системы ABC #0123456 client_transaction_id=12345 filial=15
Для формирования отложенного платежа, который будет исполнен после персонификации клиента-получателя, необходимо дополнительно передать в запросе параметры исходящей операции и данные для персонификации:
deferred=1 (признак отложенного платежа)
ocode=oCode оператора
code1=параметр платежа code1
code2=параметр платежа code2
code3=параметр платежа code3
snils=СНИЛС
inn=ИНН
doc_serial=серия документа, удостоверяющего личность
doc_number=номер документа, удостоверяющего личность
doc_issuer_code=код подразделения в формате NNN-NNN
doc_issuer=название подразделения
doc_issue_date=дата выдачи в формате YYYY-MM-DD
birthday=дата рождения в формате YYYY-MM-DD
Пример положительного ответа системы:
command=deposit
email=tech@telcellmoney.am
value=100.00
currency=RUR
transaction_id=54321
description=Зачисление из системы ABC #0123456
client_transaction_id=12345
filial=15
result=ACK
result_details=00009876
Пример отрицательного ответа системы:
command=deposit
email=tech@telcellmoney.am
value=100.00
currency=RUR
description=Зачисление из системы ABC #0123456
client_transaction_id=12345
filial=15
result=NAK
result_details=02:ACCOUNT_BLOCKED
Система передает ответ с параметром “result_details”. При положительном результате выполнения операции данный параметр содержит уникальный номер регистрации операции зачисления денежных средств на счет клиента Telcell или пустой. При отрицательном результате параметр “result_details” содержит код и описание причины невозможности исполнения операции.
Параметр “transaction_id” содержит уникальный номер операции зачисления денежных средств на счет клиента Telcell. При отрицательном ответе параметр “transaction_id” равен 0, пустой или вовсе отсутствует.
Передаваемые в пакетах ответов сообщения о промежуточных состояниях.
Ответы могут содержать сообщения об о промежуточных состояниях, передаваемые в параметре “result_details”. Сообщение о промежуточном состоянии состоит из кода ошибки, двоеточия и текстового значения данной промежуточного состояния.
Примеры сообщений о промежуточных состояниях:
| Код | Текстовое значение | Описание |
|---|---|---|
| 50 | TXN_REGISTERED | Операция зарегистрирована, выполняется. |
| 51 | TXN_NOT_COMPLETED | Операция выполняется, не завершена. |
| 52 | TXN_CANCELED | Операция отменена. |
| 53 | TXN_COMPLETED |
Рекомендация. Если получен ответ 53:TXN_COMPLETED, в ответе будет указан номер операции в системе Telcell, например transaction_id=123456789. Для получения более подробной информации об операции, необходимо выполнить команду
command=transaction_check email=email клиента или deposit_code для автоматического терминала (соответствует email пользователя в системе) transaction_id= ID пакета в системе client_transaction_id= ID транзакции, заказа и т.п. в системе клиента
указав полученный номер в параметре transaction_id. Наличие в ответе системы номера в параметре transaction_id говорит о том, что операция создана и выполнена (за исключением случаев, когда требуется подтверждение проведения операции со стороны оператора)
Пример запроса в формате протокола HTTP методом POST, который передается на сервер системы Telcell.
POST / HTTP/1.1 Host: www.telcellmoney.am Pragma: no-cache Accept: */* Content-Length: 1172 Content-Type: application/x-www-form-urlencoded COMMAND=RMT_EXECUTE&CIPHER=PGP&FROM=TellCell@wearerichmen.ru&TO=system@telcellmoney.am&MESSAGE=-----BEGIN%20PGP%20MESSAGE-----%0AVersion%3A%20GnuPG%20v1.4.1%20%28GNU%2FLinux%29%0A%0AhQIOA73oPz6ZkZXVEAf%2FRKZ%2FKfLBuDo6VYgi3GNl6WWWLRF89QIukx8iyRSyQZlK%0AXYOYsVU6BVQzsg1Nin7zey8kKwNZiulzA08JOlUpUuJ3tDfETpbIS9yBIMfnOsEf%0A4H30YpBhkaotXmgrYfw%2F1r3VY1wOh5019Xhxuw%2FHGIvBgGbYcYsJCGyhRixz1Skm%0ArkR1Jn8fSKrAqZWULX6YoPmUq%2ByNNAtQ1ojjicLopr4Mv8Ct44hh2uFhhcfYV9st%0AcZWOuE0l65D9RRsRQfuJsdUFjA7nTMzKx%2Bzbq4lUfa4aF9KzkiwAhW3vaZ4zUlxj%0AZaSZiZc9MfOCn9hz9wafizoE2f3wz%2Bt1jDZXqCAaxgf%2FW5eBZLoB21N5n8h1v9WQ%0AqZbZJhM%2F5RMpP3zf5M2R%2Flvv89FIlZUY7IPXw8%2FtVhFGOtcraTwA1YpsscliGy2k%0A3Pt%2B51bPSXfXirplw%2BgQ%2FZZdJcMUNgV5eS%2BkcQFd8vpUMv7h2lX%2Fsf5u4HOYYqDw%0A0CXRJQpGQvc807VpyOLBpSgc%2BlM9p%2Bw8wMQijY8DqqECI%2BPXlBOJ8PkNeuzdXjE3%0AU3h5hFdm0uIvr1lcq8R2KQcBKU3Eogy198W1MQa1rLbiRoLLz2NVqpJHL2sedVn3%0A%2BjowbuNj844mYTs598OV9v%2Brd0pwAIgULCY5VgTZiSSNIxkmaKRoDKycPzGfInAx%0AEsl1TQWjQ%2FaydQVkSga40o5nYmdq6krus5t4C00Dm8qxo9oT%2Bhlhbvyci2X7apKp%0AXNvvOiuk0wekNt6YrZpdgB863A2q65FYwqMQZ2yBygLnS7lvqAZXqXORqeHpPm44%0AclbEd74wg4KgtHO6ScGHUwAM22GFPQIG%0A%3DezWT%0A-----END%20PGP%20MESSAGE-----
Наш ключь.
----BEGIN PGP PUBLIC KEY BLOCK----- Version: GnuPG v2.0.19 (GNU/Linux) mQGiBEJRMk4RBACzhL5t8641CyMUnKc8rZY/FPNrRkaMaf30MVIJ5p8ZzgLDUNO5 DcYFj/rMO7whXJANA4Rd1LrrgJWISd0baY/ED5T/unCi26QGfKLssxLlGBrbRIOP N192JNHT2iDKK/AvkwTT+x/QYccWnW+iTWcIVBre59cRTwgKSiZ0uhMfNwCg/9iU 7AyZKB06qizOgw7eKMVxB+0D/i8LnNeC5b5gGxYPFJ/AqEpExBnY5XcWGdcvcKuM 6UF6DAy8O1bG5KZ3M9lAYJHU+tsf2XH5jeXXIdOktgQraT3SIo51wp/qEkhBlPEU oG6K8WowUbQKt0ZB28PJemXQnu6RdwB4U+2HnhxIkrhYbpZGFpmx22eoLCx3TEYg Mjd6BACVTztAck4H3nO/ZSoxp97eElRZTglL+m4ckuHZo6Hb3OaDGEEGPHqcZKeY v7DW/YMjA3i8JGMtqSHfQwS7HZq77Ys4ldQtLp9M4aGrKLiXncjBdshgNai1WBhV lsM9ugNiYuYtOUnRrDOLUU13/ZrdK41Y+FQOxQZTbSexDu2Q3rRBTW9uZXlNYWls IChNb25leU1haWwgPHN5c3RlbUBtb25leW1haWwucnU+KSA8c3lzdGVtQG1vbmV5 bWFpbC5ydT6IXgQTEQIAHgUCQlEyTgIbAwYLCQgHAwIDFQIDAxYCAQIeAQIXgAAK CRBd2pi+rYfpv6RWAJ9yJIUOQK/1EGW0mDAejYJQm6emowCgkIhV/89edEa8ODjL RGrk9RAVTcm5Ag0EQlEyXBAIAIyUzaW+NEWZFRSL8lJ+oDFj1cC0hrvdsRa8HTEU xGfnmMcNut8PLVS1zqBoccOr3mYvNCZda2ycsWhd8MftkEBvaOpDZCsQ7K8vxrDB b9n5iKzhFVc3JH63VjGEePjtV6pLKtjNOEDaQL07JfApu3sK6iMPbR6dGmS2U8Ve JHsbc7RajmYALzXpCUq9f4zXKAyKMTKp+s80LLltIzwT5VU8YF9Y+jETpAXIRFpd LGQqbREO6vfIYEmjUnXNX22CowJ4ivz/brH7VRFAFOoGyxT57boFydoCaaRVBKgc 52v+2iJxktJC5R+ZprjKb4DZWNLqe4XX2Rtp94tjrzeV2dsAAwUH/009y6OVuozF rXslKkzx3LzPexIfwFQOOGul4p89OS2EzyjFH2i/Ejjumeti+j2w/sFbzklgzfux BQV+JQL/kQHsrae5ERUwQGdgD21OutffbhxaP5rWYEbRiFIx+sdO+US6ps0UH/WZ IXuCsS+pg7N/yYsEr7WKJAIFmBRCrBZNtwwetLgfSnst3DG+3slgKk392AXZMd9s 826B1FDMci6sVHhJPrMYhYorVbUcZRHW20Me/ba/5WGXRM7pBCF3zm3m4/ZBPwp/ k6/ENWpf7QAQt3wjmDuGoATAGiZZJ7tWjLgHW+ycyfT3WrNnnQyI9uZEQ8nnHxLP WB7YMF5+qw+ISQQYEQIACQUCQlEyXAIbDAAKCRBd2pi+rYfpv+L+AJ4gCkqlkOpS khJUSqFD5EUJpF+2QQCeLGPIJJmfwVn61sxbnX7Z4Yti+C4= =gTkB -----END PGP PUBLIC KEY BLOCK-----
