Skip to content

Troubleshooting

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.