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ập

Thô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
POST

/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.

GET

/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.

GET

/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

pending

Chờ duyệt

Đơn đã ghi nhận, đang chờ sàn đối soát

completed

Đã duyệt

Hoàn tiền đã cộng vào ví

canceled

Đã hủy

Đơn bị hủy hoặc hoàn trả trên sàn

failed

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}

200 Thành công
401 Token sai hoặc thiếu header Authorization
404 Không tìm thấy đơn hàng
422 Dữ liệu gửi lên không hợp lệ
429 Gửi quá nhiều request, vượt giới hạn
503 Hệ thống đang bảo trì
HOANTIENAZ.COM

Hoàn tiền AZ- Nền tảng hàng đầu giúp người dùng nhận hoàn tiền khi mua sắm trên Shopee, Tiktok. Theo dõi đơn hàng, nhận hoa hồng hoàn tiền minh bạch và tối ưu chi phí mua sắm trực tuyến.

Email: admin@hoantienaz.com

© 2026 HOANTIENAZ.COM. Tất cả quyền được bảo lưu.