Welcome to Integration API!
Hello,
Welcome to the egaranti integration guides! Here, you'll find step-by-step instructions and answers to frequently asked questions to help you navigate any challenges with the egaranti integration API. Our aim is to make your integration process as efficient and smooth as possible.
Try the API
You can explore and test the API directly using our interactive documentation:
| Environment | Scalar API Reference |
|---|---|
| Replica | replica-integration.egaranti.dev/scalar |
| Prod | tr-integration.egaranti.co/scalar |
Scalar provides an interactive API playground where you can test endpoints directly in your browser. Get your JWT token from the /auth endpoint first, then use it to authenticate other requests.
Quick Start
Follow these steps to complete the integration:
- Authorization - Get your API Key and Secret, generate JWT token
- Warranty Registration - Send warranty with invoice data (products are created automatically)
That's it! See the Flow Chart for a visual guide.
Recommended Integration Method
The easiest way to integrate is using the Send Warranty with Invoice endpoint. This single endpoint:
- Automatically creates products if they don't exist
- Supports multiple products in a single request
- Supports extended warranties
- Returns warranty IDs immediately (synchronous)
Just provide productCode and name for each product, and the system handles the rest.
Alternative: Manual Product Management
If you need more control over product data, you can still:
- Create products separately using Create Product
- Then send warranties using
merchantProductIdorproductCode
When creating products manually, you no longer need to find category IDs beforehand. Send category information directly as names (mainCategoryName, categoryName, subCategoryName, brand). The system automatically handles the matching.
Support
If you need assistance at any stage or have questions, we're here to help. Feel free to reach out to us at info@egaranti.com.
Welcome to egaranti!