Pak Identity 数据 API：公民证件、家谱与缴费

National Database & Registration Authority · 身份

Pak Identity 是 NADRA 的公民身份应用，办理 CNIC 与 NICOP 申请、数字身份证、家庭档案与登记中心预约。/v1/auth/session 登录调用返回会话令牌与公民资料；/v1/id-wallet/documents 从保险库加载非实体身份证件，/v1/id-wallet/family 按 CNIC 列出家庭成员，/v1/appointments/slots 查找可预约时段，/v1/payments/checkout 发起费用结账。

Pak Identity 是 NADRA（巴基斯坦国家数据库与登记局）的官方公民身份应用，覆盖 CNIC、NICOP、CRC 与家谱服务。公民在 /v1/auth/session 登录后，会话返回 JWT 与资料开关（digitalCardEnabled、familyTreeEnabled），应用随后从数字保险库加载非实体身份证件（/v1/id-wallet/documents）、按 CNIC 列出家庭成员（/v1/id-wallet/family）、查询登记中心预约时段（/v1/appointments/slots），并通过银行卡或 QR 通道完成申请费结账（/v1/payments/checkout）。后续调用以 Authorization: Bearer 携带会话令牌。

应用截图

API 端点一览

公民登录（创建会话）
POST /v1/auth/session osint
将公民登录进 Pak Identity，返回 JWT、refresh token、CNIC（citizenNumber）与功能开关，解锁数字卡、家谱及其他 NADRA 服务。
认证方式：无需鉴权的登录调用。响应令牌存为 access_token，后续调用以 Authorization: Bearer 携带；续期使用会话刷新调用。
- citizenNumber
- fullName
- email
- mobileNumber
- token
- refreshToken
- sessionKey
- deviceId
- digitalCardEnabled
- familyTreeEnabled
- familyIDCardFeatureEnabled
- verificationStatus
- pakidUser
依据应用界面重构的示意示例，并非实时抓包。
```
POST /v1/auth/session HTTP/1.1
Content-Type: application/json

{
  "username": "3520212345671",
  "password": "********",
  "deviceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
```
```
{
  "citizenNumber": "3520212345671",
  "fullName": "AHMED ALI",
  "email": "[email protected]",
  "mobileNumber": "03001234567",
  "token": "eyJhbGciOiJIUzI1NiJ9...",
  "refreshToken": "d8f1c2e4-9a1e-4c2b-8f01-55c17a91f0e2",
  "sessionKey": "3f2b8c1d9a1e4c2b",
  "deviceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "digitalCardEnabled": true,
  "familyTreeEnabled": true,
  "familyIDCardFeatureEnabled": true,
  "verificationStatus": "VERIFIED",
  "pakidUser": true
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的公民登录与会话引导流程重建。
- 捕获后续每个调用都依赖的令牌与功能开关。
续期访问令牌
GET /v1/auth/session/refresh/{refreshToken} osint
用存储的 refreshToken 换取新的 JWT（token）与轮换 refreshToken，供后续每个公民调用使用。
认证方式：路径参数 refreshToken 来自登录响应（存为 refresh_token）。返回的新令牌用作 Authorization: Bearer。
- email
- token
- refreshToken
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/auth/session/refresh/d8f1c2e4-9a1e-4c2b-8f01-55c17a91f0e2 HTTP/1.1
```
```
{
  "email": "[email protected]",
  "token": "eyJhbGciOiJIUzI1NiJ9...",
  "refreshToken": "c9e2b1a0-7d4f-41aa-90ee-22b10c88aa11"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的会话续期流程重建。

获取数字身份证件

GET /v1/id-wallet/documents opendata

返回公民的非实体身份证件（CNIC/NICOP 及相关卡证），以带标识与展示字段的标签化记录形式供数字保险库屏使用。

认证方式： Authorization: Bearer 令牌，来自登录调用（或其续期）。

message
status
message_local
data
label
identifiers
displayData
key
title
value

依据应用界面重构的示意示例，并非实时抓包。

GET /v1/id-wallet/documents HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...

{
  "message": "OK",
  "status": "SUCCESS",
  "message_local": "کامیاب",
  "data": [
    {
      "label": "CNIC",
      "identifiers": {
        "citizenNumber": "3520212345671",
        "documentType": "CNIC"
      },
      "displayData": [
        {"key": "name", "title": "Name", "value": "AHMED ALI"},
        {"key": "fatherName", "title": "Father Name", "value": "MUHAMMAD ALI"},
        {"key": "dateOfBirth", "title": "Date of Birth", "value": "1990-03-14"},
        {"key": "expiryDate", "title": "Expiry", "value": "2030-03-14"}
      ]
    }
  ]
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据应用的数字身份保险库屏重建。

获取家庭数字身份成员
GET /v1/id-wallet/family osint
列出与登录公民数字身份关联的家庭成员，各含 CNIC、姓名、关系与照片，供家谱与家庭数字身份屏使用。
认证方式： Authorization: Bearer 令牌，来自登录调用。
- citizenNumber
- name
- relation
- photograph
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/id-wallet/family HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
```
```
[
  {
    "citizenNumber": "3520298765432",
    "name": "FATIMA ALI",
    "relation": "SPOUSE",
    "photograph": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
  },
  {
    "citizenNumber": "3520211122233",
    "name": "HASSAN ALI",
    "relation": "SON",
    "photograph": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
  }
]
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的家谱与家庭数字身份屏重建。
列出可预约的 NRC 时段
GET /v1/appointments/slots opendata
返回登记中心可预约的时段，公民可先锁定再预约 CNIC/NICOP 采集。
认证方式： Authorization: Bearer 令牌，来自登录调用。查询参数 centerId 与 date 选定登记中心。
- success
- message
- validationErrors
- data
- slotId
- startTime
- endTime
- capacity
- booked
- available
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/appointments/slots?centerId=LHR-NRC-12&date=2026-10-02 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
```
```
{
  "success": true,
  "message": "Slots available",
  "validationErrors": null,
  "data": [
    {
      "slotId": "SLOT-4412",
      "startTime": "09:00",
      "endTime": "09:20",
      "capacity": 8,
      "booked": 3,
      "available": true
    }
  ]
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的预约流程重建。
发起申请费支付
POST /v1/payments/checkout openfinance
为 CNIC/NICOP/CRC 申请费发起银行卡结账，返回 currency、fee 与托管的 initPaymentUrl。QR 通道走同族的 QR 初始化调用。
认证方式： Authorization: Bearer 令牌，来自登录调用。
- currency
- fee
- initPaymentUrl
- message
- status
依据应用界面重构的示意示例，并非实时抓包。
```
POST /v1/payments/checkout HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Content-Type: application/json

{
  "trackingId": "TID-20261002-88421",
  "citizenNumber": "3520212345671",
  "paymentSource": "CARD"
}
```
```
{
  "currency": "PKR",
  "fee": "1500.00",
  "initPaymentUrl": "https://payments.example.pk/checkout/sess_9f3c",
  "message": "Payment session created",
  "status": "PENDING"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用的申请费结账流程重建。

数据类别

公民身份
数字身份证件
家谱
预约
申请费用

数据使用场景与案例

公民身份开户核验
KYC 或开户流程可消费登录响应中的 citizenNumber、fullName、email、mobileNumber 与 verificationStatus（外加 digitalCardEnabled），在开通钱包或 SIM 前确认巴基斯坦公民身份。
数字身份证件展示
身份保险库或核验方可从 /v1/id-wallet/documents 拉取证件记录——label、identifiers.citizenNumber 与 displayData 的 key/title/value——无需实体卡即可呈现 CNIC/NICOP。
家庭 / 家谱匹配
信贷或社会保障系统可通过 /v1/id-wallet/family 的 citizenNumber、name、relation 与 photograph 列出家庭成员，把赡养人与家庭名册比对。
NRC 预约与费用对账
公民服务台可轮询可用时段（slotId、startTime、capacity），再把 /v1/payments/checkout 的申请费（currency、fee、status、initPaymentUrl）按 trackingId 登记对账。

常见问题

登录后 Pak Identity 暴露哪些身份数据？

登录响应携带 citizenNumber（CNIC）、fullName、email、mobileNumber、token、refreshToken，以及 digitalCardEnabled、familyTreeEnabled 等功能开关，后者决定应用其余能力的开放。

数字身份证件如何返回？

GET /v1/id-wallet/documents 返回证件记录的 data 数组，含 label、identifiers 与 displayData（key、title、value），供数字保险库屏展示。

同一会话能列出家庭成员吗？

可以。GET /v1/id-wallet/family 返回每位关联成员的 citizenNumber、name、relation 与 photograph，供家谱屏使用。

申请费用如何收取？

POST /v1/payments/checkout 返回 currency、fee、initPaymentUrl、message 与 status，应用据此为该 trackingId 打开银行卡结账或 QR 通道。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Pak Identity 数据 API：公民证件、家谱与缴费

应用截图

API 端点一览

公民登录（创建会话）

续期访问令牌

获取数字身份证件

获取家庭数字身份成员

列出可预约的 NRC 时段

发起申请费支付

数据类别

数据使用场景与案例

公民身份开户核验

数字身份证件展示

家庭 / 家谱匹配

NRC 预约与费用对账

常见问题

相关应用

相关主题

需要集成这个 App 的数据 API？