Місток
Документація

Передоплата, правила, failover

Швидкий старт новеАрхітектураШлюзиHTTP APIПередоплата і правилаФіскалізаціяСповіщення і CRMПосилання на оплатуАналітика новеПольщаНативний шлюз ShopifyБезпека нове

Карта способів оплати

Назва ручного способу оплати в Shopify (без урахування регістру) визначає шлюз і правило передоплати:

GATEWAY_MAP={
  "plata by mono": {"provider":"mono"},
  "покупка частинами mono": {"provider":"monoparts"},
  "оплата частинами приватбанк": {"provider":"privatparts"},
  "przelewy24": {"provider":"p24"}, "payu": {"provider":"payu"}, "stripe": {"provider":"stripe"},
  "накладений платіж + передоплата 200 грн": {"provider":"mono","prepay":20000},
  "накладений платіж + 30 %": {"provider":"mono","prepayPercent":30}
}

Передоплата записується в Shopify як часткова оплата з назвою «plata by mono (передоплата)»; замовлення стає Partially paid, решту покупець платить при отриманні.

Правила передоплати

PREPAY_RULES — масив правил; застосовується найсильніше. Умови: minTotal/maxTotal (копійки), firstOrder, country, customerTag, phoneMode, onlyCod.

PREPAY_RULES=[
  {"when":{"minTotal":500000,"onlyCod":true},"prepayPercent":50,"note":"накладений понад 5000 грн"},
  {"when":{"firstOrder":true,"country":"PL"},"prepayPercent":100,"note":"перше замовлення з Польщі"},
  {"when":{"customerTag":"vip"},"prepayPercent":0,"note":"без передоплати"}
]

Правила по телефонах

Телефон, що відмовився від посилки, додається командою Telegram /cod_off 380501234567 причина або в адмінці. Режими: prepay — лише повна передоплата; block — те саме + тег; trusted — правила не застосовуються. Чисті накладені замовлення з такого номера отримують тег cod-risk і алерт — ви дзвоните покупцю до відправки.

Failover

PROVIDER_FALLBACK={"mono":"liqpay","p24":"payu"}

Якщо API основного шлюзу відповідає 5xx або недоступне, рахунок створюється в запасному з тією ж сумою; покупець цього не помічає, ви отримуєте алерт.

Hold

PAYMENT_TYPE=hold — авторизація без списання; списання при orders/fulfilled (mono, LiqPay, WayForPay, NovaPay, PayU, Stripe). Для «частинами mono» підтвердження магазину — одразу або при відправці (MONOPARTS_CONFIRM).