NepzioDevelopers
Menu

Data formats

Money

Amounts are objects with the amount in the currency's smallest unit (paisa for Nepali rupees) and an ISO 4217 code:

{ "amount": 150000, "currency": "NPR" }

This is Rs. 1,500. Divide by 100 to show rupees.

When you send an amount, use the same shape. Stores keep whole rupees, so the amount must be a multiple of 100, in NPR. Anything else gets 422 with code invalid_money.

Times

Times are ISO 8601 in UTC: 2026-11-10T08:15:00Z. A store's own days (reports, ordering hours) follow its timezone, Asia/Kathmandu for Nepal.

Ids

Ids are UUIDs as strings. They never change and are never reused. Store them as strings.

Objects

  • object: every object says what it is ("object": "order"), and every list is "object": "list".
  • Field names are snake_case.
  • null means no value. Fields documented as always present are always present.

Things that may grow

Within v1, Nepzio may add things at any time. Your code should ignore what it doesn't recognise rather than fail:

  • new fields on objects;
  • new values in lists of choices (an order source, a payment_method, an error code);
  • new endpoints and webhook events.

Nothing is removed or renamed within v1. See Versioning.