Содержание
Оповещение при оплате счета
Вы можете подключить оповещение вашей системы при оплате заказа.
Для этого при редактировании товара в поле «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 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 |
array( 'id' => номер заказа 'first_name' => имя клиента 'last_name' => фамилия клиента 'middle_name' => отчество клиента 'email' => мейл клиента 'phone' => телефон клиента 'city' => город доставки 'country' => страна доставки 'address' => адрес доставки 'region' => регион доставки 'postalcode' => почтовый индекс 'created' => время создания заказа 'paid' => время оплаты заказа 'last_payment_sum' => сумма последней оплаты (если счет оплачен одним платежом, то равно сумме счета) 'comment' => комментарий к заказу, 'tag' => тэг, 'kupon' => использованный купон, 'type' => тип, 'payway' => способ оплаты, 'domain' => домен заказа, 'is_recurrent' => счёт рекуррентный? (1 - да, 0 - нет), 'roistat_visit' => значение cookie roistat id. Если значения нет - параметр не передается., 'utm' => array ( 'medium' => утм-параметр канал 'source' => утм-параметр источник 'campaign' => утм-параметр кампания 'content' => утм-параметр объявление 'term' => утм-параметр ключ ), 'items' => array( массив товаров array( 'id' => символьный идентификатор 'title' => название товара 'sum' => стоимость товара по факту (с учетом апсселла или скидки) 'price' => стоимость товара из настроек 'pincode' => пин-код отправленный в письме после оплаты 'partners' => array ( 0 => array ( 'partner_lvl' => уровень партнера (первый уровень) 'partner_id' => идентификатор партнера 'partner_name' => логин партнера 'partner_fee' => сумма партнерских начислений ), 1 => array ( 'partner_lvl' => уровень партнера (второй уровень) 'partner_id' => идентификатор партнера 'partner_name' => логин партнера 'partner_fee' => сумма партнерских начислений ), ), ), array( 'id' => символьный идентификатор 'title' => название товара 'sum' => стоимость товара по факту (с учетом апсселла или скидки) 'price' => стоимость товара из настроек 'pincode' => пин-код отправленный в письме после оплаты 'partners' => array ( 0 => array ( 'partner_lvl' => уровень партнера (первый уровень) 'partner_id' => идентификатор партнера 'partner_name' => логин партнера 'partner_fee' => сумма партнерских начислений ), 1 => array ( 'partner_lvl' => уровень партнера (второй уровень) 'partner_id' => идентификатор партнера 'partner_name' => логин партнера 'partner_fee' => сумма партнерских начислений ), ), ), ... ) '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 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 |
array( 'id' => номер заказа 'first_name' => имя клиента 'last_name' => фамилия клиента 'middle_name' => отчество клиента 'email' => мейл клиента 'phone' => телефон клиента 'city' => город доставки 'country' => страна доставки 'region' => регион доставки 'postalcode' => почтовый индекс 'created' => время создания заказа 'prepayment_sum' => сумма предоплаты 'tag' => тэг, 'kupon' => использованный купон, 'domain' => домен заказа, 'link' => ссылка на страницу оплаты заказа, 'is_recurrent' => счёт рекуррентный? (1 - да, 0 - нет), 'roistat_visit' => значение cookie roistat id. Если значения нет - параметр не передается., 'utm' => array ( 'medium' => утм-параметр канал 'source' => утм-параметр источник 'campaign' => утм-параметр кампания 'content' => утм-параметр объявление 'term' => утм-параметр ключ ), 'items' => array ( массив товаров 0 => array ( 'id' => символьный идентификатор 'title' => название товара 'sum' => стоимость товара по факту (с учетом апсселла или скидки) 'price' => стоимость товара из настроек 'pincode' => пин-код отправленный в письме после предоплаты 'partners' => array ( 0 => array ( 'partner_lvl' => уровень партнера (первый уровень) 'partner_id' => идентификатор партнера 'partner_name' => логин партнера 'partner_fee' => сумма партнерских начислений ), 1 => array ( 'partner_lvl' => уровень партнера (второй уровень) 'partner_id' => идентификатор партнера 'partner_name' => логин партнера 'partner_fee' => сумма партнерских начислений ), ), ), ... ) 'hash' => md5(номер заказа + мейл клиента + время оплаты заказа + секретный ключ) ) |
Оповещение при возврате (moneyback)
Также вы можете подключать оповещения о возвратах средств (moneyback), прописав адрес скрипта в поле «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 40 41 42 43 44 45 46 47 48 49 50 51 |
array( 'status' => 'moneyback', 'id' => номер заказа, 'first_name' => имя клиента, 'last_name' => фамилия клиента, 'middle_name' => отчество клиента, 'email' => мейл клиента, 'phone' => телефон клиента, 'city' => город доставки, 'country' => страна доставки, 'region' => регион доставки, 'postalcode' => почтовый индекс, 'created' => время создания заказа, 'comment' => комментарий к заказу, 'is_recurrent' => счёт рекуррентный? (1 - да, 0 - нет), '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(номер заказа + мейл клиента + время создания заказа + секретный ключ), ) |
(6 оценок, среднее: 3,67 из 5)
Загрузка...