↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Інтернет-магазин Elbuz CMS
    4. Оплата

    Як приймати оплату Stripe в магазині

    10 хв читанняОновлено

    Оплата Stripe переводить покупця на захищену сторінку Stripe: картка, Apple Pay, Google Pay, Klarna, iDEAL, BLIK, SEPA та інші способи його країни. Магазин сам дізнається результат від Stripe і ставить замовленню статус.

    Коли це знадобиться:

    • Ви продаєте в ЄС, Велику Британію чи США — Stripe показує покупцю способи його країни.
    • Покупець платить з рахунку через SEPA — замовлення чекає підтвердження банку і стає оплаченим саме.
    • Покупець змінив кошик після переходу на оплату — оплата іншої суми не стане «Оплачено».
    • Покупець оскаржив оплату в банку — замовлення отримає статус, який ви оберете.

    З чого почати: «Налаштування магазину» → «Оформлення і оплата» → Stripe → ключі, адреса вебхука й перемикач «Увімкнено».

    Що вміє оплата Stripe

    Як підключити Stripe

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

    1. Відкрийте екран модуля. «Налаштування магазину» → розділ «Оформлення і оплата» → картка Stripe.
    2. У блоці «Підключення» лиште «Тестовий режим» увімкненим і скопіюйте «Адреса вебхука».
    3. Створіть вебхук у кабінеті Stripe з цією адресою і подіями з поля «Події вебхука» (нижче).
    4. У картці «Тестові ключі» впишіть «Тестовий секретний ключ» і «Тестовий секрет підпису вебхука».
    5. Увімкніть перемикач «Увімкнено» вгорі екрана і натисніть «Зберегти».
    6. Перевірте тестовою оплатою, потім перейдіть на бойовий режим.
    Розділ «Оформлення і оплата» у вікні «Налаштування магазину» з карткою Stripe
    1Картка Stripe
    2Позначка стану
    1. Картка модуля оплати Stripe — клік відкриває його екран.
    2. Чого бракує модулю: «потрібні ключі», поки не вписано ключі поточного режиму.
    Екран модуля Stripe, розгорнутий на весь стіл
    1Перемикач «Увімкнено»
    2Тестовий режим
    3Адреса вебхука
    4Що ще не налаштовано
    5Режим
    1. Показує Stripe покупцям після збереження.
    2. Тестові оплати без списання грошей, працює пара тестових ключів.
    3. Цю адресу вписують у вебхук у кабінеті Stripe.
    4. Чого бракує, щоб оплата працювала.
    5. У якому режимі зараз працює оплата.

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

    Ключ не того режиму, наприклад 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 надсилає повідомлення про оплати й повернення. Без нього магазин не дізнається, що покупець заплатив.

    1. У кабінеті Stripe: Workbench → Webhooks → Create an event destination.
    2. Оберіть Your account, формат подій Snapshot.
    3. Відмітьте всі 9 подій з поля «Події вебхука». Кнопка «Копіювати всі» скопіює їх разом.
    4. Тип — Webhook endpoint. У Endpoint URL вставте «Адреса вебхука» з екрана модуля і збережіть.
    5. На сторінці вебхука натисніть Reveal біля Signing secret і скопіюйте whsec_… у поле секрету підпису.
    Блок «Підключення» з вебхуком і картка «Тестові ключі»
    1Адреса вебхука
    2Події вебхука
    3Тестовий секретний ключ
    4Тестовий секрет підпису вебхука
    5працює зараз
    1. Вставте в Endpoint URL вебхука в кабінеті Stripe.
    2. Події, які треба відмітити у вебхуку, копіюються разом.
    3. Secret key з Developers → API keys у тестовому режимі (sk_test_…).
    4. Signing secret тестового вебхука (whsec_…).
    5. Пара ключів, яка працює в поточному режимі.

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

    Ключі після збереження не показуються — у полі видно лише, що їх задано. Щоб змінити, натисніть «Замінити» і впишіть новий.

    Як перевірити тестовою оплатою

    1. Оформіть замовлення на себе й оберіть Stripe. Над переходом буде «Тестовий режим (Stripe): гроші не списуються».
    2. На сторінці Stripe оплатіть тестовою карткою з таблиці. Термін — будь-яка майбутня дата, CVC — будь-які три цифри.
    3. Перевірте замовлення в Elbuz: статус з поля «Оплачено». Саму оплату видно в кабінеті Stripe в тестовому режимі.
    Тестові дані 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 і замовлення в євро.

    Перехід на бойовий режим

    Поки тестовий режим увімкнено, праворуч висить «Увімкнено тестовий режим — гроші не списуються. Вимкніть перед продажами». Щоб приймати справжні гроші:

    1. У кабінеті Stripe завершіть активацію: Activate payments, дані фірми й рахунок для виплат.
    2. Створіть вебхук у бойовому режимі кабінету.
    3. У картці «Бойові ключі» впишіть «Бойовий секретний ключ» і «Бойовий секрет підпису вебхука».
    4. Вимкніть «Тестовий режим» і натисніть «Зберегти». Рядок «Режим» праворуч покаже «Бойовий режим».

    Після перемикання магазин сам закриває в 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Оскаржено покупцем
    1. Stripe підтвердив оплату повної суми.
    2. SEPA та інші відкладені способи, поки банк підтверджує.
    3. Банк не підтвердив відкладену оплату.
    4. Після повернення всієї суми.
    5. Покупець оскаржив оплату в банку, типово статус не змінюється.
    ПолеКоли ставитьсяТипово
    Оплачено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, секретний ключ і вебхук для кожного режиму

    Суміжні теми

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно