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

National Database & Registration Authority · 身份

Pak Identity 是巴基斯坦国家数据库与登记局（NADRA）推出的官方公民身份应用；NADRA 是负责维护全国民事登记、签发计算机化国民身份证（CNIC）的政府机构。公民以 CNIC 号码登录后，可直接在手机上申请或续办 CNIC、NICOP（海外巴基斯坦人身份证）以及 CRC（儿童登记证）。已签发的证件存放在手机内的数字身份保险库中，无需携带实体卡即可出示 CNIC 或 NICOP；家谱屏则列出与用户登记档案关联的亲属及其家庭数字身份。需要到场办理时，可在预约屏选定 NADRA 登记中心的时段进行现场采集，并在结账屏通过银行卡或 Raast 二维码缴纳申请费。它既服务巴基斯坦境内的公民，也服务依赖 NICOP 的海外侨民，与印度的 Aadhaar 应用和 DigiLocker、沙特的 Absher、新加坡的 Singpass 以及 UAE PASS 同属国家级身份应用。

13 位 CNIC 号码以 citizenNumber 字段出现，把公民档案、身份证件与家庭关联串在一起。登录档案将该号码与 fullName、email、mobileNumber 及 verificationStatus 核验标志配对，并附带 digitalCardEnabled、familyTreeEnabled、familyIDCardFeatureEnabled 等功能开关，标明该公民已解锁哪些 NADRA 服务。数字保险库把非实体 CNIC 与 NICOP 证件存为标签化记录——label、含证件类型的 identifiers 块，以及由 key、title、value 组成、涵盖姓名、父亲姓名、出生日期与有效期的 displayData 行——状态提示还通过 message_local 以乌尔都语返回。家庭关联则按 citizenNumber、name、relation（配偶、儿子等）与 photograph 列出每位亲属。

登记中心的接待能力按时段给出：slotId、startTime、endTime、capacity、booked 与 available；每笔 CNIC、NICOP 或 CRC 申请费都以结账记录返回，含 currency（PKR）、fee、status 及托管的 initPaymentUrl，并与申请的追踪编号对应。

金融科技钱包与移动运营商可在开通钱包或 SIM 前基于已核验档案完成 KYC 开户；身份保险库与核验方可凭证件记录呈现 CNIC 或 NICOP，无需实体卡；信贷与社会保障系统可用家庭关联把赡养人与家庭名册比对；公民服务台可轮询时段余量，并按追踪编号对账申请费。openData Studio 将这套 NADRA 民事登记数据变成可直接调用的开放数据，服务上述集成。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

公民登录（创建会话）

POST /v1/citizen/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/citizen/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/citizen/session/refresh/{refreshToken} osint
用存储的 refreshToken 换取新的 JWT（token）与轮换 refreshToken，供后续每个公民调用使用。
认证方式：路径参数 refreshToken 来自登录响应（存为 refresh_token）。返回的新令牌用作 Authorization: Bearer。
- email
- token
- refreshToken
```
GET /v1/citizen/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 通道。

与 Pak Identity 相似的应用

Aadhaar App — 印度 UIDAI 官方应用，居民可在手机上保存数字 Aadhaar、生成虚拟 ID，并通过二维码出示身份，无需复印件。
DigiLocker — DigiLocker 是印度政府的数字证件钱包，用于存储、分享和核验 Aadhaar、PAN、驾照及其他官方证件的电子副本。
Absher — Absher 是沙特内政部的官方应用，用于国民身份证续期、家庭民事档案以及身份证件电子版。
Singpass — Singpass 是新加坡国家数字身份，用于登录政府和商业服务，并在柜台出示电子身份证（Digital IC）。
VNeID — VNeID 是越南公安部的数字身份应用，其电子凭证效力等同于公民身份证，用于办理政务服务。
eGovPH — eGovPH 是菲律宾政府超级应用，可存放与实体 PhilID 具同等法律效力的数字国家身份证（PhilSys）。
UAE PASS — UAE PASS 是阿联酋国家数字身份与电子签名应用，内置保险库可存放阿联酋身份证及其他官方证件。

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

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

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

获取报价

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

应用截图

API 端点一览

公民登录（创建会话）

续期访问令牌

获取数字身份证件

获取家庭数字身份成员

列出可预约的 NRC 时段

发起申请费支付

数据类别

数据使用场景与案例

公民身份开户核验

数字身份证件展示

家庭 / 家谱匹配

NRC 预约与费用对账

常见问题

与 Pak Identity 相似的应用

更多身份类应用

Duo Mobile

GOSI

VR SecureGo plus

相关主题

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

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

应用截图

API 端点一览

公民登录（创建会话）

续期访问令牌

获取数字身份证件

获取家庭数字身份成员

列出可预约的 NRC 时段

发起申请费支付

数据类别

数据使用场景与案例

公民身份开户核验

数字身份证件展示

家庭 / 家谱匹配

NRC 预约与费用对账

常见问题

相关应用

与 Pak Identity 相似的应用

更多身份类应用

Duo Mobile

GOSI

VR SecureGo plus

相关主题

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