Documentation
Integrate in an afternoon
One REST API, signed webhooks and four official SDKs. The checkout and the Customers API share the same key.
- JavaScript
- Python
- PHP
- Ruby
import { Norvik } from "@norvik/sdk";
const nv = new Norvik("sk_test_4Fk9…");
// Checkout in the customer's currency; routed to the payment partner.
const payment = await nv.payments.create({
amount: 7800,
currency: "JPY",
customer: { email: "customer@example.com" },
metadata: { order: "1042" },
});
// The same key reads the customer record it created.
const customer = await nv.customers.retrieve(payment.customer);What the documentation covers
- 01
Getting started
Create an account, obtain a test key, send a first payment and switch to live mode.
- 02
API reference
Every endpoint, parameter and response for payments, refunds, payout statements, disputes and customers.
- 03
SDKs
Official libraries for JavaScript, Python, PHP and Ruby, with the same method names in each.
- 04
Guides
Multi-currency checkout, tax configuration, dispute evidence and reading payout statements, step by step.
- 05
Webhooks
Payment, payout, dispute and customer events, signed and retried, delivered to your endpoint.
- 06
Best practices
Idempotency keys, error handling, key rotation and testing against the sandbox.
Customers API
The merchant CRM is exposed through the same API as the checkout. Each payment creates or updates a customer; you can read the record, attach notes and tasks, filter by country, volume or customer age, and export the result as CSV.
Customer events (customer.created, customer.updated) are delivered by the same webhook endpoint as payment and payout events.
| Method | Path |
|---|---|
| GET | /v1/customers |
| GET | /v1/customers/{id} |
| POST | /v1/customers/{id}/notes |
| POST | /v1/customers/{id}/tasks |
| GET | /v1/customers/export |
Help
Stuck on an integration?
Write to contact@norvik.club with your account reference and the request ID. We reply within 24 hours.
NORVIK is checkout and CRM software. Payment processing, currency conversion, custody of funds, settlement, payouts and any reserve are performed by regulated third-party payment providers and acquiring partners under their own terms. NORVIK never holds, transmits or settles funds.