Описание

Сервис e-AutoPay.com дает возможность отправлять уведомления при заказе товара и при смене статуса заказа
на Ваш URL.

Уведомление передается методом POST, либо GET на указанный URL, см. "Пример POST", "Пример JSON" и "Пример GET"


Настройка в e-AutoPay

Возможность настройки уведомлений есть в нескольких разделах:

  • Раздел "Товары" - "Товары для одиночной продажи".
    Далее перейти к редактированию нужного товара и открыть раздел "Уведомления".
  • Раздел "Логистика" - "Настройки" - "Уведомления при смене статуса"
  • В аккаунте партнера - раздел "Уведомления"

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

  • Название уведомления - это название будет отображаться в списке настроенных уведомлений.
  • URL - адрес, на который будут отправляться уведомления.
  • Секретный ключ - введите желаемый секретный ключ. Длина до 128 символов.
  • Кодировка уведомления - выберите кодировку, в которой должно высылаться уведомление.
  • Выберите товар - товар, для которого нужно отправлять уведомление.
  • После перехода в статус - когда заказ перейдет в указанный статус будет отправлено уведомление (поддерживается множественный выбор статусов).

Описание данных

Уведомление передается методом POST, либо GET на указанный URL, см. "Пример"

Параметр Описание
id id заказа
first_name Имя покупателя
last_name Фамилия покупателя
middle_name Отчество покупателя
email e-mail, указанный покупателем
phone Телефон, указанный покупателем
phone2 Домашний телефон покупателя
сity Город, указанный покупателем
country Страна, указанная покупателем
address Адрес, указанный покупателем
region Регион, указанный покупателем
postalcode Почтовый индекс, указанный покупателем
order_date Дата оформления заказа, время в формате time
pay_date Зарезервирован
currency Наименование валюты заказа. Например: руб
product_id Id товара
product_name Наименование товара
product_price Цена, по которой куплен товар в валюте заказа
product_qty Количество единиц товара в заказе
comments_client Комментарий клиента
comments_author Комментарий автора в заказе
comments_logistics Служебные комментарии + комментарии логистики (Юсенд)
ip IP-адрес клиента
pay_method Способ оплаты заказа
status Статус заказа (передается цифровое значение). См. "Статусы заказа (status)"
status_sysname Статус заказа (передается текстовое значение). См. "Статусы заказа (status_sysname)"
promoaction Промоакция, см. Дополнение 1
partners Партнеры привязанные к заказу, см. Дополнение 2
utm utm-метки к заказу, см. Дополнение 3
rpo Почтовый идентификатор
order_delivery_cost Стоимость доставки
pin_code Пин-код, отправленный клиенту
additional_field_1
additional_field_10
Дополнительные поля с первого по десятое
hash Подпись уведомления, см. Дополнение 4


Статусы заказа (status)

Код Статус
1 Новые
13 Call-центр
14 Уточнение
2 Подтвержденные
21 Комплектация
10 Подготовленные
3 Отправленные
9 Доставленные
19 Напоминание 1
20 Напоминание 2
15 Врученные
5 Вручены и оплачены
12 Выплачено
6 Неподтвержденные
7 Отсроченные
8 Отказы
4 Возвраты
18 Получен возврат
11 Проблемные
0 Архив
16 В розыске
17 Отсутствие продукта

Статусы заказа (status_sysname)

Код Описание
"archive" Архив
"new" Новый
"confirmed" Подтвержден оператором
"sent" Отправлен клиенту
"cancelled" Возврат
"in_hands_paid" Вручен и оплачен
"unconfirmed" Неподтвержден
"delayed" Отсрочен
"refused" Отказ
"delivered_unpaid" Доставлен к месту получения
"complectation" Комплектация
"ready_for_delivery" Подготовлен к отправке
"problem" Проблемный
"delivered_paid" Доставлен к месту получения и оплачен
"pending" Ожидает подтверждения (Call-центр)
"specified" Уточненный
"in_hands_unpaid" Вручен
"wanted" В розыске
"absence" Отсутствие продукта
"returned" Получен возврат
"notice1" Напоминание 1
"notice2" Напоминание 2

Пример POST уведомления

Пример дампа уведомления.

Уведомление передается методом POST на указанный URL

	Array (
		[id] => '3245',
		[first_name] => 'Иван',
		[last_name] => 'Петров',
		[middle_name] => 'Сидорович',
		[email] => 'ivan@test.com',
		[phone] => '79011580000',
		[phone2] => '',
		[city] => 'Москва',
		[country] => 'Россия',
		[address] => 'Строительный переулок, 8',
		[region] => 'Москва',
		[postalcode] => '142793',
		[order_date] => '1357733101',
		[pay_date] => '',
		[currency] => 'USD',
		[product_id] => '1',
		[product_name] => 'Услуга',
		[product_price] => '20',
		[product_qty] => '2',
		[comments_client] => 'комментарий клиента',
		[comments_author] => 'комментарий автора в заказе',
		[comments_logistics] => 'комментарий логистики',
		[ip] => '127.0.0.1',
		[pay_method] => 'QIWI',
		[status] => '1',
		[status_sysname] => 'new',
		[promoaction] => array (
			[promoaction_id] => '6987',
			[promoaction_name] => 'скидка для товара id 23',
			[promocode] => 'PF6KrEi9hF'
		),
		[partners] => array (
			0 => array (
				[login] => 'partner_login',
				[commission] => '23.00 eur'
			)
		),
		[utm] => array (
			[utm_source] => 'source',
			[utm_medium] => 'medium',
		),
		[rpo] => '1312312312312321',
		[order_delivery_cost] => '350',
		[pin_code] => '12345',
		[additional_field_1] => 'доп. поле 1',
		[additional_field_2] => 'доп. поле 2',
		[additional_field_3] => '',
		[additional_field_4] => '',
		[additional_field_5] => '',
		[additional_field_6] => '',
		[additional_field_7] => '',
		[additional_field_8] => '',
		[additional_field_9] => '',
		[additional_field_10] => '',
		[hash] => '6288cbcdc1ccc1bb2726fbea3f88ca48',
		[duplicate] => '1'
		)

			 

Пример JSON уведомления

Пример дампа уведомления.

Уведомление передается методом POST на указанный URL
Для включения формата JSON необходимо включить соответствующий переключатель в настройке уведомления.

	{
	"id": "3245",
        "name": "Иван",
	"first_name": "Иван",
	"last_name": "Петров",
	"middle_name": "Сидорович",
	"email": "ivan@test.com",
	"phone": "79011580000",
	"phone2": "",
	"city": "Москва",
	"country": "Россия",
	"address": "Строительный переулок, 8",
	"region": "Москва",
	"postalcode": "142793",
	"order_date": "1357733101",
	"pay_date": "",
	"currency": "USD",
	"product_id": "1",
	"product_name": "Услуга",
	"product_price": "20",
	"product_qty": "2",
	"comments_client": "комментарий клиента",
	"comments_author": "комментарий автора в заказе",
	"comments_logistics": "комментарий логистики",
	"ip": "127.0.0.1",
	"pay_method": "QIWI",
	"status": "1",
	"status_sysname": "new",
	"promoaction": {
		"promoaction_id": "6987",
		"promoaction_name": "скидка для товара id 23",
		"promocode": "PF6KrEi9hF"
	},
	"partners": [{
		"login": "partner_login",
		"commission": "23.00 eur"
	}],
	"utm": {
		"utm_source": "source",
		"utm_medium": "medium"
	},
	"rpo": "1312312312312321",
	"order_delivery_cost": "350",
	"pin_code": "12345",
	"roistat_visit": "111",
	"additional_field_1": "доп. поле 1",
	"additional_field_2": "доп. поле 2",
	"additional_field_3": "",
	"additional_field_4": "",
	"additional_field_5": "",
	"additional_field_6": "",
	"additional_field_7": "",
	"additional_field_8": "",
	"additional_field_9": "",
	"additional_field_10": "",
	"hash": "6288cbcdc1ccc1bb2726fbea3f88ca48",
	"duplicate": "1"
	}

			 

Пример GET уведомления

Пример GET уведомления.

Уведомление передается методом GET на указанный URL
Передать можно абсолютно все параметры, которые указаны в описании данных, заключив параметр в %%.

Пример формирования ссылки:

	http://postback.ru/postback/?utm_source=%utm_source%&status=%status%
			 

Произвольные параметры

Postback с произвольными параметрами.

В ссылку на страницу заказа можно добавить произвольные параметры
Для этого нужно параметр прописать следующим образом: custom[параметр]=значение параметра

Пример формирования ссылки:

	http://site.ru?custom[subid]=subidtest&custom[testid]=testidtest
			 

Произвольные параметры в GET уведомлении:

При настройке GET уведомления достаточно просто вписать Вашу ссылку в поле URL настройки уведомления, параметры добавятся к ней автоматически при отправке уведомления.

Произвольные параметры в POST уведомлении:

	[custom] => array (
			[subid] => 'subidtest',
			[testid] => 'testidtest',
		),
			 


Дополнения

Дополнение 1

Поле промоакция (promoaction) содержит массив с тремя элементами.

Параметр Описание
promoaction_id id промоакции
promoaction_name Название промоакции
promocode Промокод, по которому была применена промоакция

Дополнение 2

Поле партнеры (partners) содержит массив, в котором перечислены все привязанные к заказу партнеры. В этом же массиве содержится информация о комиссионных для каждого партнера с указанием валюты, в которой начислены комиссионные.

Параметр Описание
login Логин партнера
commission Сумма комиссионных с указанием валюты

Дополнение 3

Поле utm-метки (utm) содержит информацию о utm-метках с страницы заказа. При отсутствии меток поле не передается.

	[utm] => array (
		[utm_source] => 'source',
		[utm_medium] => 'medium',
		),
                              

Дополнение 4

Поле [duplicate] => '1' передается, если уведомление повторное. В первичном уведомлении поле не передается.

Дополнение 5

Подпись уведомления (параметр hash) формируется путем объединения параметров id, email, phone, секретный ключ по алгоритму MD5.

md5(‘id+email+phone+секртеный ключ’);

Пример формирования подписи

	ID заказа: 3245
	Email: ivan@test.com
	Phone: 79011580000
	Секретный ключ: EEjFUjWNYamxAFLt7Ke7XKtgEw9WphN3sKX7dy
	Параметр hash:
	md5(‘3245ivan@test.com79011580000EEjFUjWNYamxAFLt7Ke7XKtgEw9WphN3sKX7dy’) =
	6288cbcdc1ccc1bb2726fbea3f88ca48
                              

Центр поддержки пользователей