API reference overview
The NogorPay API is a small REST API for creating hosted checkout charges and checking their status.
Base URL
Section titled “Base URL”https://api.nogorpay.com/api/v1Headers
Section titled “Headers”| Header | Required | Value |
|---|---|---|
NOGORPAY-API-KEY |
Yes | Your secret API key, for example sk_live_... |
Content-Type |
For POST |
application/json |
Endpoints
Section titled “Endpoints”| Method | Path | What it does |
|---|---|---|
GET |
/charge/methods |
List payment methods active for a brand |
POST |
/charge/create |
Create a charge and get a hosted checkout payment_url |
GET |
/charge/verify/{id} |
Verify a charge by invoice, order or session ID |
NogorPay also calls your server: see Webhook events.
Responses
Section titled “Responses”Every response is JSON with a boolean success field.
{ "success": false, "message": "amount is required in request body"}See Errors for status codes and how to handle them.
Identifiers
Section titled “Identifiers”| ID | Format | Example | Set by |
|---|---|---|---|
invoice_id |
INV- + 8 characters |
INV-7K9X2P8M |
NogorPay, or you when you pass invoice_id |
order_id |
Any string | ORDER-1042 |
You |
session_id |
cs_live_ + 32 hex characters |
cs_live_3f2a9c0e... |
NogorPay |
brand_id |
6 characters | B9X7K2 |
NogorPay (shown in your dashboard) |
