Tài liệu API
Hạ tầng giao SIM tại sân bay Việt Nam

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

Đại lý 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 đó.

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.

Chúng tôi không bán SIM

Không bán lẻ, không bán buôn, không có thương hiệu SIM nào của riêng mình, và không bao giờ liên hệ với khách của bạn để bán bất cứ thứ gì. Chúng tôi chỉ làm dịch vụ giao hàng tại quầy sân bay.

Đây không phải một câu quảng cáo. Đó là điều kiện để bạn giao khách hàng của mình cho một bên thứ ba mà không phải lo ngày nào đó bên đó trở thành đối thủ. Một nhà cung cấp vừa lo khâu giao vừa bán SIM thì sớm muộn cũng nhìn vào tệp khách của bạn.

Cách hoạt động

Bốn bước, không ai phải gõ tay

Khách trả tiền trên web của bạn là đơn chảy thẳng sang quầy. Không email qua lại, không bảng tính, không gọi điện xác nhận.

1

Bạn gửi SIM tới quầy

Khai lô SIM vào hệ thống rồi gửi hàng ra sân bay. Nhân viên quầy quét đếm và xác nhận đã cầm đủ — từ lúc đó kho hiển thị đúng số thật, không phải số bạn khai.

2

Khách mua trên web của bạn

Hệ thống của bạn gọi API đẩy đơn sang. Chúng tôi tự chọn và giữ riêng một con SIM cụ thể trong kho của bạn cho khách đó — không ai bán chồng lên nó được nữa.

3

Khách nhận mã QR

Mã đón khách gửi qua email, hoặc trả về API để bạn tự nhét vào thư xác nhận mang thương hiệu của bạn. Khách tới quầy đưa mã, nhân viên quét, xong.

4

Bạn biết ngay khi giao xong

Hệ thống bắn tin về máy chủ của bạn kèm chữ ký xác thực: đã giao, giao thiếu, khách không tới, hay đơn bị huỷ. Không phải ngồi hỏi.

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ầy quét đúng con đó mới giao được; đưa con khác thì phải nhập lý do và để lại dấu vết. Khách không bao giờ nhận nhầm một con SIM đã kích hoạt từ tuần trước.

📦

Kho là số thật

SIM chỉ được tính là dùng được sau khi nhân viên 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 bao giờ 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 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 không cãi nhau

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

🔒

Khách của bạn là của bạn

Chúng tôi không bán SIM và không tiếp cận khách của bạn. Nhân viên quầy không nhìn thấy tên công ty bạn, chỉ thấy một mã định danh. Hai đầu không nhận ra nhau.

🧪

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, và không ai phải ra sân bay. Dựng xong rồi đổi sang khoá thật — không phải sửa một dòng mã nào.

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ì. Bạn gửi link, hoặc chép nội dung vào trang của chính bạn.

Xem trang hướng dẫn cho khách →
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✓
Đọc tài liệu đầy đủ
Hỏi đáp

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

Các anh có bán SIM không?

Không. Không bán lẻ, không bán buôn, không có thương hiệu SIM nào của riêng mình. Chúng tôi chỉ nhận giao hàng tại quầy sân bay cho đại lý. Đó là lý do bạn có thể đưa khách của mình qua đây mà không phải lo.

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, không định giá hộ.

Nhân viên quầy có biết khách là của công ty nào không?

Không. Họ chỉ thấy một mã định danh bốn ký tự thay cho tên công ty bạn. Ngược lại bạn cũng không thấy tên nhân viên quầy. Điều này cố ý, và nó bảo vệ cả hai phía.

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ỡ được tính riêng và hiện thành một dòng tách bạch trong đối soát, không trộn vào tiền giao SIM.

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