Оплата Stripe переводить покупця на захищену сторінку Stripe: картка, Apple Pay, Google Pay, Klarna, iDEAL, BLIK, SEPA та інші способи його країни. Магазин сам дізнається результат від Stripe і ставить замовленню статус.
Коли це знадобиться:
- Ви продаєте в ЄС, Велику Британію чи США — Stripe показує покупцю способи його країни.
- Покупець платить з рахунку через SEPA — замовлення чекає підтвердження банку і стає оплаченим саме.
- Покупець змінив кошик після переходу на оплату — оплата іншої суми не стане «Оплачено».
- Покупець оскаржив оплату в банку — замовлення отримає статус, який ви оберете.
З чого почати: «Налаштування магазину» → «Оформлення і оплата» → Stripe → ключі, адреса вебхука й перемикач «Увімкнено».
Що вміє оплата Stripe
- Приймати оплату на сторінці Stripe — способи, які ви ввімкнули в кабінеті Stripe і які підходять покупцю.
- Працювати в тестовому режимі — тестові картки, гроші не списуються.
- Тримати тестові й бойові ключі разом — перемикач режиму обирає, яка пара працює.
- Ставити статус замовлення сам — оплачено, чекає банку, не пройшла, повернуто, оскаржено.
- Повертати всю суму чи частину — кнопкою в картці замовлення Elbuz.
Як підключити Stripe
Потрібен обліковий запис Stripe вашої фірми. Тестовий режим Stripe дає одразу після реєстрації, ще до договору: модуль можна налаштувати й перевірити заздалегідь.
- Відкрийте екран модуля. «Налаштування магазину» → розділ «Оформлення і оплата» → картка Stripe.
- У блоці «Підключення» лиште «Тестовий режим» увімкненим і скопіюйте «Адреса вебхука».
- Створіть вебхук у кабінеті Stripe з цією адресою і подіями з поля «Події вебхука» (нижче).
- У картці «Тестові ключі» впишіть «Тестовий секретний ключ» і «Тестовий секрет підпису вебхука».
- Увімкніть перемикач «Увімкнено» вгорі екрана і натисніть «Зберегти».
- Перевірте тестовою оплатою, потім перейдіть на бойовий режим.
1
Картка Stripe2
Позначка стану- Картка модуля оплати Stripe — клік відкриває його екран.
- Чого бракує модулю: «потрібні ключі», поки не вписано ключі поточного режиму.
1
Перемикач «Увімкнено»2
Тестовий режим3
Адреса вебхука4
Що ще не налаштовано5
Режим- Показує Stripe покупцям після збереження.
- Тестові оплати без списання грошей, працює пара тестових ключів.
- Цю адресу вписують у вебхук у кабінеті Stripe.
- Чого бракує, щоб оплата працювала.
- У якому режимі зараз працює оплата.
Картка ключів поточного режиму розгорнута й позначена «працює зараз», друга згорнута. Увімкнений модуль без обох ключів поточного режиму не збережеться: у полі з'явиться «Заповніть — без цього модуль не працюватиме».
Ключ не того режиму, наприклад sk_live_… у тестовому полі, не збережеться: біля поля з'явиться «Тестовий ключ починається з sk_test_ або rk_test_.» Як влаштоване вікно загалом — у статті «Налаштування магазину».
Де взяти ключі й створити вебхук
Для кожного режиму потрібні два значення: секретний ключ і секрет підпису вебхука. Тестові й бойові різні. Режим перемикається вгорі кабінету Stripe (Test mode або Sandbox).
Секретний ключ
Кабінет Stripe → Developers → API keys → Secret key → Reveal. Тестовий починається з sk_test_, бойовий — з sk_live_. Бойовий ключ Stripe показує повністю лише раз: збережіть копію.
Підійде й обмежений ключ rk_test_… чи rk_live_…. Які права йому дати, сказано в кнопці «Довідка» на екрані модуля.
Вебхук і його секрет
Вебхук — адреса магазину, на яку Stripe надсилає повідомлення про оплати й повернення. Без нього магазин не дізнається, що покупець заплатив.
- У кабінеті Stripe: Workbench → Webhooks → Create an event destination.
- Оберіть Your account, формат подій Snapshot.
- Відмітьте всі 9 подій з поля «Події вебхука». Кнопка «Копіювати всі» скопіює їх разом.
- Тип — Webhook endpoint. У Endpoint URL вставте «Адреса вебхука» з екрана модуля і збережіть.
- На сторінці вебхука натисніть Reveal біля Signing secret і скопіюйте
whsec_…у поле секрету підпису.
1
Адреса вебхука2
Події вебхука3
Тестовий секретний ключ4
Тестовий секрет підпису вебхука5
працює зараз- Вставте в Endpoint URL вебхука в кабінеті Stripe.
- Події, які треба відмітити у вебхуку, копіюються разом.
- Secret key з Developers → API keys у тестовому режимі (sk_test_…).
- Signing secret тестового вебхука (whsec_…).
- Пара ключів, яка працює в поточному режимі.
Для бойового режиму повторіть те саме в бойовому режимі кабінету: там свій вебхук і свій секрет. Захист сайту не повинен закривати адресу вебхука, інакше статуси не змінюватимуться.
Ключі після збереження не показуються — у полі видно лише, що їх задано. Щоб змінити, натисніть «Замінити» і впишіть новий.
Як перевірити тестовою оплатою
- Оформіть замовлення на себе й оберіть Stripe. Над переходом буде «Тестовий режим (Stripe): гроші не списуються».
- На сторінці Stripe оплатіть тестовою карткою з таблиці. Термін — будь-яка майбутня дата, CVC — будь-які три цифри.
- Перевірте замовлення в Elbuz: статус з поля «Оплачено». Саму оплату видно в кабінеті Stripe в тестовому режимі.
| Що ввести | Що станеться |
|---|---|
Картка 4242 4242 4242 4242 | Успішна оплата |
Картка 4000 0000 0000 3220 | Оплата з підтвердженням 3-D Secure: у вікні натисніть Complete |
Картка 4000 0000 0000 0002 | Банк відмовив: покупець лишається на сторінці Stripe і може спробувати іншу картку |
SEPA, IBAN DE89370400440532013000 | Спершу «Чекає на підтвердження банку», потім «Оплачено» |
SEPA, IBAN DE62370400440532013001 | Спершу «Чекає на підтвердження банку», потім «Оплата не пройшла» |
SEPA видно, лише якщо її ввімкнено в кабінеті Stripe і замовлення в євро.
Перехід на бойовий режим
Поки тестовий режим увімкнено, праворуч висить «Увімкнено тестовий режим — гроші не списуються. Вимкніть перед продажами». Щоб приймати справжні гроші:
- У кабінеті Stripe завершіть активацію: Activate payments, дані фірми й рахунок для виплат.
- Створіть вебхук у бойовому режимі кабінету.
- У картці «Бойові ключі» впишіть «Бойовий секретний ключ» і «Бойовий секрет підпису вебхука».
- Вимкніть «Тестовий режим» і натисніть «Зберегти». Рядок «Режим» праворуч покаже «Бойовий режим».
Після перемикання магазин сам закриває в Stripe незавершені сторінки оплати старого режиму. Тестові ключі лишаються збереженими: увімкнете тестовий режим знову — вони на місці.
Що бачить покупець і для яких замовлень
В оформленні замовлення спосіб називається «Картка, Apple Pay, Google Pay та інші способи (Stripe)». Після підтвердження покупець бачить «Переходимо на захищену сторінку оплати Stripe…» і потрапляє на сторінку Stripe.
| Що сталося | Куди повертається покупець |
|---|---|
| Оплатив або почав відкладену оплату (SEPA) | Сторінка успішного замовлення |
| Натиснув «Назад» на сторінці Stripe | Оформлення замовлення без повідомлення: кошик і дані на місці, замовлення непідтверджене. Можна сплатити ще раз або обрати інший спосіб |
| Повернувся без оплати | Оформлення з «Оплату не завершено. Спробуйте ще раз або оберіть інший спосіб оплати…» |
| Сторінку оплати не вдалося відкрити | Лишається в магазині з «Не вдалося відкрити сторінку оплати…» і кнопкою «Оплатити» |
Які способи видно на сторінці Stripe, вмикаєте ви в кабінеті Stripe: Settings → Payments → Payment methods. Модуль їх не обмежує: Stripe показує ввімкнені способи, що підходять до країни покупця й валюти.
Сума йде у валюті замовлення, без перерахунку. Чи приймає ваш обліковий запис цю валюту, видно в кабінеті Stripe.
Мова сторінки — основна мова магазину, якщо Stripe її знає: англійська, німецька, польська, французька та інші мови ЄС. Української Stripe не має, тож для неї сторінка відкривається мовою браузера покупця.
Для яких замовлень показувати
Блок «Де показувати» обмежує, кому Stripe видно:
- «Географічна зона» — оплата лише для покупців з адресою в цій зоні; «Усі зони» — для всіх.
- «Мінімальна сума замовлення» — Stripe з'являється від цієї суми в основній валюті магазину. Порожньо або
0— завжди. Суми, менші приблизно за 0,50 EUR чи USD, Stripe не приймає сам. - «Порядок сортування» — місце в списку оплат, менше число стоїть вище.
Статуси замовлення
Статус ставить магазин сам, коли Stripe повідомляє про подію. Які саме — обираєте в блоці «Статуси замовлення».
1
Оплачено2
Чекає на підтвердження банку3
Оплата не пройшла4
Повернуто5
Оскаржено покупцем- Stripe підтвердив оплату повної суми.
- SEPA та інші відкладені способи, поки банк підтверджує.
- Банк не підтвердив відкладену оплату.
- Після повернення всієї суми.
- Покупець оскаржив оплату в банку, типово статус не змінюється.
| Поле | Коли ставиться | Типово |
|---|---|---|
| Оплачено | Stripe підтвердив оплату повної суми замовлення. Покупцю йде звичайний лист про замовлення | «В обробці» |
| Чекає на підтвердження банку | SEPA та інші відкладені способи: покупець сплатив, банк підтверджує до кількох робочих днів | «Очікує» |
| Оплата не пройшла | Банк не підтвердив відкладену оплату | «Помилка оплати» |
| Повернуто | Покупцю повернули всю суму | «Кошти повернено» |
| Оскаржено покупцем | Покупець оскаржив оплату у своєму банку (чарджбек) | «— не змінювати статус —» |
Поки покупець не заплатив, замовлення лишається непідтвердженим. Нова спроба оплати закриває попередню сторінку Stripe: двічі сплатити зі старої вкладки не вийде.
Відкладену оплату видно за статусом «Чекає на підтвердження банку». Не відвантажуйте, доки модуль не поставить «Оплачено».
Спір із сумою і причиною видно в кабінеті Stripe, там же дається відповідь. Якщо в «Оскаржено покупцем» лишити «— не змінювати статус —», статус замовлення не зміниться.
Коли статус не змінюється
- Сума не та. Покупець змінив кошик після переходу на оплату і сплатив стару суму. Гроші надійшли, але замовлення лишається непідтвердженим — звірте суму в кабінеті Stripe.
- Друга оплата. Покупець заплатив за вже оплачене замовлення. Дві оплати одного замовлення видно в кабінеті Stripe: зайву поверніть.
- Не той режим. Тестова оплата, коли магазин у бойовому режимі, замовлення не оплачує: гроші не надходили. Бойова, коли магазин у тестовому, — теж, хоча гроші справжні: знайдіть її в кабінеті Stripe.
- Підроблене повідомлення. Модуль перевіряє підпис секретом вебхука і перепитує в Stripe суму, валюту й режим. Чуже повідомлення замовлення не змінить.
- Замовлення вже оплачене. Відкладена оплата чи її відмова не перекривають статус «Оплачено».
Повернення грошей у картці замовлення
Замовлення з сайту приходить у документи «Замовлення покупця» в Elbuz з видом оплати «Банківська карта». У його картці є блок «Платіж у Stripe»: стан платежу, сума, скільки списано й повернено. Там же — скільки ще можна повернути і всі спроби оплати з номером у Stripe.
Кнопки — лише ті, що доступні замовленню зараз:
| Кнопка | Що робить |
|---|---|
| Повернути кошти | Повертає покупцю всю суму або частину. Поле суми вже заповнене залишком: щоб повернути все, лишіть запропоновану суму |
| Оновити статус | Бере стан платежу з Stripe, якщо повідомлення не дійшло |
Повертати можна кілька разів, але не більше, ніж лишилось. Stripe проводить повернення кілька хвилин: сума в дорозі вже не входить у «Можна повернути».
| Повернення | Що буде із замовленням |
|---|---|
| Усієї суми | Статус з поля «Повернуто» |
| Частини | Статус той самий; повернену суму видно в блоці «Платіж у Stripe» |
| Stripe відмовив | Статус той самий; причину покаже повідомлення в картці замовлення |
Перед поверненням програма питає підтвердження з попередженням «Цю операцію не можна скасувати.». Статус замовлення змінюється так само, як після повідомлення Stripe, а в історії замовлення з'являється запис з результатом.
Магазин не відповів — програма напише «Невідомо, чи пройшла операція…» і покаже «Повторити». Вона повторює ту саму операцію: гроші вдруге не рухнуться. Нове натискання кнопки — це вже нова операція.
Повертати гроші може лише користувач із правом «Операції оплати: повернення, холд, кредит» — типово власник. «Оновити статус» доступне всім, хто бачить замовлення.
На картку гроші йдуть одразу і доходять до покупця за 5–10 днів. Повернення SEPA і банківських способів триває кілька днів: статус «Повернуто» з'явиться, коли Stripe його завершить. Лист про повернення покупцю магазин не надсилає.
Повернення, зроблене самостійно в кабінеті Stripe, модуль не відстежує: статус замовлення змініть самі.
Коли через Stripe вже були замовлення, шапка екрана модуля показує їх за 30 днів: кількість, суму, середній чек і частку скасованих чи повернених.
Сценарії
Побутова техніка: покупці з Нідерландів платять через свій банк
У кабінеті Stripe ввімкніть iDEAL і Bancontact, ціни на вітрині — в євро. Покупець з Амстердама бачить iDEAL на сторінці Stripe і платить у застосунку банку. Пральна машина стає «Оплачено» без вашої участі.
Монітори для фірми з Австрії: оплата з рахунку
Увімкніть SEPA Direct Debit у кабінеті Stripe. У «Чекає на підтвердження банку» оберіть статус, за яким склад не відвантажує. Фірма вводить IBAN, а за кілька днів замовлення само стане «Оплачено» чи «Оплата не пройшла».
Одяг: оплата з телефону без введення картки
Перевірте, що в кабінеті Stripe увімкнено Apple Pay і Google Pay. «Порядок сортування» — менше, ніж у інших оплат, наприклад 0: Stripe стане першим. Покупець з iPhone платить Apple Pay, не вводячи картку.
Вітрина в доларах для США поруч із євро
Додайте валюту USD у магазин і ввімкніть у кабінеті Stripe потрібні американські способи. Покупець зі США платить у доларах, європейський — у євро. Модуль один на обидва ринки.
Що робити, коли оплата не працює
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| Покупець не бачить Stripe при оформленні | Модуль вимкнено, немає секретного ключа поточного режиму, сума менша за мінімальну або адреса не в гео-зоні | Перевірте «Увімкнено», ключі поточного режиму, «Мінімальна сума замовлення» і «Географічна зона», потім «Зберегти» |
| Покупець бачить «Не вдалося відкрити сторінку оплати» | Stripe не прийняв ключ, валюту замовлення або надто малу суму | Вставте ключ ще раз з кабінету Stripe. Не допомогло — служба підтримки Elbuz подивиться відповідь Stripe в журналі модуля |
| Оплата пройшла, а статус не змінився | Неправильний секрет вебхука, вебхук створено в іншому режимі чи з іншою адресою, адресу закриває захист сайту | Для цього замовлення натисніть «Оновити статус» у його картці в Elbuz. Скопіюйте Signing secret ще раз. Перевірте адресу й події вебхука в кабінеті Stripe: Workbench → Webhooks → ваш вебхук → Event deliveries |
| Біля ключа — «Тестовий ключ починається з sk_test_…», «Бойовий ключ починається з sk_live_…» або «Секрет підпису починається з whsec_.» | Ключ іншого режиму або вставлено з пробілом чи не повністю | Тестовий ключ — sk_test_…, бойовий — sk_live_…, секрет вебхука — whsec_…. Копіюйте кнопкою в кабінеті Stripe |
| Повернули всю суму, а статус не став «Повернуто» | Повернення з рахунку, а не на картку, ще в Stripe | Зачекайте: статус зміниться, коли Stripe завершить повернення. Хід повернення видно в кабінеті Stripe |
| «Магазин не прийняв налаштування» або «Магазин не прийняв частину значень — див. позначені поля» | Магазин не відповів або відхилив окремі поля | Виправте позначені поля і збережіть. Якщо полів не позначено, зміни підуть із наступним вивантаженням |
Часті запитання
Чи можна підключити Stripe фірмі з України?
Модуль працює з будь-яким обліковим записом Stripe. Чи відкриє Stripe обліковий запис вашій фірмі, вирішує Stripe за країною її реєстрації.
Чи потрібен публікований ключ pk_…?
Ні. Сторінку оплати показує сам Stripe, тож магазину досить секретного ключа й секрету вебхука.
Що буде, якщо вимкнути модуль?
Stripe зникне з оформлення замовлення. Ключі й налаштування зберігаються: увімкнете знову — усе на місці.
Чи можна надіслати покупцю посилання на оплату Stripe з Elbuz?
Так, але це окреме підключення Stripe в Elbuz, зі своїм ключем і своєю адресою повідомлень: Оплата за посиланням.
У списку «Географічна зона» немає потрібної зони — що робити?
Зону, наприклад «Нідерланди», створює служба підтримки Elbuz. Потім оберіть її в блоці «Де показувати».
Як повернути гроші покупцю?
Відкрийте замовлення в Elbuz і в блоці «Платіж у Stripe» натисніть «Повернути кошти». Поле суми вже заповнене залишком: для часткового повернення впишіть меншу. Лист про повернення покупцю магазин не надсилає.
Де це і хто має доступ
- Меню
- Довідники → Операції → Налаштування магазину → «Оформлення і оплата» → Stripe
- Право доступу
- вікно «Налаштування магазину» в «Правах груп»; повернення — право «Операції оплати: повернення, холд, кредит»
- Підготувати
- обліковий запис Stripe, секретний ключ і вебхук для кожного режиму
Суміжні теми
- Якщо треба зрозуміти, як працює вікно налаштувань магазину — Налаштування магазину.
- Якщо покупці з Балтії звикли до Paysera — Як приймати оплату Paysera в магазині.
- Якщо треба виставити рахунок і отримати оплату за посиланням — Оплата за посиланням.
- Якщо треба обробити оплачене замовлення в Elbuz — Замовлення покупця.
