Tài liệu API
Dành cho đại lý bán SIM

Bạn bán.
Chúng tôi giao tại sân bay.

Bán SIM cho khách quốc tế thì vướng đúng một khâu: ai đứng ở sân bay trao SIM cho khách, đúng người, đúng giờ, đúng con SIM đã bán. Chúng tôi làm khâu đó, và làm theo cách bạn kiểm tra được.

Tài liệu API đọc được không cần tài khoản — lập trình viên của bạn ước lượng được việc trước khi nhận việc.

Vì sao chọn

Những chỗ hay hỏng, chúng tôi chặn sẵn

Phần lớn rủi ro của việc giao SIM tại sân bay không nằm ở công nghệ. Nó nằm ở chỗ không ai biết chuyện gì đang xảy ra cho tới lúc khách đứng trước quầy.

🎯

Đúng con SIM đã bán

Mỗi đơn giữ riêng một số seri cụ thể. Nhân viên quét đúng con đó mới giao được; đưa con khác phải nhập lý do và để lại dấu vết. Khách không nhận phải một con SIM đã kích hoạt từ tuần trước.

📦

Kho là số thật

SIM chỉ tính là dùng được sau khi quầy xác nhận đã cầm trong tay. Hàng đang trên đường hiển thị riêng. Bạn không bán một con SIM chưa tới nơi.

🔔

Hết hàng là biết trước

Tồn kho đọc được qua API trước khi bán. Đơn vượt quá số còn lại bị từ chối ngay kèm con số cụ thể — thay vì phát hiện lúc đã cầm tiền của khách.

🧾

Đối soát tách bạch

Mỗi đơn đã giao ghi lại đúng số seri đã trao, thời điểm, và ai giao. Phí khách không tới tính riêng, không trộn vào tiền giao SIM.

👤

Quầy không biết bạn là ai

Nhân viên quầy thấy một mã bốn ký tự thay cho tên công ty bạn. Cắt tại máy chủ, không phải ẩn trên màn hình. Bạn đăng nhập xem được đúng cái họ thấy.

🧪

Thử trước, thật sau

Môi trường thử nghiệm có kho riêng, đơn riêng, tự nạp lại được, không ai phải ra sân bay. Dựng xong đổi sang khoá thật — không sửa một dòng mã nào.

Kết nối

Nối hệ thống của bạn mất một buổi

Một địa chỉ máy chủ cho cả môi trường thử lẫn thật. Đổi từ thử sang thật là đổi khoá, không phải đổi địa chỉ — nên không có chỗ nào để sót khi lên thật.

POST /api/partner/v1/orders

{
  "partnerRef":  "WEB-2026-00123",
  "airportCode": "SGN",
  "carrierCode": "vinaphone",
  "qty":         2,
  "flightNo":    "VJ862",
  "meetAt":      "2026-11-02T08:00:00+07:00",
  "guestName":   "Kim Min-jun"
}

Không phải gửi số seri — hệ thống tự chọn và giữ trong kho của bạn. Gọi lại cùng một mã đơn thì vẫn ra đúng một đơn, không đẻ thêm.

ViệcCó sẵn
Đẩy đơn, tra đơn, huỷ đơn✓
Xem tồn kho trước khi bán✓
Nhận tin khi giao xong, có chữ ký✓
Dò lại khi hệ thống bạn chết✓
Môi trường thử nghiệm đầy đủ✓
Tự lấy khoá, tự khoá theo IP✓
Nhập đơn bằng tay nếu chưa nối API✓
Đọc tài liệu đầy đủ
Dành cho khách của bạn

Khách vừa xuống máy bay chỉ sợ một thứ: không tìm thấy ai

Chúng tôi làm sẵn một trang hướng dẫn nhận SIM để bạn gửi cho khách — ba bước, không nhắc tên chúng tôi, không bán thêm gì. Gửi link, hoặc chép nội dung về trang của chính bạn.

Xem trang hướng dẫn cho khách →
Hỏi đáp

Những câu đại lý hay hỏi

Quầy sân bay vốn là nơi bán SIM. Cái gì ngăn họ bán thẳng cho khách của tôi?

Đúng, quầy là nơi bán SIM — đó là lý do họ giao được hàng cho bạn. Ba thứ ngăn chuyện bắt tay thẳng: họ không thấy tên công ty bạn (chỉ một mã bốn ký tự); khách tới quầy đã trả tiền rồi, nhận đúng SIM của bạn trong bao bì của bạn; và chúng tôi ăn phí trên mỗi lần giao chứ không ăn chênh lệch giá SIM, nên không có động cơ can thiệp vào giá hay tệp khách của ai.

Quan trọng hơn: bạn kiểm tra được. Đăng nhập, mở một đơn thật, xem đúng những gì nhân viên quầy nhìn thấy trên màn hình của họ.

Các anh có bán SIM cho khách của tôi không?

Không. Chúng tôi không có thương hiệu SIM nào bán ra thị trường và không liên hệ với khách của bạn để chào bất cứ thứ gì. Thứ duy nhất khách nhận từ hệ thống là mã đón khách — và bạn tắt được cả cái đó để tự gửi trong thư mang thương hiệu của mình.

SIM là của ai, hàng ai nhập?

Của bạn. Bạn nhập SIM từ nhà mạng theo giá và gói của bạn, gửi ra quầy, và vẫn sở hữu lô hàng đó trong kho. Chúng tôi không mua, không bán lại, không định giá hộ.

Nếu khách không tới thì sao?

SIM được nhả về kho của bạn để bán lại, và hệ thống báo cho bạn biết. Phí cho chuyến ra sân bay bị lỡ tính riêng và hiện thành một dòng tách bạch trong đối soát.

Chúng tôi chưa có lập trình viên, có dùng được không?

Được. Có màn hình để nhập đơn bằng tay, khai lô SIM, theo dõi kho và xem đối soát. API là để tự động hoá khi bạn sẵn sàng, không phải điều kiện để bắt đầu.

Dữ liệu của chúng tôi có lẫn với đại lý khác không?

Không. Mỗi đại lý chỉ thấy kho, đơn và số tiền của chính mình. Khoá API gắn cứng với một đại lý và không gọi được sang phạm vi của ai khác. Bạn còn khoá được khoá API theo địa chỉ IP máy chủ của mình, để lộ khoá ra ngoài cũng không ai gọi được từ chỗ khác.

Sân bay nào đang chạy?

Tân Sơn Nhất và Nội Bài. Sân bay khác mở theo nhu cầu — nếu bạn có lượng khách đều ở một sân bay chưa có trong danh sách, liên hệ để bàn.

Bắt đầu thế nào

Nói cho chúng tôi biết bạn bán ở sân bay nào và sản lượng tháng khoảng bao nhiêu. Chúng tôi mở tài khoản thử nghiệm để bạn chạy thử trọn vòng trước khi cam kết gì.

Liên hệ hợp tác