Jira Code: MISC-315
Paybooks is an HR and Payroll software used widely in India. The task focuses on the requirements in integrating this software with NetSuite.
Paybooks use JWT Authentication. For every API call, a JWT is created. JWT is sent along the authorization header.
**JWT : JSON Web Token
Partner Id – A Unique ID given to Partner by Paybooks
Partner secret key – A secret key generated for each Partner by Paybooks.
Company Hash – A unique hash generated for each company under Partner by Paybooks. Company Domain – A unique company domain name for each company by Paybooks.
All the above attributes will be provided by Paybooks.
Create a JWT
JWT consists of Header, Payload and Signature.
Header consists of
1) type of cryptography algorithm
2) type of token
Payload consists of
1) Partner Id – partnerid
2) Company domain – companydomain
3) Company Hash – companyhash
4) token issue time – iat
5) token expiry time – exp
To generate Signature
HS256(Client secret key, base64URLEncode(header). base64URLEncode(payload))
1) Base64 URL Encode the header
2) Base64 URL Encode the payload
3) Sign the above using Client Secret Key
Reference : https://www.jsonwebtoken.io, https://jwt.io/
Functionalities available
1 ) Know Employee
2) Know Current Pay month
3) Get Variable Pay Components
4) Monthly Variable Pay
The above mentioned are the APIs available for Paybooks Integration.