Оповещение скрипта при создании счета
Вы можете подключить оповещение вашей системы сразу при формировании заказа, до его оплаты.
Для этого при редактировании товара в поле «URL для оповещений по API об оформленном счете» укажите адрес вашего скрипта, на который наш сервис будет отправлять уведомления.
Уведомления на этот адрес отправляются после создания заказа. При его оплате уведомления отправляются на адрес указанный в поле «URL для оповещений по API об оплаченном счете» (подробнее).
Вы можете указать в обоих полях один и то же скрипт, но при этом добавив параметр определяющий, что это за оповещение.
Например, так:
- поле «URL для оповещений по API об оформленном счете»:
https://mysite.ru/script?a=make - поле «URL для оповещений по API об оплаченном счете»:
https://mysite.ru/script?a=paid
Либо определять сделанный заказ по отсутствию в полученных данных значения с ключом [‘paid’]
Уведомления отправляются в формате URL-encoded POST в таком виде:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 |
array( 'status' => 'new_order', 'id' => номер заказа 'first_name' => имя клиента 'last_name' => фамилия клиента 'middle_name' => отчество клиента 'email' => мейл клиента 'phone' => телефон клиента 'city' => город доставки 'country' => страна доставки 'address' => адрес доставки 'region' => регион доставки 'postalcode' => почтовый индекс 'created' => время создания заказа 'comment' => комментарий к заказу, 'tag' => тэг, 'kupon' => использованный купон, 'domain' => домен заказа, 'link' => ссылка на страницу оплаты заказа,, 'roistat_visit' => значение cookie roistat id. Если значения нет - параметр не передается., 'utm' => array ( 'medium' => утм-параметр канал 'source' => утм-параметр источник 'campaign' => утм-параметр кампания 'content' => утм-параметр объявление 'term' => утм-параметр ключ ), 'items' => array( //массив товаров array( 'id' => символьный идентификатор 'title' => название товара 'sum' => стоимость товара по факту (с учетом апсселла или скидки) 'price' => стоимость товара из настроек ), array( 'id' => символьный идентификатор 'title' => название товара 'sum' => стоимость товара по факту (с учетом апсселла или скидки) 'price' => стоимость товара из настроек ), ... ) 'hash' => md5(номер заказа + мейл клиента + время создания заказа + секретный ключ) ) |
Пример на PHP:
1 |
$hash = md5($_REQUEST['id'].$_REQUEST['email'].$_REQUEST['paid'].$setts['user_rps_key']); |
Где «секретный ключ» для формирования подписи это строка, которую можно найти в разделе «API» (справа внизу личного кабинета Expertam)=> «Ключ API»
Например, если для разработки вы используете PHP, то переданные данные сразу попадают в системный массив $_REQUEST.
Т.е. $_REQUEST[‘items’][0][‘sum’] будет равен стоимости первого товара в заказе.
Оповещение скрипта при отмене счета
Также вы можете подключать оповещения об отмененных счетах, прописав адрес скрипта в поле «URL для оповещений по API об отмене счета».
Уведомления придут в формате URL-encoded POST в следующем виде:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 |
array( 'status' => 'cancel_order', 'id' => номер заказа, 'first_name' => имя клиента, 'last_name' => фамилия клиента, 'middle_name' => отчество клиента, 'email' => мейл клиента, 'phone' => телефон клиента, 'city' => город доставки, 'country' => страна доставки, 'region' => регион доставки, 'postalcode' => почтовый индекс, 'created' => время создания заказа, 'comment' => комментарий к заказу, 'roistat_visit' => значение cookie roistat id. Если значения нет - параметр не передается., 'utm' => array ( 'medium' => утм-параметр канал, 'source' => утм-параметр источник, 'campaign' => утм-параметр кампания, 'content' => утм-параметр объявление, 'term' => утм-параметр ключ, ), 'items' => array( //массив товаров array( 'id' => символьный идентификатор, 'title' => название товара, 'sum' => стоимость товара по факту (с учетом апсселла или скидки), 'price' => стоимость товара из настроек, ), array( 'id' => символьный идентификатор, 'title' => название товара, 'sum' => стоимость товара по факту (с учетом апсселла или скидки), 'price' => стоимость товара из настроек, ), ... ) 'hash' => md5(номер заказа + мейл клиента + время создания заказа + секретный ключ), ) |