TPIN

Required Inputs

InputValue

country

ZM

id_type

TPIN

id_number

TPIN (Tax Id Number)

Response Fields

Response FieldValue Returned

Country

YES

IDType

YES

IDNumber

YES

ExpirationDate

NO

FullName

YES

DOB

NO

Photo

NO

PhoneNumber

NO

PhoneNumber2

NO

Document

NO

Gender

NO

Address

NO

All fields are returned as strings

ID Number Regular Expression (Regex)

To limit the probability of your user mistyping the id number, we advice that you enforce the format of the id number field in your app. You can use the regex below:

  • /^[0-9]{10}$/

Supported Products

The Zambia TPIN service can be used on any of the following products:

For the supported integration options, you can check the integration options supported by each product here.

Sample ID Numbers

To test the Zambia TPIN in our Sandbox, we provide you with 5 different id numbers to mirror various scenarios you can experience with real IDs in production.

ID NumberResultResult Code

0000000000

Success with PII return

1012

0000000001

Failure, no record found

1013

0000000002

Invalid ID number format

1014

0000000003

Database unavailable/unknown network issue

1015

0000000004*

Success with custom PII return

1012

* You can read more about customising the PII response in sandbox in our documentation here.

Last updated