Kazakhstan Electronic Government services integration with SmartBridge gateway for accessing national databases and government services.

eGov Gateway

Access Kazakhstan's Electronic Government infrastructure through the SmartBridge External Gateway. Query citizen data, verify debts, process payments, and access educational records from official government databases.

Available Operations

Citizen Data: Individual information from National Database (GBDFL)
Family Records: ZAGS marriage and family information
Education: School data from National Education Database (NEDB)
Tax Services: CITS debt verification and payment processing
Business Data: Legal entity information and validation

Connection Configuration

Parameter	Type	Required	Description
`senderId`	TEXT	Yes	Sender ID for eGov gateway authentication
`password`	TEXT	Yes	Password for eGov gateway authentication
`serviceUrl`	TEXT	Yes	eGov SmartBridge gateway service URL
`apiKey`	TEXT	Yes	API key for Bearer token authentication

{
  "senderId": "{{ctx.consts.EGOV_SENDER_ID}}",
  "password": "{{ctx.consts.EGOV_PASSWORD}}",
  "serviceUrl": "{{ctx.consts.EGOV_SERVICE_URL}}",
  "apiKey": "{{ctx.consts.EGOV_API_KEY}}"
}

Operations

gbdflUniversalServiceSync

Search for individuals in Kazakhstan's National Database of Individuals (GBDFL).

Parameter	Type	Required	Description
`messageId`	TEXT	No	UUID format message identifier (auto-generated if not provided)
`senderCode`	TEXT	Yes	Sender code for interaction participant identification
`iin`	TEXT	No*	12-digit Individual Identification Number
`surname`	TEXT	No*	Individual's surname
`name`	TEXT	No*	Individual's first name
`patronymic`	TEXT	No	Individual's patronymic name
`birthDate`	TEXT	No**	Birth date in YYYY-MM-DD format
`documentNumber`	TEXT	No*	Identity document number

*At least one search criteria required: IIN, full name with birth date, or document number
**Birth date required when searching by name

{
  "senderCode": "{{ctx.consts.EGOV_SENDER_CODE}}",
  "iin": "{{ctx.user.iin}}",
  "messageId": "{{ctx.vars.requestId}}"
}

Response:

{
  "success": true,
  "responseInfo": {
    "messageId": "resp-001",
    "status": { "code": "SCSS001", "message": "Success" }
  },
  "persons": [
    {
      "iin": "123456789012",
      "surname": "ИВАНОВ",
      "name": "ИВАН", 
      "patronymic": "ИВАНОВИЧ",
      "birthDate": "1990-05-15",
      "gender": { "code": "1", "nameRu": "Мужской" },
      "citizenship": { "code": "KZ", "nameRu": "Республика Казахстан" },
      "documents": [...]
    }
  ]
}

familyInfoServiceSync

Retrieve family composition information including birth, marriage, and divorce records from ZAGS.

Parameter	Type	Required	Description
`messageId`	TEXT	No	UUID format message identifier
`iin`	TEXT	Yes	12-digit Individual Identification Number
`senderCode`	TEXT	Yes	Sender code for interaction participant

{
  "iin": "{{ctx.user.iin}}",
  "senderCode": "{{ctx.consts.EGOV_SENDER_CODE}}"
}

Response:

{
  "responseInfo": {
    "messageId": "family-resp-456",
    "status": { "code": "SCSS001", "message": "Success" }
  },
  "serviceData": {
    "birthInfos": [...],
    "marriageInfos": [...], 
    "divorceInfos": [...]
  }
}

NEDBSyncSchoolData

Get educational institution data by location code from National Education Database.

Parameter	Type	Required	Description
`messageId`	TEXT	No	UUID format message identifier
`locationCode`	TEXT	Yes	OKED format location/territory code

{
  "locationCode": "{{ctx.vars.territoryCode}}"
}

Response:

{
  "responseInfo": {
    "messageId": "nedb-resp-789",
    "status": { "code": "01", "message": "Data available" }
  },
  "schools": [
    {
      "bin": "081240003127",
      "nedbId": "19663",
      "nameRu": "КГУ \"Школа-гимназия №148\"",
      "nameKk": "\"№148 мектеп-гимназия\" КММ"
    }
  ]
}

checkDebtorByIINBIN

Check debtor information by Individual or Business Identification Number.

Parameter	Type	Required	Description
`messageId`	TEXT	No	UUID format message identifier
`iinOrBin`	TEXT	Yes	12-digit IIN or BIN for debtor information check

{
  "iinOrBin": "{{ctx.nodes.identifierExtractor.outputs.identifier}}"
}

Response:

{
  "messageId": "debt-check-001",
  "status": { "code": "SCSS001", "message": "Success" },
  "data": [
    {
      "execProc": 123.45,
      "debtorIin": "123456789012",
      "recoveryAmount": 150000.50,
      "categoryRu": "Исполнительный лист"
    }
  ]
}

citsDebts

Detailed tax debt information from CITS (Centralized Information Tax System).

Parameter	Type	Required	Description
`messageId`	TEXT	No	UUID format message identifier
`iinBin`	TEXT	Yes	10-12 digit Individual or Business Identification Number
`digitalSignBaseUrl`	TEXT	Yes	Base URL of digital signature service
`certEnvPrefix`	TEXT	No	Certificate environment prefix for digital signature

{
  "iinBin": "{{ctx.user.iin}}",
  "digitalSignBaseUrl": "{{ctx.consts.DIGITAL_SIGN_BASE_URL}}",
  "certEnvPrefix": "{{ctx.consts.CERT_PREFIX}}"
}

Response:

{
  "responseInfo": {
    "messageId": "cits-debt-001",
    "status": { "code": "SCSS001", "message": "Success" }
  },
  "debtsInfo": {
    "iinBin": "123456789012",
    "totalArrear": 125000.75,
    "totalTaxArrear": 100000.00,
    "taxOrganizations": [...]
  }
}

citsUpcPays

Upcoming tax payments information for property, land, and transport taxes from CITS.

Parameter	Type	Required	Description
`messageId`	TEXT	No	UUID format message identifier
`iinBin`	TEXT	Yes	12-digit Individual or Business Identification Number
`digitalSignBaseUrl`	TEXT	Yes	Base URL of digital signature service
`certEnvPrefix`	TEXT	No	Certificate environment prefix

{
  "iinBin": "{{ctx.user.iin}}",
  "digitalSignBaseUrl": "{{ctx.consts.DIGITAL_SIGN_BASE_URL}}"
}

Response:

{
  "responseInfo": {
    "status": { "code": "SCSS001", "message": "Success" }
  },
  "taxData": {
    "iinBin": "990101123456",
    "totalUpcPays": 180000.50,
    "taxOrganizations": [...]
  }
}

zagsFindMarriageSync

Search marriage records in ZAGS (Civil Registry) database.

Parameter	Type	Required	Description
`messageId`	TEXT	No	UUID format message identifier
`iin`	TEXT	Yes	12-digit Individual Identification Number
`senderCode`	TEXT	Yes	Sender code for interaction participant

{
  "iin": "{{ctx.user.iin}}",
  "senderCode": "{{ctx.consts.EGOV_SENDER_CODE}}"
}

MON_NEDB_UNIVERSAL_SERVICE

Universal education service from Ministry of Education through NEDB.

Parameter	Type	Required	Description
`messageId`	TEXT	No	UUID format message identifier
`iin`	TEXT	Yes	12-digit Individual Identification Number
`senderCode`	TEXT	Yes	Sender code for interaction participant

{
  "iin": "{{ctx.user.iin}}",
  "senderCode": "{{ctx.consts.EGOV_SENDER_CODE}}"
}

initPaymentRequest

Initialize payment request for government services.

Parameter	Type	Required	Description
`messageId`	TEXT	No	UUID format message identifier
`amount`	NUMBER	Yes	Payment amount in tenge
`serviceId`	TEXT	Yes	Government service identifier
`iinOrBin`	TEXT	Yes	Payer's Individual or Business Identification Number

{
  "amount": "{{ctx.vars.calculatedFee}}",
  "serviceId": "{{ctx.vars.governmentServiceId}}",
  "iinOrBin": "{{ctx.user.iin}}"
}

GbdrnOwnerForRegCitizen

Property ownership information from State Property Register (GBDRN).

Parameter	Type	Required	Description
`messageId`	TEXT	No	UUID format message identifier
`iin`	TEXT	Yes	12-digit Individual Identification Number
`senderCode`	TEXT	Yes	Sender code for interaction participant

{
  "iin": "{{ctx.user.iin}}",
  "senderCode": "{{ctx.consts.EGOV_SENDER_CODE}}"
}

paymentInfoRequest

Payment information and verification for government services.

Parameter	Type	Required	Description
`messageId`	TEXT	No	UUID format message identifier
`paymentId`	TEXT	Yes	Payment transaction identifier
`senderCode`	TEXT	Yes	Sender code for interaction participant

{
  "paymentId": "{{ctx.vars.transactionId}}",
  "senderCode": "{{ctx.consts.EGOV_SENDER_CODE}}"
}

Workflow Integration

Use workflow context to construct dynamic requests:

{
  "senderCode": "{{ctx.consts.EGOV_SENDER_CODE}}",
  "iin": "{{ctx.user.iin}}",
  "messageId": "{{ctx.vars.requestId}}",
  "digitalSignBaseUrl": "{{ctx.consts.DIGITAL_SIGN_BASE_URL}}"
}

Gateway Setup

Register with eGov: Obtain sender ID and credentials from Kazakhstan eGov portal
Get API Key: Request API access through SmartBridge registration
Configure Digital Signature: Set up certificate environment for CITS operations
Test Connectivity: Verify access with simple GBDFL query

Response Format

Success Response

{
  "responseInfo": {
    "messageId": "resp-123",
    "correlationId": "req-123", 
    "responseDate": "2024-03-15T10:30:00.000Z",
    "status": {
      "code": "SCSS001",
      "message": "Success"
    }
  },
  "data": {...}
}

Error Response

{
  "message": "Invalid IIN format",
  "code": "VALIDATION_ERROR",
  "operation": "gbdflUniversalServiceSync"
}

Use Cases

Citizen verification: Validate individual identity and personal data
Family composition: Determine family structure for social services
Educational records: Access school enrollment and academic history
Debt management: Check tax obligations before financial transactions
Property verification: Confirm ownership status for real estate dealings
Payment processing: Handle government service fees and taxes

eGov Gateway

On this page