Payees API

You can call this API to post the details of payee and also you can fetch details of payee and count payee using this API

Payee Entity

The various properties are explained below:

Param

Type

Required

Description

id

32 bit hex

Yes

Payee ID

(Auto generated while posting)

name

string

Yes

Name of Payee

pan

string

Yes

PAN Number of Payee in valid format

1. Mention PANAPPLIED if payee has applied for pan

2. Mention PANINVALID if payee is not sure of pan format

3. Mention PANNOTAVBL, if payee has not given any declaration

residential_status

string

Yes

Residential Status, Possible Values: Resident, Non Resident, Not Ordinarily Resident

code

string

No

Payee Code (Deductee Reference Number)

Mandatory if PAN number is not in proper format and belongs to type 1, 2, or 3 mentioned above (Only for FORM 26Q and 24Q (Q1-3, Q4))

(Not Mandatory for Form27Q)

tax_identification_number

string

No

Tax Identification Number of Payee in the country or specified territory of this residence and if not available, a unique number on the basis on which the payee is indentified, (Not mandatory for 24Q, 26Q)

Mandatory for FORM 27Q under following conditions

1. Rate is < 20%

2. Code for reason of lower deduction is "C" (in deduction entity)

3. PAN is not in proper format and belongs to type 1, 2, or 3 mentioned above.

4. Code for Nature Of Remittances is "27", "49", "21", "52" OR "31".

(Only zero's or special characters or only spaces not allowed)

addresses

Array of Address

Yes

Array of Address

contacts

Array of Contact

Yes

Array of Contact

Address Entity

Use other non mandatory fields such as area, district and city for complete address.

The various properties are explained below:

Param

Type

Required

Description

id

32 bit hex

Yes

Reference of Payer ID

type

string

No

Type

is_primary

Boolean

No

Primary Address or Not

street

string

Yes

Street (Max Length: 25)

area

string

No

Area

city

string

No

City

state

string

Yes

State

See Annexure 1

postal_code

string

Yes

Postal Code

district

string

No

District

country

string

No

Country

Mandatory for FORM 27Q (Refer Annexure 5)

full_address

string

No

Complete Address

Contact Entity

The various properties are explained below:

Param

Type

Required

Description

id

32 bit hex

Yes

Reference of Payer ID

email

string

Yes

Email Address

mobile

string

Yes

10 digit mobile number