---
title: IMEI Validation
slug: affordability-suite/imei-validations
excerpt: Learn how you can validate the IMEI number using Pine Labs Online API.
hidden: false
metadata:
title: IMEI Validation API for EMI Payments | Pine Labs
description: >-
Validate IMEI or serial numbers during EMI transactions with the Pine Labs
API. Block or unblock devices for returns and defaults to secure loans.
keywords: >-
imei validation, device verification, serial number check, emi compliance,
block imei, unblock device, loan security
robots: index
sidebar_order: 8
---
Integrating with Pine Labs Online, you can now include an IMEI verification flow, enabling merchants to verify product IMEI or serial numbers during the payment. This feature ensures compliance and enhances efficiency by integrating IMEI verification.
You can use this Pine Labs Online IMEI Validation API to `Block`.
Integrating with IMEI validations allows you to secure operations in EMI or loan-based purchases. IMEI validation ensures that the device associated with the payment is accurately identified and secured. Businesses use IMEI validation to manage processes like unblocking devices during returns or blocking them in cases of payment default.
### IMEI Validation API
Use this API to `Block` the IMEI number.
Below are the sample requests and sample responses for a IMEI Validation API.
```curl cURL - UAT
curl --request POST \
--url https://pluraluat.v2.pinepg.in/api/affordability/v1/product/{order_id}/imei \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c' \
--header 'Content-Type: application/json' \
--header 'Request-ID: c17ce30f-f88e-4f81-ada1-c3b4909ed235' \
--header 'Request-Timestamp: 2024-07-09T07:57:08.022Z' \
--header 'accept: application/json' \
--data '
{
"merchant_product_imei_reference": "merchant-ref-786",
"request_type": "BLOCKING",
"products": [
{
"product_code": "xyz",
"dealer_code": "DLR100",
"state_code": "NY",
"product_imei": "SN1234567863"
}
]
}
'
```
```curl cURL - PROD
curl --request POST \
--url https://api.pluralpay.in/api/affordability/v1/product/{order_id}/imei \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c' \
--header 'Content-Type: application/json' \
--header 'Request-ID: c17ce30f-f88e-4f81-ada1-c3b4909ed235' \
--header 'Request-Timestamp: 2024-07-09T07:57:08.022Z' \
--header 'accept: application/json' \
--data '
{
"merchant_product_imei_reference": "merchant-ref-786",
"request_type": "BLOCKING",
"products": [
{
"product_code": "xyz",
"dealer_code": "DLR100",
"state_code": "NY",
"product_imei": "SN1234567863"
}
]
}
'
```
```json Sample Response
{
"merchant_product_imei_reference": "merchant-ref-786",
"request_type": "BLOCKING",
"products": [
{
"product_code": "xyz",
"dealer_code": "DLR100",
"state_code": "NY",
"product_imei": "SN1234567863",
"product_imei_status": "BLOCKED",
"product_brand_response": {}
}
]
}
```
```json Failure - Sample Response
{
"merchant_product_imei_reference": "merchant-ref-786",
"request_type": "BLOCKING",
"products": [
{
"product_code": "xyz",
"dealer_code": "DLR100",
"state_code": "NY",
"product_imei": "SN1234567863",
"product_brand_response": {
"code": "PRODUCT_ALREADY_BLOCKED",
"message": "Product is already blocked"
}
}
]
}
```
### Brand-Wise Mandatory Fields for IMEI Verification
The table below provides the brand-wise mandatory fields required for IMEI verification.
| OEM / Brands | product_imei | product_code | dealer_code | state_code | Remarks |
| :------- | :----------- | :----------- | :---------------- | :---------------- | :-------------------------------------------- |
| GODREJ | Yes | Yes | Yes | Yes | |
| ACER | Yes | Yes | Yes | Yes | |
| REALME | Yes | Yes | Yes | Yes | Dealer/State code will be same (Db code) |
| XIAOMI | Yes | Yes | | | |
| ASUS | Yes | Yes | Yes | Yes | Dealer/State code will be same |
| NEW_GOOGLE | Yes | Yes | Test (Any String) | Test (Any String) | |
| SAMSUNG | Yes | Yes | | | |
| INFINIX | Yes | Yes | Yes | Yes | Dealer/State code will be same |
| NOTHING | Yes | Yes | Yes | Yes | Dealer/State code will be same (RTL code) |
| OPPO | Yes | Yes | Yes | Yes | |
| ONEPLUS | Yes | Yes | Test (Any String) | Test (Any String) | |
| VIVO | Yes | Yes | Yes | Yes | |
| APPLE | Yes | Yes | | | |
> 📘 Note:
>
> - Once the refund request is successfully processed, the product IMEI will also be unblocked in the backend.
> - For a full refund, all IMEIs linked to the product are automatically unblocked. For a partial refund, you must provide the `product_imei` that needs to be unblocked.
> - IMEI validation applies only to brand-specific SKUs.
> - Each SKU can have only one associated IMEI burn.
> **IMEI Status Code:**
> - 200 OK should be returned when the IMEI is blocked.
> - 207 Multi-Status should be returned only when, out of multiple SKUs, at least one SKU is not blocked
IMEI Validation FAQs
Use these FAQs to understand when to validate IMEI or serial numbers and how refunds affect linked devices.
What should the merchant send during refunds if IMEI validation was performed earlier?
If IMEI validation was performed during the original transaction, include the IMEI number in the refund payload for unblocking or blocking updates as required by the refund scenario. For a full refund, the IMEI number is not required.
What is IMEI Validation and why is it used?
IMEI Validation verifies and registers a product's IMEI or serial number against an EMI or loan payment.
It is typically used for Brand EMI purchases of handsets, laptops, and electronics from participating brands. Common use cases include blocking a device on payment default and unblocking it when the product is returned or the loan is repaid.
What happens to the IMEI when a refund is processed?
For a full refund, all IMEIs linked to the order are handled by Pine Labs Online according to the enabled IMEI workflow, and no separate IMEI API call is required.
For a partial refund, pass the relevant `product_imei` in the refund request so the correct device can be updated.
Does IMEI validation apply to all products in a Brand EMI order?
No. IMEI validation applies only to brand-specific SKUs with IMEI tracking enabled.
Each eligible SKU can have only one IMEI registered per order. Non-IMEI products in the same order are unaffected.
When in the order lifecycle should I call the IMEI Validation API?
Call the IMEI Validation API after payment is captured and the order status is `processed`, so the device can be registered with the brand for the blocking lifecycle.