Device API v1 · Integration API v1

Build on Narya

Connect payment terminals and back-office systems to Narya, the terminal management platform.

Get started API reference
$ curl -X POST https://device-narya-staging.pmadvisors.my/device/v1/activations \
  -H 'Content-Type: application/json' \
  -d '{"activation_code": "12345678",
       "device_identifier": "SN-0001"}'
201 Created
{
  "device_id": "0192f6c4-8a1e-7b3d-9c2a-5e4f1a2b3c4d",
  "credential_id": "0192f6c4-8a1f-7c11-a2b3-c4d5e6f7a8b9",
  "token": "dvc_<prefix>_<secret>",
  "issued_at": "2026-10-16T08:00:00Z"
}

Device API

For the software that runs on payment terminals and other POS hardware.

  • Activate a terminal with a one-time code
  • Report health, transactions and events
  • Receive assigned applications and parameters
Device tokendevice-narya-staging.pmadvisors.my
Read the docs

Integration API

For back offices and portals that manage merchants, enrollments and devices.

  • Create and update the merchant hierarchy
  • Enroll tradings and set up devices
  • Read devices and transactions
Integration keyapi-narya-staging.pmadvisors.my
Read the docs
Guides
Authentication, call flow, errors and retries.
Device APIIntegration API
API reference
Every operation, with a downloadable OpenAPI document.
Device APIIntegration API
Changelog
Additions, deprecations and removals.
Device APIIntegration API