post
https://{environment}.tamara.co/prequal/v1/session
This endpoint helps you to initiate a pre-qual session for your customers, so they can know exactly how much they can spend with Tamara.
Pre-qualification session flow
Merchants should call the Pre-qual session API for their customers to assess their max spending limit and available payment plans.
Integration sequence
Merchants may implement the Tamara pre-qual session flow across existing and custom merchant assets, similar to widgets:
- Customer clicks on the respective button to start the pre-qual session.
- Merchant calls the Pre-qual session API from backend.
- Merchant opens the returned URL for the customer (HTTP redirect or webview).
- Customer inputs the phone number and amount, completes the pre-qual check.
- Customer is redirected to the specified merchant page.
Each successful request creates a new session (no idempotency key). Sessions expire after a short TTL (typically 30 minutes).
Timeout
Merchants should configure a 1s timeout for the Pre-qual session API.
If Tamara API does not respond within 1s, then no Pre-qual session will be generated.
Testing
- This API is only available for production mode, so please enter real phone numbers for simulating the flow.
- The user needs to input the phone number manually in the session.