Нотификации API для автоматизации Вашей продажи

Click2Sell API немедленно уведомляет Ваш слушающий скрипт о всех новых событиях - продаже, ребиллингах, рефандах, подписках и ее аннулировании. Он тоже автоматизирует доставку контента, создание аккаунта или обновления, сбор информации о клиентах и многое другое.

Немедленные нотификации позволяют продавцам поднять бизнес на высший уровень, так как они предъявляют дополнительную функциональность и защиту, а также экономят время продавца.

Эта функциональность предназначена для пользователей, имеющие кое-какие навыки программирования. Вам может потребоваться нанять кого-то для работ кодирования, но, имея в виду то, как автоматические уведомления могут улучшить Ваш бизнес, стоит об этом подумать!

Как работает API Click2Sell?

API в Click2Sell работает методом HTTP POST. Когда происходит транзакция - продажа, рефанд, ребиллинг или аннулирование подписки, наша система размещает сообщение со сведениями о транзакции в указанное расположение URL – в Ваши сервера и скрипты, где они «слушают» такие нотификации

Нотификация API в Click2Sell содержит:

• Подробную информацию покупателя.
• Информацию транзакции (идентификатор процессора платежа, дату, время и т. д.).
• Информацию, связанную с Click2Sell (идентификатор транзакции, имя пользователя, имя партнера и т.д.).

Все продавцы, желающие пользоваться API Click2Sell, должны посетить:
Продавцам -> Мои продукты -> Менять настройку (кликайте на нужный продукт)-> Настройка API

На этой странице вы можете включать/выключать нотификации API. Для выключения нотификаций, введите URL-адрес дислокации вашего скрипта или страницы «Спасибо Вам», которая «слушает» данные, а затем отметьте чек-бокс «Включать/Выключать нотификации удаленного сервера.
Тогда наша система будет отправлять все сведения о заказе на указанное место.

Там еще есть поле «Секретный ключ». Оно необязательно. Однако используйте это поле, если отправляя нотификации, хотите проверять, действительно ли они приходят из Click2Sell.EU. Просто введите любое секретное ключевое слово или используйте ссылку «Генерировать» ниже этого поля для нашей системы для автоматического его создания. Когда используете эту опцию, наша система принимает и объединяет этот ключ с acquirer_transaction_id (acquirer_transaction_id + secretkey + «_») и с MD5. С параметром «checksum» через API передается переменная для проверки Вашим сервером.

Кроме того чтобы Вы смогли идентифицировать клиента после продажи, API может методом POST отправить acquirer_transaction_id в указанную «Спасибо» страницу. Эта функция может быть включена / выключена в разделе «Настройка API».

Каждому продукту, для большей гибкости требуется отдельная конфигурация API.

Параметры API Click2Sell

Передача собственных параметров

Вы можете передавать неограниченное количество собственных параметров на страницу оформления заказа Click2Sell и после завершения покупки получить их обратно.

Для этого просто добавьте свои параметры в ссылку покупки продукта. Например
https://www.click2sell.eu/buy?testere123&m1=[value]&m2=[value2]
где https://www.click2sell.eu/buy?testere123 – ссылка покупки, а param1 & param2 - примеры названий параметров (Вы можете использовать любые другие названия параметров, допустим идентификатор пользователя).

Нотификации API и уведомляющие о продаже сообщения электронной почты будут содержать параметры с префиксом cp_ следующим образом:
cp_param1=[value]
cp_param2=[value2].

Если Вы активировали (Продавцам -> Менять настройку -> Настройка API) "Enable posting of Acquirer Transaction ID to "Thank you" page"), Ваши параметры методом POST тоже будут переданы на Вашу «Спасибо» страницу.

Пример кода Click2Sell API

Этот код является примером, как принимать нами отправленные нотификации.

 /* reading click2sell notification parameters to local variables */
$acqTransId = urldecode($_POST["acquirer_transaction_id"]); 
$c2sTransId = urldecode($_POST["c2s_transaction_id"]);
/* click2sell transaction number */



$purchaseDate = urldecode($_POST["purchase_date"]);
/* format: yyyy-MM-dd (year-month-day) */



$purchaseTime = urldecode($_POST["purchase_time"]);
/* format: HH:mm:ss (hours:minutes:seconds) */



$paymentType = urldecode($_POST["payment_type"]);
/* Paypal, Moneybookers, Google Checkout, credit card */



$transactionType = urldecode($_POST["transaction_type"]);
/* Sale, Refund, Subscription */



$paymentStatus = urldecode($_POST["payment_status"]);
/* OK or Failed,   now Always sends OK since we send notification only on successfull cases now */



$subscriptionStatus = urldecode($_POST["subscription_status"]);
/* in case of subscription: New, Recurring, Cancel*/



/* information about the buyer */



$buyerName = urldecode($_POST["buyer_name"]);
/* name */



$buyerSurname = urldecode($_POST["buyer_surname"]);
/* surname */



$buyerAddress = urldecode($_POST["buyer_address"]);
/* address */



$buyerCity = urldecode($_POST["buyer_city"]);
/* city */



$buyerProvince = urldecode($_POST["buyer_province"]);
/* province */



$buyerZip = urldecode($_POST["buyer_zip"]);
/* postal code*/



$buyerCountry = urldecode($_POST["buyer_country"]);
/* country name */



$buyerEmail = urldecode($_POST["buyer_email"]);
/* email */



$buyerPhone = urldecode($_POST["buyer_phone"]);
/* phone */



/* product information */



$productPrice = urldecode($_POST["product_price"]);
/* price: amount +   currency – "###.## CUR", CUR is a currency code: USD, EUR or GBP */



$productId = urldecode($_POST["product_id"]);
/* product id in click2sell */



$productName = urldecode($_POST["product_name"]);
/* product name */



$merchantName = urldecode($_POST["merchant_name"]);
/* name of the vendor */



$merchantUsername = urldecode($_POST["merchant_username"]);
/* click2sell login name of the vendor */



$merchantUsername = urldecode($_POST["affiliate_username"]);
/*   click2sell login of the affiliate in case of the affiliated sale */



/* … process the necessary data …. */



?>