SDKs
n1co's libraries for your server and your frontend. They call the API and load n1co.js for you, with types, errors and webhook verification.
- Your server creates the card session or payment intent with a server SDK and your secret key.
- The buyer's page or app uses a frontend SDK with your publishable key and the
client_secret. - Your server fulfills the order when the webhook arrives: it is the source of truth.
Server SDKs#
They run only on your server, with your sk_… secret key. Never use it in a browser or an app.
| SDK | Package | Requires |
|---|---|---|
| Node.js | @n1co/epay |
Node.js 22.12+, 24 or 26+ |
| .NET | N1co.EPay |
net8.0 or net10.0 |
| PHP | n1co/epay |
PHP 8.2+ with Composer |
Frontend SDKs#
They use your publishable key and the client_secret. Card details are typed only in n1co's frames.
| For | Package | Status |
|---|---|---|
| Bundled web apps | @n1co/elements |
0.1.0 |
| React Native | @n1co/react-native |
0.1.0 |
| Plain HTML page | n1co.js via <script> |
Reference |
Versions and environments#
The 0.1.x server SDKs follow API contract 0.10.0. Before 1.0, a minor version may change methods along with the contract.
| Environment | API | n1co.js |
|---|---|---|
| Development | https://api-epay.dev.n1co.dev |
https://elements.n1co.dev |
| Production | Arrives with the production release | Same |
The examples always pass the development host. Production values arrive with the production release.