Environments
| Purpose | Address |
|---|---|
| Shop API | https://core.neocarts.com/v1/shop/* |
| Widget (CDN) | https://cdn.neocarts.com/bundle.js |
| Website | https://neocarts.com |
| Support | [email protected] |
Support gives you the shop panel address and staging addresses for testing.
Rate limits
Section titled “Rate limits”Shop API requests with a valid key are not limited. Only failed authentication is: 60 attempts per minute from one IP address, after which every request from that IP gets 429 until the minute ends — even with a correct key.
CORS and CSP
Section titled “CORS and CSP”The Shop API is server-to-server only: CORS is off, so the browser blocks a call from a page.
If the site has a Content Security Policy, allow:
| Directive | Value |
|---|---|
script-src |
https://cdn.neocarts.com |
connect-src |
https://core.neocarts.com |
style-src |
https://fonts.googleapis.com |
font-src |
https://fonts.gstatic.com |
frame-src |
the shop’s payment provider domain — the payment page opens in an iframe |
Versions
Section titled “Versions”The Shop API version is in the path: /v1/shop/…. v1 is current since September 2026.
- A breaking change ships as a new major version; the previous one keeps working for 6 months after the announcement.
- New optional fields, enum values and endpoints are added to the current version. Ignore unknown JSON fields.
- The widget is not versioned: the CDN always serves the current build.
History — Changelog.
Payment sandbox
Section titled “Payment sandbox”On staging a sandbox replaces the shop’s payment provider ("payment": { "provider": "sandbox" }, «Sandbox» in the panel). No real money, no card numbers. The payment page shows the order number, the amount and four buttons:
| Button | Result |
|---|---|
| Pay and save the card | payment succeeds, renewals will go through |
| Pay with a card that will be declined on renewal | first payment succeeds, every renewal is declined (retries and a charge_failed pause) |
| Pay without saving a card | payment succeeds but the money is refunded automatically, card_not_saved |
| Decline the payment | payment_failed |
The first two buttons save the card 444444******1111 (visa). There is no sandbox on production yet.
Browsers
Section titled “Browsers”Modern auto-updating browsers: Chrome, Edge, Firefox, Safari. Site styles do not affect the subscribe button or the widget windows.