Документація
Нативний шлюз і «верифіковані» статуси
Швидкий старт новеАрхітектураШлюзиHTTP APIПередоплата і правилаФіскалізаціяСповіщення і CRMПосилання на оплатуАналітика новеПольщаНативний шлюз ShopifyБезпека нове
Що саме бачить Shopify зараз, чому цього достатньо для бухгалтерії, і який шлях до оплати всередині чекауту.
Що пише Місток у Shopify
| Мутація | Результат | Обмеження |
|---|---|---|
orderCreateManualPayment(amount, paymentMethodName) | транзакція SALE з назвою методу («plata by mono», «Przelewy24»…), статус Paid або Partially paid; у звітах Finance → Payments видно окремим рядком | amount для часткових оплат — лише на Plus; на інших планах Місток відступає до orderMarkAsPaid для повної оплати |
orderMarkAsPaid | SALE/CAPTURE на весь залишок, gateway «manual» | без назви методу |
теги mistok-paid, mono:<id>, нотатки | зв’язок із платежем у кабінеті банку для звірки |
Інакше неможливо: Admin API не дозволяє створити транзакцію зі стороннім gateway — це право лише платіжних застосунків. Fraud analysis Shopify працює тільки з картковими платежами, які Shopify сам верифікує; для ручних методів його немає (антифрод — на стороні банку).
Шлях до оплати всередині чекауту (Payments Apps API)
- Зареєструвати Shopify Partner-організацію на юрособу (ТОВ/ФОП, естонська OÜ тощо).
- Подати Payments Platform Application (програма invitation-only; критерії не опубліковані; відповіді чекають від тижнів до 6+ місяців).Українські інтегратори схвалення отримували: TradeMinister, CartDNA/Nabeyond — їхні plata by mono / LiqPay / WayForPay / Portmone працюють як payments apps.
- Підготувати PCI DSS SAQ-A, політику ризиків, SLA 99,95 % і реакцію на інциденти за 2 год (вимоги Partner Agreement, частина C.4).
- Після схвалення — підписати revenue share (відсоток конфіденційний; інвойси від $150 000 GMV/міс).
- Побудувати offsite payments extension:
payment_session_url,refund_session_url, capture/void, mTLS, ідемпотентність, резолв сесій мутаціямиpaymentSessionResolve/Reject. - Тест у dev-store у test mode → рев’ю застосунку (2–6 тижнів) → Hidden-стан: встановлення за install-URL, активація мерчантом у Settings → Payments.
- Власну комісію (як «0,4 % developer fee» у TM) білити поза Shopify — у Partner Dashboard механізму немає.
Ціна для мерчанта: third-party fee Shopify 2 % (Basic) / 1 % (Grow) / 0,6 % (Advanced) + комісія PSP. Для ручного способу (Місток) third-party fee — 0 %.
Що доступно за планами
| Можливість | Basic / Grow / Advanced | Plus |
|---|---|---|
| Ручні способи оплати, Thank-you / Order-status extensions | так | так |
| Extensions на кроках Information / Shipping / Payment | ні | так |
| Payment Customization (сховати/перейменувати метод за умовою) | лише через публічний App Store-застосунок | так, і custom app |
| Pickup points (відділення НП) у чекауті через Functions | ні | custom app |
Часткова оплата через orderCreateManualPayment(amount) | лише повна | так |
| Payments app (нативний шлюз) | так, якщо застосунок схвалено | так |
Практичний висновок: тримайте Місток як робочий контур зараз і подавайте заявку в Payments Platform паралельно — код шлюзів і логіка статусів перевикористовуються в payments extension.