Для использования сервиса PayLate в розничных магазинах, необходимо провести интеграцию с Вашим кассовым решением.
Процесс покупки:
1. После выбора товара, кассир магазина пробивает предварительный чек, указав номер телефона клиента;
2. Клиент получает смс со ссылкой для прохождение регистрации в сервисе PayLate;
3. После прохождения регистрации клиент возвращается на кассу магазина и называет код для получения заказа;
4. Кассир находит предварительный чек, указывает код названный клиентом, подтверждает заказ, пробивает фискальный чек и отдает заказ клиенту.
Тестовые данные
Для тестирования интеграции сервисом paylate используйте следующие тестовые данные:
client_id – 1702082013
login – test
password – test
После проведения тестирования Вам будут выданы данные на рабочем сервере.
Формирование токена (PHP)
$login = "test"; // Логин Вашей организации в системе paylate
$password = "test"; // Пароль Вашей организации в системе paylate
$order_id = "235"; // Идентификатор заказа в вашей системе
$token = md5($login . md5($password) . $order_id); // Сформированный токен
Создание заказа и отправка смс со ссылкой на регистрацию
Данные должны быть переданы POST-запросом в формате JSON с заголовком content-type application/json
# | Параметр | Описание |
---|---|---|
1 | URL метода | https://paylate.ru/API/create_order |
2 | token | Токен, формируется как: md5(логин + md5(пароль) + номер_заказа) |
3 | order_id | идентификатор заказа в Вашей БД |
4 | goods | Массив товаров может содержать один или несколько товаров. Товар определяется следующей структурой:
|
5 | phone | 10 цифр номера телефона клиента |
6 | amount | Итоговая сумма товаров в чеке |
7 | initial_fee | Сумма первого взноса принимаемая в кассу магазина (необязательный параметр) |
8 | client_id | Идентификатор магазина в сервисе PayLate |
Пример запроса
{
"token": "",
"order_id": "PRSL-1288",
"goods": [
{
"name": "Товар1",
"count": 1,
"amount": 30000.96
},
{
"name": "Товар2",
"count": 1,
"amount": 5200
}
],
"phone": "9001231212",
"amount": 35200.96,
"initial_fee": 500.00,
"client_id": "1524072013"
}
Ответ
{"result":1, "message":""} //Заказ создан
{"result":0, "message":"текст ошибки"} //Ошибка
Проверка суммы заказа и первого взноса
Данный метод вызывается перед подтверждением заказа, в случае если магазин работает с первоначальным взносом оплачиваемым в кассу магазина.
В случае если магазин работает без первого взноса, реализация данного метода не требуется.
# | Параметр | Описание |
---|---|---|
1 | URL метода | https://paylate.ru/API/check_amount |
2 | token | Токен, формируется как: md5(логин + md5(пароль) + номер_заказа) |
3 | order_id | идентификатор заказа в Вашей БД |
4 | client_id | Идентификатор магазина в сервисе PayLate |
Пример запроса
{
"token":"",
"order_id": "PRSL-1288",
"client_id":"1524072013"
}
Ответ
//Успешный запрос, возвращается сумма заказа и сумма первого взноса
{
"result": 1,
"message": "",
"response": {
"amount_credit": "7217.0000",
"initial_fee": "1000.0000"
}
}
{"result":0, "message":"текст ошибки"} //Ошибка
Проверка актуальности заказа и подтверждение
# | Параметр | Описание |
---|---|---|
1 | URL метода | https://paylate.ru/API/approve_order |
2 | token | Токен, формируется как: md5(логин + md5(пароль) + номер_заказа) |
3 | client_id | Идентификатор магазина в сервисе PayLate |
4 | order_id | идентификатор заказа в Вашей БД |
5 | code | Код для получения заказа названный клиентом |
6 | amount | Итоговая сумма товаров в чеке |
7 | initial_fee | Сумма первого взноса принимаемая в кассу магазина (необязательный параметр) |
8 | is_check | При is_check = true производится проверка актуальности заказа, при отсутствии is_check, либо is_check = false — заказ подтверждается |
Пример запроса
{
"token": "",
"client_id": "1524072013",
"order_id": "PRSL-1288",
"amount": 35200.96,
"initial_fee": 500.00,
"code": 12345,
"is_check": true
}
Ответ
{"result":1, "message":""} //Заказ подтвержден
{"result":0, "message":"текст ошибки"} //Ошибка
Аннулирование заказа
Перед закртием кассовой смены должны быть аннулированы все отложенные за день чеки.
Отменить заказ возможно до отправки запроса на подтверждение с is_check = true
# | Параметр | Описание |
---|---|---|
1 | URL метода | https://paylate.ru/API/refuse_order |
2 | token | Токен, формируется как: md5(логин + md5(пароль) + номер_заказа) |
3 | client_id | Идентификатор магазина в сервисе PayLate |
4 | order_id | идентификатор заказа в Вашей БД |
6 | amount | Итоговая сумма товаров в чеке |
Пример запроса
{
"token": "",
"client_id": "1524072013",
"order_id": "PRSL-1288",
"amount": 35200.96
}
Ответ
{"result":1, "message":""} //Заказ аннулирован
{"result":0, "message":"текст ошибки"} //Ошибка