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.
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.
Each successful request creates a new
session (no idempotency key). Sessions expire after a short TTL (typically 30 minutes).
Testing
Currently, this API is only available for production mode, so please enter real phone numbers for simulating the flow.
Currently, the user needs to input the phone number manually in the session.