IMEI Validation
Learn how you can validate the IMEI number using Pine Labs Online API.
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 and Unblock.
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 Unblock and Block the IMEI number.
Below are the sample requests and sample responses for a IMEI Validation API.
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"
}
]
}
'
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_imeithat 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.
