Tài liệu kết nối API
Tích hợp hệ thống của bạn với HOANTIENAZ.COM để tạo link hoàn tiền và tra cứu đơn hàng tự động, đây là công cụ cho lập trình viên, khách hàng cá nhân không cần quan tâm.
Token truy cập
Đăng nhập để xem token truy cập của tài khoản bạn.
Đăng nhậpThông tin chung
- Base URL
- https://az.hoantienaz.com
- Xác thực
- Authorization: Bearer {token}
- Header bắt buộc
- Accept: application/json
Danh sách endpoint
| Method | Đường dẫn | Mô tả | Giới hạn |
|---|---|---|---|
| POST | /apiweb/cashback/get-link | Tạo link hoàn tiền từ URL sản phẩm | 20 lần / phút |
| GET | /apiweb/cashback/orders | Danh sách đơn hoàn tiền (phân trang 15) | 60 lần / phút |
| GET | /apiweb/cashback/order | Trạng thái một đơn hàng cụ thể | 60 lần / phút |
/apiweb/cashback/get-link
Tạo link hoàn tiền từ URL sản phẩm Shopee, ShopeeFood, TikTok Shop hoặc Lazada.
Tham số (body)
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
| url | string | Có | URL sản phẩm, tối đa 2000 ký tự |
Ví dụ
curl -X POST https://az.hoantienaz.com/apiweb/cashback/get-link \
-H "Authorization: Bearer {token}" \
-H "Accept: application/json" \
-d "url=https://shopee.vn/product/123456"
Kết quả thành công
{
"status": "success",
"message": "Tạo link thành công",
"data": {
"shop_name": "Tên shop",
"platform": "shopee",
"trans_id": "SHPA1B2C3D4E5F6",
"product_name": "Tên sản phẩm",
"product_image": "https://...",
"original_price": 250000,
"cashback_amount": 15000,
"rating": 4.8,
"affiliate_url": "https://...",
"short_url": "https://..."
}
}
Hãy lưu lại trans_id để tra cứu trạng thái đơn về sau. Người mua phải truy cập qua affiliate_url hoặc short_url thì hoàn tiền mới được ghi nhận.
/apiweb/cashback/orders
Lấy danh sách đơn hoàn tiền của tài khoản, mặc định 15 đơn mỗi trang, sắp xếp mới nhất trước.
Tham số (query, tùy chọn)
| Tên | Kiểu | Mô tả |
|---|---|---|
| platform | string | shopee | shopeefood | tiktok | lazada |
| status | string | pending | completed | canceled | failed |
| search | string | Tìm theo tên sản phẩm hoặc mã đơn hàng |
| from_date | string | Từ ngày, định dạng YYYY-MM-DD |
| to_date | string | Đến ngày, định dạng YYYY-MM-DD |
| page | integer | Số trang, mặc định 1 |
| per_page | integer | Số đơn mỗi trang, từ 1 đến 100, mặc định 15 |
Ví dụ
curl "https://az.hoantienaz.com/apiweb/cashback/orders?status=completed&page=1" \
-H "Authorization: Bearer {token}" \
-H "Accept: application/json"
Kết quả thành công
{
"status": "success",
"items": [
{
"id": 123,
"platform": "shopee",
"platform_label": "Shopee",
"order_id": "250811ABCDEFG",
"trans_id": "SHPA1B2C3D4E5F6",
"shop_name": "Tên shop",
"product_name": "Tên sản phẩm",
"product_image": "https://...",
"original_price": 250000,
"cashback_amount": 15000,
"status": "completed",
"client_note": "",
"approved_at": "2026-08-11 09:30:00",
"created_at": "2026-08-01 10:15:00"
}
],
"total_completed": 15000,
"pagination": {
"current_page": 1,
"last_page": 1,
"per_page": 15,
"total": 1
}
}
Trường total_completed là tổng tiền hoàn của các đơn đã duyệt theo bộ lọc hiện tại.
/apiweb/cashback/order
Tra cứu trạng thái một đơn hàng cụ thể.
Tham số (query)
| Tên | Kiểu | Mô tả |
|---|---|---|
| trans_id | string | Mã đối soát nhận được khi tạo link |
| order_id | string | Mã đơn hàng trên sàn |
Phải truyền ít nhất một trong hai tham số. Nếu truyền cả hai, hệ thống tìm đơn khớp đồng thời cả trans_id và order_id.
Ví dụ
curl "https://az.hoantienaz.com/apiweb/cashback/order?trans_id=SHPA1B2C3D4E5F6" \
-H "Authorization: Bearer {token}" \
-H "Accept: application/json"
Kết quả thành công
{
"status": "success",
"message": "Thành công",
"data": {
"id": 123,
"platform": "shopee",
"platform_label": "Shopee",
"order_id": "250811ABCDEFG",
"trans_id": "SHPA1B2C3D4E5F6",
"product_name": "Tên sản phẩm",
"cashback_amount": 15000,
"status": "pending",
"created_at": "2026-08-01 10:15:00"
}
}
Không tìm thấy đơn
{
"status": "error",
"message": "Không tìm thấy đơn hàng.",
"data": null
}
Trạng thái đơn hàng
Chờ duyệt
Đơn đã ghi nhận, đang chờ sàn đối soát
Đã duyệt
Hoàn tiền đã cộng vào ví
Đã hủy
Đơn bị hủy hoặc hoàn trả trên sàn
Thất bại
Đơn không hợp lệ, không được hoàn tiền
Mã trạng thái HTTP
Khi lỗi, response luôn có dạng {"status": "error", "message": "...", "data": null}