OAuth- Resource Based

The redirection-based workflow starts by navigating to the public Quicko OAuth login endpoint.

📘

Note

You must enable and configure OAuth options under API key's settings on the dashboard in order to use the workflow.

Steps:

1. Navigate to the Quicko OAuth login page with the api_key
2. A successful login comes back with a request_token to the registered redirect URL
3. POST the request_token to /oauth/authorize
4. Obtain the access_token and use that with all subsequent requests

📘

An optional redirect_url param can be appended to the Quicko OAuth login endpoint, which will be used to navigate the user after a successful login attempt. Redirect URL request parameter must be Base64 encoded, eg: https://quicko.com will used like https://oauth.quicko.com/login?api_key={api_key}&redirect_url=aHR0cHM6Ly9xdWlja28uY29t

Important Links

---

HTTP Method	Resource	Description
GET	/oauth/authorize?request_token={{request_token}}	Requires Request Token

---

How to use this workflow? (Navigate to Quicko)

Use this workflow to redirect OAuth authenticated resource owner to Quicko as an authenticated user.

Quicko uses Resource Owners' access token to reauthorize & re-issue access token with accounts.quicko.com as an audience.

📘

Redirect URL

https://accounts.quicko.com/authorize?request_token={request_token}&coupon={coupon}&affiliate_id={affiliateId}&url={url}

URL request parameter must be Base64 encoded eg:

• https://it.quicko.com/tax-payers/123417BAC39D98A4A66725427A362123 will be used like

• https://accounts.quicko.com/authorize?request_token=eyJhbGciOiJIUzUxM....&coupon=XXXXXX&affiliate_id=900fefdf-a43f-41be-a271-81b3ee77ee38&url=aHR0cHM6Ly9pdC5xdWlja28uY29tL3RheC1wYXllcnMvMTIzNDE3QkFDMzlEOThBNEE2NjcyNTQyN0EzNjIxMjM=

URL examples

Various URL construction examples are explained below:

Product	View	URL
IT	Tax payer view	https://it.quicko.com/tax-payer/{tax_payer_id}
IT	ITR view	https://it.quicko.com/tax-filing/{year}/tax-payers/{tax_payer_id}/itrs/{itr_id}
IT	Incomes view	https://it.quicko.com/tax-filing/{year}/tax-payers/{tax_payer_id}/itrs/{itr_id}/incomes
IT	Salary income aggregate View	https://it.quicko.com/tax-filing/{year}/tax-payers/{tax_payer_id}/itrs/{itr_id}/incomes/salaries?tan={{tan}}
IT	Review	https://it.quicko.com/tax-filing/{year}/tax-payers/{tax_payer_id}/itrs/{itr_id}/review
IT	Tax computation	https://it.quicko.com/tax-filing/{year}/tax-payers/{tax_payer_id}/itrs/{itr_id}/review/tax-computation