NextPay Docs

Create a device code for CLI authentication

Field	Type	Required	Description
`intent`	`string`	No

Example Request

{
  "intent": "login"
}

200 — Device code created

Field	Type	Required
`code`	`string`	Yes
`verification_url`	`string`	Yes
`expires_at`	`number`	Yes

{
  "code": "A1B2C3",
  "verification_url": "https://nextpay-v3-dev.nextfinancial.io/auth/device?code=A1B2C3",
  "expires_at": 1742472000
}

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"intent":"login"}' \
  https://api.nextpay.world/v1/auth/device-code

Poll device code status

Parameter	Type	Required	Description
`code`	`string`	Yes	The 6-character device code

200 — Device code status

Field	Type	Required	Description
`status`	`string`	Yes
`token`	`string`	No

{
  "status": "pending"
}

curl \
  https://api.nextpay.world/v1/auth/device-code/A1B2C3

Exchange API key for a session JWT

Send a Bearer token in the Authorization header with an API key (npk_...) to receive a JWT.

200 — JWT token

Field	Type	Required	Description
`ok`	`boolean`	Yes
`data`	`object`	Yes

{
  "ok": true,
  "data": {
    "token": "eyJhbGciOiJSUzI1NiIs...",
    "user_id": "usr_abc123"
  }
}

401 — Invalid API key

Field	Type	Required	Description
`ok`	`boolean`	Yes
`error`	`object`	Yes

{
  "ok": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}

curl -X POST \
  https://api.nextpay.world/v1/auth/token

Get current authenticated user

Authentication: Bearer token required

200 — Current user info

Field	Type	Required	Description
`ok`	`boolean`	Yes
`data`	`object`	Yes

{
  "ok": true,
  "data": {
    "id": "usr_abc123",
    "email": "don@nextfinancial.io",
    "name": "Don Masakayan"
  }
}

401 — Not authenticated

Field	Type	Required	Description
`ok`	`boolean`	Yes
`error`	`object`	Yes

{
  "ok": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Not authenticated"
  }
}

curl \
  -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.nextpay.world/v1/auth/me

Auth