BlackPost для WooCommerce: підключення плагіна

Q: Чи потрібні технічні знання для підключення?

Для базового підключення через плагін — ні. Завантажте плагін, введіть API-ключ у налаштуваннях, оберіть поріг ризику. Для кастомної інтеграції через functions.php потрібні базові знання PHP та WordPress hooks.

Q: Скільки коштує інтеграція BlackPost з WooCommerce?

Безкоштовний тариф Free дає 150 перевірок на місяць. Для більшості невеликих магазинів цього достатньо. Тариф Starter (99 грн/міс) — 500 перевірок, Business (199 грн/міс) — 2000. При середньому чеку 800 грн і 15% невикупів один збережений невикуп окупає місяць Starter.

Q: Що відбувається з замовленням, якщо покупець у чорному списку?

Це налаштовується: статус 'На перевірці', вимога передоплати або позначка для менеджера. Не відхиляйте замовлення лише за скором — перевірте історію та зв'яжіться з покупцем.

Q: Чи можна перевіряти покупців тільки при замовленні з накладеним платежем?

Так. У налаштуваннях плагіна або в кастомному коді можна вказати, що перевірка активується тільки для замовлень з оплатою при отриманні (COD). Замовлення з передоплатою пропускаються — немає ризику невикупу.

Коротко: Для WooCommerce BlackPost підключається через плагін або API: створіть ключ у кабінеті, додайте його в налаштування інтеграції та проведіть тестову перевірку. Ключ не слід вставляти в URL чи показувати у відкритому коді сторінки.

WooCommerce — найпопулярніша e-commerce платформа в Україні. За різними оцінками, на ній працює від 30% до 40% українських інтернет-магазинів. Проблема накладеного платежу (COD) тут стоїть так само гостро, як і на інших платформах: від 15% до 25% замовлень повертаються невикупленими, а кожне повернення коштує продавцю в середньому 135 грн.

У цій статті — покрокова інструкція підключення BlackPost до WooCommerce. Два способи: через готовий плагін (5 хвилин, без коду) та через functions.php (для тих, хто хоче повний контроль). Після підключення кожне нове замовлення автоматично перевірятиметься за базою з 386 860 записів про проблемних покупців.

1.2.4

поточна версія плагіна

5 хв

підключення плагіна

HPOS

сумісне зберігання замовлень

386 860

записів у базі

Навіщо перевіряти покупців у WooCommerce

Стандартний WooCommerce не має жодних інструментів оцінки ризику покупця. Будь-хто може оформити замовлення з накладеним платежем, вказавши чужий номер телефону або неіснуючу адресу. Продавець відправляє товар, платить за доставку, пакування, роботу менеджера — а покупець просто не приходить на пошту.

Масштаб проблеми для типового магазину на WooCommerce:

Показник	Малий магазин	Середній магазин	Великий магазин
Замовлень / місяць	50-150	150-500	500-2000
% з накладеним платежем	60-80%	50-70%	40-60%
% невикупів	15-25%	15-20%	10-18%
Втрати / місяць	1 000 – 4 000 грн	4 000 – 12 000 грн	10 000 – 40 000 грн
Втрати / рік	12 000 – 48 000 грн	48 000 – 144 000 грн	120 000 – 480 000 грн

Більш точно порахувати збитки від невикупів можна за допомогою нашого калькулятора збитків від невикупів. Він враховує всі складові: доставку, пакування, роботу менеджера та втрачений прибуток.

Важливо Перевірка покупця не означає блокування замовлення. Це інструмент оцінки ризику: для підозрілих замовлень ви можете вимагати передоплату, а для надійних — спокійно відправляти з накладеним платежем.

Як працює інтеграція BlackPost + WooCommerce

Схема максимально проста: при створенні замовлення WooCommerce надсилає запит до API BlackPost із номером телефону покупця. API повертає ризик-скор від 0 до 100, кількість скарг та категорії порушень. На основі цих даних ваш магазин приймає рішення.

Покупець оформлює замовлення Заповнює форму WooCommerce: ім'я, телефон, адреса, спосіб доставки та оплати.

WooCommerce створює замовлення WordPress hook woocommerce_new_order спрацьовує та ініціює перевірку.

Запит до BlackPost API Плагін надсилає GET-запит з номером телефону. Час відповіді — 100-200 мс.

API повертає оцінку ризику Ризик-скор 0-100, кількість скарг, категорії (невикуп, шахрайство, підміна товару).

Автоматична реакція Залежно від скору: пропустити, позначити, вимагати передоплату або відхилити.

Без втрати швидкості Запит до API BlackPost виконується асинхронно після створення замовлення. Покупець не чекає — він одразу бачить підтвердження. Рішення приймається до відправки товару.

Крок 1: Реєстрація та отримання API-ключа

Перш ніж підключати WooCommerce, потрібен обліковий запис BlackPost та API-ключ.

Зареєструйтесь на BlackPost Відкрийте blackpost.com.ua, натисніть «Кабінет» → «Реєстрація». Вкажіть email, пароль та назву магазину.

Перейдіть у розділ API В особистому кабінеті натисніть «API ключі» у бічному меню. Ви побачите список ваших ключів (порожній на початку).

Створіть API-ключ Натисніть «Створити ключ», вкажіть назву (наприклад, «WooCommerce магазин»). Скопіюйте згенерований ключ — він знадобиться для налаштування.

Безкоштовний тариф На тарифі Free ви отримуєте 150 перевірок на місяць та 1 API-ключ. Цього достатньо для тестування та для магазинів з невеликим обсягом замовлень. Тарифи та ліміти — на сторінці Тарифи.

Спосіб 1: Плагін BlackPost для WooCommerce (рекомендовано)

Найшвидший спосіб підключення — готовий плагін. Не потрібно писати код, достатньо встановити плагін та вказати API-ключ.

Версія плагіна 1.2.4 · перевірено 5 вересня 2026 року Мінімальні вимоги: WordPress 5.8+, WooCommerce 6.0+ і PHP 7.4+. Плагін підтримує HPOS. Роботу демо перевірено на WordPress 6.9.4 та WooCommerce 10.6.1.

Компонент	Мінімум	Перевірене середовище
WordPress	5.8+	WordPress 6.9.4
WooCommerce	6.0+	WooCommerce 10.6.1
PHP	7.4+	HTTPS, cURL і JSON мають бути доступні
Зберігання замовлень	Legacy або HPOS	HPOS-сумісність оголошена плагіном

Оновлення для вже встановлених копій: плагін перевіряє релізи через стандартний механізм WordPress. Якщо власник увімкнув автооновлення для BlackPost, WordPress встановить реліз автоматично; інакше покаже звичайне сповіщення та кнопку. У 1.2.4 виправлено передачу ліцензійного ключа; для клієнтів на 1.2.3 працює одноразовий сумісний перехід, після якого наступні завантаження знову потребують чинної ліцензії.

Встановлення

Завантажте плагін Скачайте ZIP-файл плагіна зі сторінки Інтеграції в особистому кабінеті BlackPost.

Встановіть у WordPress Перейдіть у адмінку WordPress → Плагіни → Додати новий → Завантажити. Оберіть ZIP-файл та натисніть «Встановити».

Активуйте плагін Після встановлення натисніть «Активувати». У меню WooCommerce з'явиться новий пункт «BlackPost».

Вкажіть API-ключ Перейдіть до WooCommerce → BlackPost → Налаштування. Вставте API-ключ, який ви отримали раніше. Натисніть «Зберегти».

Налаштування плагіна

Параметр	Опис	Рекомендація
`API Key`	Ваш API-ключ BlackPost	Обов'язкове поле
`Risk Threshold`	Поріг ризику (0-100), вище якого спрацьовує реакція	50 для початку, пізніше можна зменшити до 30
`Action`	Дія при високому ризику	«На перевірці» (on-hold) для початку
`COD Only`	Перевіряти тільки замовлення з накладеним платежем	Увімкнути — немає сенсу перевіряти передоплату
`Admin Notice`	Показувати попередження в адмінці WooCommerce	Увімкнути
`Order Note`	Додавати результат перевірки в нотатки замовлення	Увімкнути — корисно для аналізу

Рекомендований поріг ризику Починайте з порогу 50. Це означає, що лише замовлення з ризик-скором вище 50 потраплять на ручну перевірку. За тиждень роботи проаналізуйте результати та скоригуйте поріг. Детальніше про ризик-скоринг — у статті Чорний список Нової Пошти.

Віджет статистики BlackPost на панелі WordPress і WooCommerce — Віджет BlackPost у демо-магазині показує підсумки перевірок, ризикових покупців і суму ризикових замовлень.

Спосіб 2: Інтеграція через functions.php

Для повного контролю над логікою перевірки можна додати код напряму у functions.php вашої теми (або у кастомний плагін). Цей спосіб дає максимальну гнучкість.

Базова перевірка при створенні замовлення

PHP // functions.php або кастомний плагін add_action('woocommerce_new_order', 'blackpost_check_buyer', 10, 1); function blackpost_check_buyer($order_id) { $order = wc_get_order($order_id); if (!$order) return; // Перевіряємо тільки COD-замовлення if ($order->get_payment_method() !== 'cod') return; $phone = $order->get_billing_phone(); if (empty($phone)) return; $api_key = get_option('blackpost_api_key'); $url = 'https://blackpost.com.ua/api/v1/check?phone=' . urlencode($phone); $response = wp_remote_get($url, [ 'headers' => ['X-API-Key' => $api_key], 'timeout' => 5, ]); if (is_wp_error($response)) { $order->add_order_note('BlackPost: помилка з\'єднання'); return; } $body = json_decode( wp_remote_retrieve_body($response), true ); if (!$body || !isset($body['risk_score'])) return; $score = (int) $body['risk_score']; $reports = (int) ($body['total_reports'] ?? 0); // Зберігаємо результат update_post_meta($order_id, '_blackpost_score', $score); update_post_meta($order_id, '_blackpost_reports', $reports); $note = sprintf( 'BlackPost: ризик %d/100, скарг: %d', $score, $reports ); $order->add_order_note($note); // Реакція при високому ризику if ($score >= 50) { $order->update_status( 'on-hold', 'Замовлення затримано: високий ризик невикупу' ); } }

Розширена версія: різні дії для різних рівнів ризику

PHP // Замість простого if ($score >= 50) використовуємо градацію: if ($score >= 80) { // Критичний ризик — відхилити замовлення $order->update_status('cancelled', 'Автоматично скасовано: критичний ризик (' . $score . '/100)'); } elseif ($score >= 50) { // Високий ризик — на перевірку $order->update_status('on-hold', 'Потребує перевірки: ризик ' . $score . '/100'); } elseif ($score >= 30) { // Середній ризик — позначити, але обробити $order->add_order_note( '⚠ BlackPost: середній ризик (' . $score . '). Рекомендуємо зателефонувати.'); } // score < 30 — все добре, нічого не робимо

Повну документацію API з усіма параметрами, форматами відповідей та прикладами на PHP, Python і JavaScript читайте у статті API перевірки покупців: документація та інтеграція.

Сценарії реакції на ризикового покупця

Що робити, коли BlackPost повертає високий ризик-скор? Ось п'ять стратегій, від м'якої до жорсткої:

Стратегія	Скор	Дія	Ефект
Спостереження	30-49	Лише нотатка в замовленні	Менеджер бачить попередження, сам вирішує
Дзвінок	40-59	Автоматична позначка «зателефонувати»	Фактичний ефект залежить від ніші, трафіку та процесу магазину. Вимірюйте його на власній контрольній вибірці й не сприймайте як гарантію.
На перевірці	50-69	Статус «on-hold» + сповіщення менеджеру	Замовлення не відправляється без ручного підтвердження
Передоплата	60-79	Вимога часткової або повної передоплати	Фактичний ефект залежить від ніші, трафіку та процесу магазину. Вимірюйте його на власній контрольній вибірці й не сприймайте як гарантію.
Відхилення	80+	Автоматичне скасування замовлення	Повне блокування шахраїв, ризик втратити легітимного клієнта мінімальний

Кожен магазин обирає свою стратегію залежно від маржі, середнього чеку та допустимого рівня ризику. Детальніше про стратегії підтвердження замовлень — у статті 7 способів підтвердити замовлення перед відправкою.

Перевірте свою базу покупців

Завантажте список телефонів і дізнайтесь, скільки проблемних покупців серед ваших клієнтів

Перевірити безкоштовно

Перевірка тільки для замовлень з накладеним платежем

Не має сенсу витрачати ліміт перевірок на замовлення з передоплатою — покупець уже заплатив. Ось як обмежити перевірку тільки COD-замовленнями:

PHP // Перевіряємо спосіб оплати $payment = $order->get_payment_method(); // Список методів оплати, які потребують перевірки $cod_methods = ['cod', 'nova_poshta_cod', 'cash_on_delivery']; if (!in_array($payment, $cod_methods)) { return; // Передоплата — пропускаємо }

Економія лімітів Якщо 40% ваших замовлень — з передоплатою, ви заощаджуєте 40% лімітів перевірок. На тарифі Free (150/міс) це 60 додаткових перевірок.

Колонка ризику в адмінці WooCommerce

Готовий плагін додає колонку BlackPost у сучасний список замовлень WooCommerce, включно з HPOS. Менеджер бачить оцінку до відкриття картки замовлення:

Колонка BlackPost з ризик-скорами у списку замовлень WooCommerce — Поточний список тестових замовлень: зелена позначка для чистої перевірки та числові скори 23, 72 і 91 для ручного рішення менеджера.

Якщо ви обрали кастомну інтеграцію замість плагіна, аналогічну колонку можна додати власним кодом:

PHP // Додаємо колонку в список замовлень add_filter('manage_edit-shop_order_columns', function($cols) { $new = []; foreach ($cols as $key => $val) { $new[$key] = $val; if ($key === 'order_status') { $new['bp_risk'] = 'Ризик'; } } return $new; }); // Заповнюємо колонку add_action('manage_shop_order_posts_custom_column', function($col) { global $post; if ($col !== 'bp_risk') return; $score = get_post_meta($post->ID, '_blackpost_score', true); if ($score === '') { echo '—'; return; } $score = (int) $score; if ($score >= 70) $color = '#dc2626'; elseif ($score >= 40) $color = '#d97706'; else $color = '#16a34a'; printf( '<span style="color:%s;font-weight:700">%d</span>', $color, $score ); });

Тепер у списку замовлень WooCommerce з'явиться колонка «Ризик» з кольоровим індикатором: зелений (0-39), жовтий (40-69), червоний (70-100).

Масова перевірка існуючих клієнтів

Коли ви тільки підключаєте BlackPost, корисно перевірити вже існуючу базу клієнтів. Це дасть розуміння, скільки потенційно проблемних покупців серед ваших замовників.

PHP // WP-CLI команда для масової перевірки // Запуск: wp eval-file bulk-check.php $api_key = get_option('blackpost_api_key'); $orders = wc_get_orders([ 'limit' => -1, 'status' => ['processing', 'completed'], 'meta_query' => [[ 'key' => '_blackpost_score', 'compare' => 'NOT EXISTS', ]], ]); $checked = 0; $risky = 0; foreach ($orders as $order) { $phone = $order->get_billing_phone(); if (empty($phone)) continue; $resp = wp_remote_get( 'https://blackpost.com.ua/api/v1/check?phone=' . urlencode($phone), ['headers' => ['X-API-Key' => $api_key], 'timeout' => 5] ); if (is_wp_error($resp)) continue; $data = json_decode( wp_remote_retrieve_body($resp), true ); if (!isset($data['risk_score'])) continue; update_post_meta( $order->get_id(), '_blackpost_score', $data['risk_score'] ); $checked++; if ($data['risk_score'] >= 50) $risky++; usleep(200000); // 200ms пауза між запитами } WP_CLI::success( "Перевірено: $checked, ризикових: $risky" );

Ліміти API Масова перевірка витрачає ліміти вашого тарифу. На безкоштовному тарифі — 150 перевірок/міс. Для великих баз рекомендуємо тариф Business (2000/міс) або Pro (10 000/міс). Повна інформація про ліміти — у статті Ліміти на післяплату Нової Пошти.

Вартість та окупність

Головне питання: чи окупається перевірка покупців? Порахуємо на реальних цифрах.

Тариф	Ціна	Перевірок/міс	Окупність
Free	0 грн	150	Безкоштовно — завжди окупається
Starter	99 грн/міс	500	Окупається при 1 збереженому невикупі (135 грн > 99 грн)
Business	199 грн/міс	2 000	Окупається при 2 збережених невикупах
Pro	499 грн/міс	10 000	Окупається при 4 збережених невикупах

Розраховуйте ефект інтеграції на власних даних: порівняйте частку невикупів, логістичні витрати та час менеджера до і після запуску. BlackPost не гарантує фіксований відсоток економії або ROI.

Точнішу цифру для вашого бізнесу покаже калькулятор збитків від невикупів. Підставте свої дані й побачите, скільки саме заощаджуєте.

Порівняння з іншими способами захисту

BlackPost — не єдиний спосіб зменшити невикупи. Але він працює найкраще в поєднанні з іншими методами:

Метод	Зменшення невикупів	Вартість	Автоматизація
Передзвонок менеджера	25-40%	Час менеджера (3-5 хв/замовлення)	Ні
SMS/Viber підтвердження	15-30%	0.3-0.8 грн/SMS	Частково
Часткова передоплата	55-65%	Безкоштовно	Так
BlackPost перевірка	30-50%	Від 0 грн/міс	Повна
Комбінація: BlackPost + дзвінок	50-70%	Час лише на ризикових	Гібрид

Практичний підхід — використовувати результат BlackPost як сигнал для менеджера, який додатково перевіряє контекст замовлення. Фактичний ефект вимірюйте на власній контрольній вибірці. Детальніше — у статті Невикуп посилки: що робити продавцю.

FAQ: часті питання

Чи сповільнить BlackPost оформлення замовлення?

Ні. API-запит займає 100-200 мс. Покупець навіть не помітить затримки. Перевірка відбувається у фоні під час обробки замовлення — після того, як покупець вже побачив підтвердження.

Чи потрібні технічні знання для підключення?

Для підключення через плагін — ні. Завантажте плагін, введіть API-ключ, оберіть поріг ризику. Для кастомної інтеграції через functions.php потрібні базові знання PHP та WordPress hooks — приклади коду є у цій статті.

Скільки коштує інтеграція BlackPost з WooCommerce?

Безкоштовний тариф Free дає 150 перевірок на місяць — для невеликих магазинів цього достатньо. Тариф Starter (99 грн/міс) — 500 перевірок. При середньому чеку 800 грн і 15% невикупів один збережений невикуп повністю окупає місяць Starter.

Що відбувається, якщо покупець у чорному списку?

Це налаштовується: переведення в статус «На перевірці», вимога передоплати або позначка для менеджера. Не відхиляйте замовлення лише за одним скором — перевірте історію, зв'яжіться з покупцем і прийміть рішення за сукупністю сигналів.

Чи працює BlackPost з іншими CMS?

Так. BlackPost має готові модулі для OpenCart та ocStore. Для будь-якої іншої платформи (Shopify, PrestaShop, Magento, Tilda) можна використати REST API. Документацію з прикладами дивіться у нашій статті про API інтеграцію.

Чи можна перевіряти тільки COD-замовлення?

Так. У налаштуваннях плагіна або в кастомному коді вказуєте, що перевірка активується тільки для замовлень з оплатою при отриманні (COD). Замовлення з передоплатою пропускаються — немає ризику невикупу. Приклад коду є вище у статті.

Висновки

Підключення BlackPost до WooCommerce — це 5 хвилин роботи, які заощаджують тисячі гривень щомісяця. Два способи інтеграції: готовий плагін (для швидкого старту) та кастомний код через functions.php (для повного контролю).

Ключові переваги:

Автоматизація — перевірка відбувається без участі менеджера
Швидкість — 100 мс на запит, покупець не помічає затримки
Гнучкість — різні реакції для різних рівнів ризику
Економія — один збережений невикуп окупає місяць тарифу Starter
База — 386 860 записів про проблемних покупців

Підключіть BlackPost до WooCommerce за 5 хвилин

Зареєструйтесь, отримайте API-ключ та почніть перевіряти покупців. 150 перевірок/місяць — безкоштовно.

Зареєструватись Тарифи

Актуальність: правила, посилання та твердження перевірено 5 вересня 2026 року.

Джерела: Документація API BlackPost · Підтримувані інтеграції BlackPost.

Менше ризику перед відправкою. Перевірте історію одержувача й оберіть умови оплати за сукупністю сигналів.

Перевірити покупця перед відправкою