Unified API Platform

Build Faster with
Warrantify APIs

Powering Claims, Returns, Repairs, Installation & Protection Plans for B2B and B2C integrations — all under one platform. Now with native Shopify integration.

6+API Products

RESTArchitecture

99.9%Uptime SLA

OAuthShopify Auth

Our Products

API Product Suite

Everything you need to manage device lifecycles — from sale to claim.

Installation API

Manage product installations with technician assignment, OTP verification, and live tracking.

Technician Scheduling
Geo-based Assignment
Real-time Status Updates

Explore Docs

Repair API

Create single & bulk repair orders with full approval workflow and real-time tracking.

Single & Bulk Orders
Repair Approval Workflow
SLA Monitoring

Explore Docs

Return API

Automate reverse logistics with validation, pickup coordination, and refund management.

Return Validation
Refund Processing
Replacement Workflow

Explore Docs

Claims API

Complete claim lifecycle management using existing or third-party insurance providers.

Insurance Integration
Approval Workflow
Fraud Prevention

Explore Docs

Assurify API

Sell extended warranty & accidental damage protection plans when customers buy devices.

Device Price Based Plans
Create Policy API
Payment Confirmation API

Explore Docs

Shopify Integration

Connect your Shopify store to Warrantify via OAuth. Auto-create claims, repairs, and protection plans on order events.

OAuth 2.0 App Install
Webhook Order Sync
Embedded App Support

Explore Docs

Documentation

Quick Reference Docs

Detailed API references with request parameters, response schemas, and code examples.

Claims API

GET POST

Submit and manage warranty claims through single or bulk order APIs. Includes claim creation, bulk upload support, and claim tracking.

/single-order//bulk-order//sample-template//tracking/

4 Endpoints

Installation API

GET POST

Submit and manage product installation requests via single or bulk order APIs, with live installation tracking.

/single-order//bulk-order//sample-template//tracking/

4 Endpoints

Repair API

GET POST

Submit and manage repair service requests via single or bulk order APIs with real-time repair tracking.

/single-order//bulk-order//sample-template//tracking/

4 Endpoints

Return API

GET POST

Automate the entire reverse logistics process — from return validation and pickup scheduling to refund processing.

/single-order//bulk-order//sample-template//tracking/

4 Endpoints

Assurify API

GET POST

Fetch protection plan pricing and create Extended Warranty or ADLD policies at point of sale.

/protection-plans//adld//create-policy/

4 Endpoints

Shopify API

GET POST

Install Warrantify on Shopify stores via OAuth, subscribe to order webhooks, and sync warranty data automatically.

/oauth/begin//oauth/callback//webhooks/

5 Endpoints

Why Warrantify

Platform Capabilities

Built for scale, security, and seamless partner integrations.

B2B Integration

Insurance companies, OEM brands & service partners — all under one unified API layer.

B2C Experience

Customers can directly file claims, track repairs, and manage protection plans with ease.

Real-time Tracking

Live order, repair, and installation updates with webhook-ready event notifications.

Secure REST APIs

Token-based authentication, encrypted payloads, and scalable cloud infrastructure.

Shopify Ready

Native OAuth app install — works in embedded Shopify Admin and headless storefronts.

Shopify Integration

Connect your Shopify store to Warrantify using OAuth 2.0. Once installed, our app automatically listens to order events and creates warranty records, repair requests, and protection plan policies — without any manual work.

How it works in brief: When you install the Warrantify app from the Shopify App Store (or via a direct install link), Shopify initiates an OAuth 2.0 flow. At the end of that flow, Warrantify receives a permanent access token for your store. All subsequent API calls use this token. Contact our team at api@warrantify.com to get your install link and begin the setup.

Step 1 — Install & OAuth Flow OAuth 2.0

The Warrantify Shopify app uses the standard Shopify OAuth 2.0 authorization code flow. Here's exactly what happens when you install:

Merchant begins install

The merchant clicks the Warrantify install link (provided by our team). Shopify redirects them to our authorization URL with a ?shop= parameter.

Warrantify requests permission scopes

We redirect the merchant to Shopify's authorization page asking for scopes: read_orders, write_orders, read_products, write_script_tags.

Merchant approves

The merchant clicks "Install app" in the Shopify permission screen. Shopify calls our redirect URI with a temporary authorization code.

Warrantify exchanges for a permanent token

Our server exchanges the authorization code for a permanent access token by calling Shopify's token endpoint. This token is stored securely and tied to your shop domain.

Integration is live

Warrantify registers webhooks for orders/create, orders/fulfilled, and refunds/create. Your store is now connected.

You do not need to manage the OAuth token yourself. Warrantify handles all token storage and refresh. To get your integration started, simply contact our team at api@warrantify.com and we'll send you your unique app install link.

OAuth Endpoints

GET/api/shopify/oauth/begin/Initiates the OAuth install flow

GET/api/shopify/oauth/callback/Shopify redirects here after merchant approves

POST/api/shopify/webhooks/orders/create/Triggered when a new Shopify order is placed

POST/api/shopify/webhooks/refunds/create/Triggered when a refund is initiated

Step 2 — Making API Calls with the Token

After installation, Warrantify uses the stored OAuth token internally to make Shopify Admin API calls on your behalf. If you are building a custom integration or calling Warrantify's APIs directly, use the Warrantify API Key (not the Shopify OAuth token — that belongs to us).

To authenticate calls to Warrantify's REST API:

            
# All Warrantify API calls use Bearer token auth
GET https://api.warrantify.com/v1/claims/single-order/

Headers:
  Authorization: Bearer YOUR_WARRANTIFY_API_KEY
  Content-Type: application/json
  X-Shop-Domain: your-store.myshopify.com
          

Example — creating a claim from a Shopify order using JavaScript:

            
// Example: Trigger a Warrantify claim from a Shopify order
const createWarrantyClaim = async (shopifyOrder) => {
  const response = await fetch('https://api.warrantify.com/v1/claims/single-order/', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.WARRANTIFY_API_KEY}`,
      'Content-Type': 'application/json',
      'X-Shop-Domain': shopifyOrder.shop_domain
    },
    body: JSON.stringify({
      order_id:      shopifyOrder.id,
      customer_name: shopifyOrder.customer.first_name,
      customer_email:shopifyOrder.email,
      product_sku:   shopifyOrder.line_items[0].sku,
      claim_type:    'warranty'
    })
  });
  const data = await response.json();
  return data;
};
          

Step 3 — Webhooks Auto-Registered

Once your store is connected, Warrantify automatically registers the following Shopify webhooks. You don't need to set these up manually.

            
// Webhooks registered automatically after OAuth install
const webhooks = [
  { topic: 'orders/create',    address: 'https://api.warrantify.com/shopify/webhooks/orders/create/'    },
 
];
// Warrantify verifies each webhook using HMAC-SHA256 signature
          

All incoming Shopify webhooks are verified using the HMAC-SHA256 signature in the X-Shopify-Hmac-Sha256 header. This ensures only legitimate Shopify events are processed.

Getting Your Access Token

Warrantify manages OAuth tokens internally — you never handle the raw Shopify token. However, you will need a Warrantify API Key to make calls to our API. Here's the process:

Contact our team

Email api@warrantify.com with your Shopify store domain, business name, and intended use case. We'll create your account.

Receive your install link + API key

Our team will send you a unique Shopify app install link and your Warrantify API Key via email within 1 business day.

Complete OAuth install

Click the install link while logged in to your Shopify admin. Approve the permissions. Your store is connected instantly.

Start making API calls

Use your Warrantify API Key in the Authorization: Bearer header to call any Warrantify endpoint.

You're all set! After completing these steps, your Shopify store is fully connected to Warrantify. New orders will automatically sync, and you can use the API to create claims, repairs, returns, and protection plans programmatically.

Authentication & Tokens

All Warrantify APIs are secured with Bearer token authentication. Tokens are issued per-partner account and must be included in every request.

Bearer Token Auth

Include your API key in the Authorization header of every request:

            
GET /api/v1/claims/tracking/?order_id=ORD123

Headers:
  Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
  Content-Type: application/json

Token Expiry & Refresh

Access tokens are valid for 24 hours. Refresh tokens are valid for 30 days. When a token expires, call the refresh endpoint:

POST/api/auth/token/refresh/Get a new access token using refresh token

            
// Refresh your access token
const res = await fetch('/api/auth/token/refresh/', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ refresh: 'your_refresh_token' })
});
const { access } = await res.json();
          

Never expose your API key in client-side JavaScript or public repositories. Store it in environment variables or a secrets manager.

Claims API

Submit and track warranty claims through single or bulk order APIs. Supports third-party insurance integration, claim approval workflows, and real-time tracking.

Endpoints

POST/api/v1/claims/single-order/Create a single claim

POST/api/v1/claims/bulk-order/Upload multiple claims via file

GET/api/v1/claims/sample-template/Download the bulk upload CSV template

GET/api/v1/claims/tracking/Track claim status by order ID

Create a Single Claim

            
POST /api/v1/claims/single-order/
Authorization: Bearer YOUR_API_KEY

{
  "order_id":       "ORD-2024-001",
  "customer_name":  "Ramesh Kumar",
  "customer_phone": "9876543210",
  "product_sku":    "TV-55-SAMSUNG",
  "claim_type":     "warranty",
  "issue_desc":     "Screen not turning on",
  "purchase_date":  "2024-01-15"
}
          

Response

            
{
  "status":      "success",
  "claim_id":    "CLM-20240601-XY9",
  "order_id":    "ORD-2024-001",
  "claim_status":"pending_review",
  "created_at":  "2024-06-01T10:30:00Z"
}
          

Track a Claim

            
GET /api/v1/claims/tracking/?order_id=ORD-2024-001
Authorization: Bearer YOUR_API_KEY

// Response
{
  "claim_id":    "CLM-20240601-XY9",
  "status":      "approved",
  "technician":  "Suresh B.",
  "visit_date":  "2024-06-05",
  "remarks":     "Repair scheduled"
}
          

Installation API

Manage product installation requests. Supports geo-based technician assignment, OTP verification, and live status tracking.

Endpoints

POST/api/v1/install/single-order/Create a single installation request

POST/api/v1/install/bulk-order/Bulk install requests via CSV upload

GET/api/v1/install/sample-template/Download bulk CSV template

GET/api/v1/install/tracking/Track installation by order ID

Create Installation Request

            
POST /api/v1/install/single-order/
Authorization: Bearer YOUR_API_KEY

{
  "order_id":       "ORD-INST-2024-05",
  "customer_name":  "Priya S.",
  "customer_phone": "9123456780",
  "address":        "12, MG Road, Chennai 600001",
  "pincode":        "600001",
  "product_sku":    "AC-SPLIT-1.5T",
  "preferred_date": "2024-06-10",
  "preferred_slot": "10AM-12PM"
}
          

Repair API

Create single and bulk repair orders with full approval workflows, SLA monitoring, and real-time technician tracking.

Endpoints

POST/api/v1/repair/single-order/Create a single repair order

POST/api/v1/repair/bulk-order/Submit bulk repair orders via CSV

GET/api/v1/repair/sample-template/Download bulk CSV template

GET/api/v1/repair/tracking/Track repair status

Create Repair Order

            
POST /api/v1/repair/single-order/
Authorization: Bearer YOUR_API_KEY

{
  "order_id":       "ORD-REP-2024-10",
  "customer_name":  "Arun M.",
  "customer_phone": "9988776655",
  "product_sku":    "WM-LG-7KG",
  "issue_type":     "not_spinning",
  "address":        "45, Anna Nagar, Chennai",
  "pincode":        "600040"
}
          

Return API

Automate reverse logistics — return validation, pickup scheduling, refund processing, and replacement workflows.

Endpoints

POST/api/v1/return/single-order/Initiate a single return

POST/api/v1/return/bulk-order/Bulk return requests via CSV

GET/api/v1/return/sample-template/Download bulk CSV template

GET/api/v1/return/tracking/Track return & refund status

Create Return Request

            
POST /api/v1/return/single-order/
Authorization: Bearer YOUR_API_KEY

{
  "order_id":        "ORD-RET-2024-07",
  "customer_name":   "Deepa R.",
  "customer_phone":  "9111222333",
  "product_sku":     "PHONE-APPLE-14",
  "return_reason":   "defective_product",
  "refund_mode":     "original_payment",
  "pickup_address":  "8, Velachery, Chennai 600042"
}
          

Assurify API

Sell Extended Warranty and ADLD protection plans at the point of sale. Fetch device-price-based premium quotes and issue policy IDs in real time.

Endpoints

GET/api/v1/assurify/protection-plans/Get available plans & premiums by device price

GET/api/v1/assurify/adld/Get ADLD plan details

POST/api/v1/assurify/create-policy/Create a new protection policy

POST/api/v1/assurify/payment-confirm/Confirm payment and activate policy

Get Protection Plans

            
GET /api/v1/assurify/protection-plans/?device_price=35000&category=television
Authorization: Bearer YOUR_API_KEY

// Response
{
  "plans": [
    { "plan_id": "EW1Y", "name": "1 Year Extended Warranty", "premium": 1299 },
    { "plan_id": "EW2Y", "name": "2 Year Extended Warranty", "premium": 2199 },
    { "plan_id": "ADLD1","name": "1 Year ADLD",               "premium": 1599 }
  ]
}
          

Create a Policy

            
POST /api/v1/assurify/create-policy/
Authorization: Bearer YOUR_API_KEY

{
  "plan_id":       "EW2Y",
  "customer_name": "Vijay K.",
  "customer_phone":"9876001234",
  "product_sku":   "TV-SONY-55",
  "device_price":  35000,
  "purchase_date": "2024-06-01",
  "invoice_no":    "INV-2024-9988"
}

// Response
{
  "policy_id":  "POL-EW-20240601-001",
  "status":     "pending_payment",
  "premium":    2199,
  "valid_from": "2025-06-01",
  "valid_till": "2027-06-01"
}
          

Build Faster withWarrantify APIs

API Product Suite

Installation API

Repair API

Return API

Claims API

Assurify API

Shopify Integration

Quick Reference Docs

Claims API

Installation API

Repair API

Return API

Assurify API

Shopify API

Platform Capabilities

B2B Integration

B2C Experience

Real-time Tracking

Secure REST APIs

Shopify Ready

Shopify Integration

Step 1 — Install & OAuth Flow OAuth 2.0

Merchant begins install

Warrantify requests permission scopes

Merchant approves

Warrantify exchanges for a permanent token

Integration is live

OAuth Endpoints

Step 2 — Making API Calls with the Token

Step 3 — Webhooks Auto-Registered

Getting Your Access Token

Contact our team

Receive your install link + API key

Complete OAuth install

Start making API calls

Authentication & Tokens

Bearer Token Auth

Token Expiry & Refresh

Claims API

Endpoints

Create a Single Claim

Response

Track a Claim

Installation API

Endpoints

Create Installation Request

Repair API

Endpoints

Create Repair Order

Return API

Endpoints

Create Return Request

Assurify API

Endpoints

Get Protection Plans

Create a Policy

Build Faster with
Warrantify APIs