Send Warranty

You can send a warranty using this service with an existing merchantProductId.

Recommended Approach

For most use cases, we recommend using the Send Warranty with Invoice endpoint instead. It automatically creates products if they don't exist and provides a more flexible integration.

Prerequisites

This endpoint requires a pre-registered product. You can create products using the Product Creation service, or use the invoice endpoint which handles product creation automatically.

Request

curl --location --request POST '<BASE_URL>/individual-customers/warranty' \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer <jwtToken>' \
     --data '{
                 "merchantProductId": 123,
                 "firstName": "John",
                 "lastName": "Doe",
                 "email": "john.doe@example.com",
                 "phone": "+905551234567",
                 "countryCode": "TR",
                 "externalOrderId": "ORD-12345",
                 "purchaseDate": "15-01-2024 10:30",
                 "warrantyExpireDate": "15-01-2026 10:30"
              }'

Here are examples of acceptable phone number formats:

• 544 333 22 11
• 5443332211
• +905443332211
• 905443332211
• 05443332211 :::

Date Formats

The formats for the purchaseDate and warrantyExpireDate parameters must be: dd-MM-yyyy HH:mm (e.g., 01-01-2023 00:00).

• If purchaseDate is not provided, today's date will be used.
• If warrantyExpireDate is not provided, it will be calculated based on the product's warranty period.

Request Body

Parameter	Type	Required	Description
merchantProductId	Integer	Yes	The ID of the product for which the warranty will be sent.
firstName	String	Yes	Customer first name (e.g., "John")
lastName	String	Yes	Customer last name (e.g., "Doe")
externalOrderId	String	Yes	External order ID from your system (e.g., "ORD-12345")
countryCode	Enum	No	Country code for the phone number (default: TR)
email	String	No	Customer email (e.g., "john.doe@example.com")
phone	String	No	Customer phone (e.g., "+905551234567")
identificationNumber	String	No	Customer ID number (e.g., "12345678901")
birthDate	String	No	Customer birth date (format: dd-MM-yyyy, e.g., "15-06-1990")
purchaseDate	String	No	Purchase date (format: dd-MM-yyyy HH:mm)
warrantyExpireDate	String	No	Warranty expiration date (format: dd-MM-yyyy HH:mm)

Country Code Enum

TR  // Turkey
US  // United States
DE  // Germany
GB  // United Kingdom
AE  // United Arab Emirates
NL  // Netherlands
FR  // France
UZ  // Uzbekistan

Response

{
    "individualCustomerProductId": 12345
}

Example

{
  "merchantProductId": 456,
  "firstName": "Ahmet",
  "lastName": "Yilmaz",
  "email": "ahmet.yilmaz@example.com",
  "phone": "5321234567",
  "countryCode": "TR",
  "externalOrderId": "INV-2024-001",
  "purchaseDate": "20-01-2024 14:00"
}