Skip to content

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.

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.

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

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.

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.

Modern auto-updating browsers: Chrome, Edge, Firefox, Safari. Site styles do not affect the subscribe button or the widget windows.