PayDala Terminal

При работе с запросами на проверку существования лицевого счета пользователя необходимо учитывать следующее:

1. Запрос verify для проверки существования лицевого счета пользователя отправляется платежной платформой на URL-адрес веб-сервиса методом POST.
2. Запрос содержит следующие обязательные параметры:
   • type — тип операции на стороне веб-сервиса, значение параметра всегда verify;
   • customer_id — имя учетной записи пользователя в сервисе мерчанта, которое пользователь вводит на терминале;
   • project_id — идентификатор проекта, полученный от JetPay при интеграции;
   • signature — подпись запроса (подробнее — в разделе Использование подписи к данным).

   Рис.: Пример данных из запроса на проверку существования лицевого счета пользователя

   {
       "type": "verify",   
       "customer_id": "7123456789",
       "project_id": 1234,
       "signature": "e19695449545fac562843ca06e7e0f3e51281ad6"
   }

3. Ответ на запрос verify должен быть отправлен синхронно и содержать следующие обязательные параметры:
   • code — код ответа на запрос;
   • currency — код валюты платежа в формате ISO-4217 alpha-3, обязателен при использовании кода ответа 0.

   Табл. 1. Допустимые коды ответов

   Код	Описание
   0	Операция успешна
   400	Ошибка подписи
   404	Лицевой счет пользователя не существует
   500	Общая ошибка, причина должна быть описана в параметре message

   Ответ может содержать следующие необязательные параметры:

   • additional_customer_id — идентификатор пользователя, уникальный в рамках проекта, который используется для идентификации пользователя в платежной платформе JetPay;
   • message — произвольное описание кода ответа.

   В случае успеха проверки наличия лицевого счета ответ должен содержать код 0 ответа на запрос и код валюты платежа.

   Рис.: Пример ответа на запрос

   {
       "code": 0,
       "currency": "KZT",
       "additional_customer_id": "customer_123"
   }

   Если запрос нельзя корректно обработать или не удалось обнаружить запрошенный лицевой счет, ответ на запрос должен содержать код ответа 404, а также может содержать дополнительную информацию об ошибке в параметре message.

   Рис.: Пример ответа с кодом ошибки

   { 
       "code": 404,
       "message": "Account does not exist"
   }

При работе с запросами на получение идентификатора платежа на стороне веб-сервиса необходимо учитывать следующее:

1. Запрос check_deposit для получения идентификатора платежа на стороне веб-сервиса отправляется методом POST на заданный URL веб-сервиса.
2. Запрос содержит следующие обязательные параметры:
   • type — тип операции на стороне веб-сервиса, значение параметра всегда check_deposit;
   • customer_id — идентификатор учетной записи пользователя в системе мерчанта;
   • project_id — идентификатор проекта, полученный от JetPay при интеграции;
   • amount — сумма оплаты в дробных единицах валюты без десятичной точки и пробелов за исключением случаев, когда у валюты нет дробной части. Если у валюты нет дробных единиц (то есть количество разрядов дробных единиц равно нулю), то в этом параметре нужно указывать сумму в основных единицах валюты. Подробнее о разрядах дробных единиц у валют см. Коды валют;
   • currency — код валюты платежа в формате ISO-4217 alpha-3;
   • payment_method — идентификатор платежной группы, значение параметра всегда terminal/paydala;
   • signature — подпись запроса (подробнее — в разделе Использование подписи к данным).

   Рис.: Пример запроса идентификатора платежа на стороне веб-сервиса

   {
       "type": "check_deposit",
       "project_id": 1234,
       "customer_id": "7123456789",
       "amount": 100000,
       "currency": "KZT",
       "payment_method": "terminal/paydala",
       "signature": "lY0LTSAzpR7...dOqRXJnL1kO0lUmkQ0YYLWRg=="
   }

3. Ответ на запрос check_deposit должен отправляться синхронно и содержать следующие обязательные параметры:
   • code — код ответа на запрос;
   • payment_id — уникальный идентификатор платежа на стороне веб-сервиса, обязателен при использовании кода ответа 0.

   Табл. 2. Допустимые коды ответов

   Код	Описание
   0	Операция успешна
   400	Ошибка подписи
   404	Лицевой счет пользователя не существует
   500	Общая ошибка, причина должна быть описана в параметре message

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

   • message — произвольное описание кода ответа;
   • description — описание платежа.

   Ответ на запрос получения идентификатора платежа на стороне веб-сервиса должен содержать код ответа на запрос и уникальный идентификатор платежа на стороне веб-сервиса.

   Рис.: Пример ответа с идентификатором платежа

   {
       "code": 0,
       "payment_id": "payment_47",
       "description": "Success"
   }

   Ответ c информацией об ошибке должен содержать код ответа на запрос и сообщение об ошибке.

   Рис.: Пример ответа с информацией об ошибке

   {
       "code": 500,
       "message": "Something went wrong"
   }