First open the browser console: the widget logs warnings prefixed with [Neocarts].
| Symptom |
Cause |
Fix |
No button, console shows <neocarts-button …> hidden: missing or invalid … |
a required attribute is missing or invalid |
fix the attributes — Subscribe button |
| No button, nothing in the console |
the page has no shop id |
add data-shop-id or call init({ shopId }) — Embedding |
No button, console shows … is not ready |
the shop has not set up payment or delivery |
finish Payment and Delivery |
| No button, the shop configuration request returns 422 |
wrong shop id |
compare with the «Integration» tab in the panel |
| Price is 100 times lower |
amount in hryvnias |
pass kopecks: 249000, not 2490 |
| «Regular delivery with Neocarts» instead of a discount |
the shop has no discount — not an error |
set a discount in Subscriptions |
| The button is narrow where a wide one was expected |
the container is narrower than it looks, or has display: contents |
put the button in a block container of the right width |
The shopper added a subscription, but the order line is one_time |
items built without getOrderItems(), or product-id ≠ external_id |
build items with getOrderItems(lines) |
select() throws a TypeError |
interval outside the shop’s limits or unknown mode |
take values from config().intervals |
| Symptom |
Cause |
Fix |
open() rejects with Shop is not ready |
the shop has not set up payment or delivery |
finish the setup in the panel |
open() rejects with status: 404, order-missing arrives |
wrong id, the order was deleted, or it was paid/cancelled more than 24 hours ago |
create a new order |
order-missing with cancelled |
the order was cancelled in the panel |
create a new order |
| Checkout opens twice, events are duplicated |
the script is included more than once |
keep one tag in the shared template |
| The payment page does not open, CSP error |
frame-src does not allow the payment provider domain |
extend the CSP — Embedding |
| The cart is not emptied after payment |
no neocarts:paid handler |
add one — Events |
409 on PUT /v1/shop/orders/{order}/items |
the shopper already went to payment, the contents are locked |
create a new order and open it |
| Checkout in English on a Ukrainian site |
<html lang="en"> or an order with locale: en |
set lang="uk" and the right locale |
| Symptom |
Cause |
Fix |
window.NeocartsSubscription is undefined |
your code runs before the script |
wait for neocarts:ready |
| The script or requests are blocked |
CSP does not allow cdn.neocarts.com / core.neocarts.com |
extend the CSP |
| System font |
Google Fonts blocked |
allow fonts.googleapis.com and fonts.gstatic.com |
| «Too many requests — wait a minute and try again.» |
more than 60 requests/min from one IP address |
wait a minute; do not call config() in a loop |
Write to [email protected]: shop id, the order number (number), the time and a screenshot of the console.