Bỏ qua, tới nội dung chính
OTA & đối tác API

Kết nối 11 hãng tàu cao tốc tại Việt Nam qua một giao diện lập trình: tra lịch chạy, sơ đồ ghế, đặt chỗ, xuất vé và webhook trạng thái.

Xem API referenceĐăng ký tích hợp
REST · JSON
Chuẩn HTTP, UTF-8
Bearer API key
Header Authorization
Webhook
Phản hồi trong 2 giây
api.ferry.vn
1# 1 · Tìm chuyến theo cặp bến và ngày (tham số minh hoạ)
2curl https://api.ferry.vn/api/v1/voyages/findAllRelateByLocationAndDate \
3  -H "Authorization: Bearer $FERRY_API_KEY"
4
5# 2 · Tạo booking (giữ ghế)
6curl -X POST https://api.ferry.vn/api/v1/bookings -d @booking.json
7
8# 3 · Xác nhận xuất vé
9curl -X POST https://api.ferry.vn/api/v1/bookings/confirmToIssue/{id}
10
11# 4 · Trạng thái chuẩn — 10 = đã xuất vé
12curl https://api.ferry.vn/api/v1/bookings/{id}
POST https://your-system.example/webhooks/ferry200 OK
  • 07:00:12booking.createdFVN-7Q2K9
  • 07:00:13order.createdFVN-7Q2K9-1
  • 07:00:31booking.issuedTicketFVN-7Q2K9
  • 07:00:31order.issuedTicketFVN-7Q2K9-1
  • 07:00:33invoice.publishedHĐ 0012841

Vé Ferry VN đang bán trên

  • Trip.com
  • GetYourGuide
  • 12Go
  • Klook
  • Viator
  • Tatinta
Quy ước

Quy ước chung ↗
Tiền tố
/api/v1/<tài-nguyên>
Xác thực
Authorization: Bearer <API_KEY> — khoá do quản trị viên đại lý tạo trên Dashboard
Dữ liệu
application/json, tối đa 1 MB mỗi yêu cầu; trường ngoài schema bị bỏ qua
Phân trang
Con trỏ: limit mặc định 10, tối đa 50; trang sau dùng cursor = nextCursor
Thời gian
Phản hồi theo UTC (ISO-8601); ngày tra cứu gửi YYYY-MM-DD giờ Việt Nam
Tiền tệ
VND, số nguyên
Luồng tích hợp

  1. 01GET/api/v1/voyages/findAllRelateByLocationAndDate

    Tra chuyến & chỗ trống

    Lịch tàu giữa hai bến theo ngày, kèm số chỗ và sơ đồ ghế.

    docs.ferry.vn ↗
  2. 02POST/api/v1/bookings

    Tạo booking

    Ghi nhận hành khách và ghế; booking ở trạng thái 2 kèm hạn thanh toán. API không tự chống lặp: kiểm tra danh sách booking trước khi gửi lại.

    docs.ferry.vn ↗
  3. 03POST/api/v1/bookings/confirmToIssue/{id}

    Xác nhận xuất vé

    Trừ số dư theo giá NET và gửi lệnh xuất vé sang hãng; thành công thì booking chuyển trạng thái 10.

    docs.ferry.vn ↗
  4. 04GET/api/v1/bookings/{id}

    Webhook & đối soát

    Nhận booking.created, booking.issuedTicket…; webhook là tín hiệu, trạng thái chuẩn lấy lại qua API.

    docs.ferry.vn ↗
Độ tươi dữ liệu

Khuyến nghị: cache phía bạn không quá 5 phút cho ngày gần và luôn lấy lại sơ đồ ghế ngay trước khi khách chốt chỗ.

Khoảng ngàyĐồng bộ từ hãng
Hôm nay → 7 ngàyMỗi 30 phút
8 → 14 ngàyMỗi 2 giờ
15 → 45 ngàyMỗi 4 giờ
46 → 90 ngày3 lần mỗi ngày
Chuyến hết chỗQuét lại mỗi 40 phút

Nguồn: docs.ferry.vn/developers/voyages

Go-live

Ferry VN không có môi trường thử giả lập: UAT kết nối thẳng hệ thống hãng, xuất vé thật và trừ tiền thật. Vì vậy mọi lần thử xuất vé đều được thống nhất trước với đội kỹ thuật.

  1. 01

    Nhận thông tin UAT

    Base URL UAT và API key từ quản trị viên; tra endpoint trên API reference.

  2. 02

    Thử luồng booking

    Tìm chuyến và tạo booking. Dừng ở bước tạo booking, chưa gọi confirmToIssue.

  3. 03

    Thoả thuận & chuyến thử

    Ký hợp đồng, thống nhất chuyến tàu và chi phí cho lần xuất vé thật đầu tiên.

  4. 04

    Lên production

    Nhận Base URL và API key production, chuyển lưu lượng và theo dõi vận hành.

Checklist go-live ↗
Đăng ký tích hợp

Kỹ sư Ferry VN sẽ liên hệ trao đổi phạm vi tích hợp và cấp quyền UAT.