This endpoint helps you check if Tamara treats a customer as eligible based on the active decline records we hold for that customer.
Pre-checkout eligibility flow
Merchants should call the Pre-checkout Eligibility API before creating the order to determine whether Tamara should be available as a payment option for this customer for this checkout session.
Integration sequence
Merchants should implement the Tamara checkout flow in the following sequence:
- Call the Pre-checkout Eligibility API.
- Use the eligibility response to decide whether to show Tamara as a payment option to the customer.
- If the customer selects Tamara, proceed with the Order Creation API.
Timeout
Merchants should configure a 200ms timeout for the Pre-checkout Eligibility API.
If Tamara API does not respond within 200ms, default to showing Tamara as normal - this prevents any eligibility check latency from impacting the checkout experience.
Recommended behavior:
| API Response | Action |
|---|---|
is_eligible: true | Show Tamara |
is_eligible: false | Hide Tamara |
| Timeout / No response | Show Tamara |
If the phone number is not passed, the customer is treated as eligible.
Sample phone numbers for testing
| Eligibility | UAE | KSA |
|---|---|---|
| true | 971501234567 | 966501234567 |
| false | 971562477204 | 966504591298 |
| false | 971504552481 | 966537865333 |