API dữ liệu cho đối tác

Tiếp thị bằng phần thưởng dữ liệu

Tặng dữ liệu du lịch quốc tế làm phần thưởng trên ứng dụng, web hoặc trò chơi của bạn. Chỉ với một mã phiếu giảm giá, khách hàng có thể nhận eSIM mới hoặc thậm chí nạp thêm vào eSIM đang dùng.

190+
Quốc gia và khu vực hỗ trợ
4
Bước gọi API là xong
0
Gánh nặng tồn kho & vận chuyển
Cách thức hoạt động

Chỉ cần 4 lệnh gọi APIlà hoàn tất phần thưởng dữ liệu

Tạo mã phiếu giảm giá, hiển thị cho khách hàng và khách hàng sử dụng. TripTok sẽ xử lý việc tạo eSIM, hướng dẫn kích hoạt và nạp thêm.

  1. 1

    Tạo mã phiếu giảm giá

    Chọn sản phẩm eSIM cùng số lượng muốn thưởng và tạo mã qua API. Chi phí sẽ được trừ trước vào tín dụng theo giá bán của TripTok.

  2. 2

    Gửi mã cho khách hàng

    Hiển thị mã phiếu giảm giá qua bất kỳ kênh nào bạn muốn: màn hình ứng dụng, thông báo đẩy, SMS hoặc email. Khách hàng có thể dùng ngay mà không cần đăng ký tài khoản TripTok.

  3. 3

    Khách hàng yêu cầu sử dụng

    Khi khách hàng nhấn 'Sử dụng', hệ thống sẽ gọi API thêm một lần nữa. Khách hàng sẽ nhận liên kết kích hoạt eSIM mới hoặc được nạp thêm dung lượng tương ứng vào eSIM đang dùng.

  4. 4

    Khách hàng tự kích hoạt

    Khách hàng mở liên kết để tự cài đặt và kích hoạt trước chuyến đi. Phiếu giảm giá chưa dùng có thể được hoàn tiền lại vào tín dụng.

Trường hợp sử dụng

Các ứng dụng thực tế

Đáng nhớ hơn tiền mặt hay điểm thưởng, và dễ vận hành hơn quà tặng điện tử thông thường.

Phần thưởng sự kiện game & ứng dụng

Thưởng dữ liệu du lịch khi người dùng đạt cấp độ, điểm danh hoặc đạt thứ hạng cao. Bạn cũng có thể tạo điểm đổi vật phẩm trong game lấy dữ liệu.

Đổi điểm & hội viên

Cho phép đổi điểm tích lũy lấy phiếu giảm giá dữ liệu như Nhật Bản 1GB, Mỹ 3GB. Bạn có thể định trước số lượng đổi và chi phí.

Quà tặng mua hàng & phần thưởng đánh giá

Tặng kèm dữ liệu địa phương cho khách mua vé máy bay, phòng khách sạn hoặc đồ du lịch. Cũng rất phù hợp làm phần thưởng viết đánh giá.

Thưởng xem quảng cáo, khảo sát & giới thiệu

Tặng phiếu giảm giá dữ liệu khi xem quảng cáo, làm khảo sát hoặc giới thiệu bạn bè. Trạng thái sử dụng của từng mã đều được kiểm tra dễ dàng qua API.

Lý do chọn phần thưởng dữ liệu

Lý do người vận hành yêu thích

Chi phí được cố định từ trước

Giá bán của TripTok sẽ được trừ vào tín dụng khi tạo phiếu. Dù sau này giá có thay đổi thì các phiếu đã tạo vẫn giữ nguyên mức giá đó.

Được hoàn lại nếu không sử dụng

Với các phiếu giảm giá khách hàng không sử dụng, bạn có thể khôi phục lại tín dụng chỉ bằng một lệnh gọi API hoàn tiền, kể cả sau khi hết hạn. Hoàn toàn không lo hao hụt chi phí tồn kho.

Không lo tồn kho hay vận chuyển

Vì không có sản phẩm vật lý nên không lo tồn kho hay giao hàng, hướng dẫn cài đặt và kích hoạt eSIM sẽ do TripTok thực hiện bằng ngôn ngữ của khách hàng.

Quay lại nhờ nạp thêm dữ liệu

Có thể nạp thêm dữ liệu vào eSIM khách hàng đang dùng bằng chính phiếu giảm giá đó. Tạo thêm lý do để trao thưởng ngay cả trong chuyến đi.

Hơn 190 quốc gia, chỉ chọn sản phẩm bạn muốn

Chọn sản phẩm phần thưởng từ danh mục của TripTok như Nhật Bản, Mỹ, Châu Âu, Đông Nam Á,... Quốc gia, dung lượng và thời hạn do người vận hành quyết định.

Mọi mã số đều được theo dõi

Trạng thái phát hành, sử dụng, nạp thêm, hoàn tiền và mã định danh khách hàng đều được lưu theo từng mã phiếu giảm giá. Dễ dàng đối soát và hỗ trợ khách hàng.

Partner API

Tích hợp chỉ với 4 lệnh gọi REST

Sử dụng trực tiếp khóa API đối tác và tín dụng hiện có. Tài liệu chi tiết và Swagger sẽ được cung cấp sau khi đối tác được phê duyệt.

  • Tạo phiếu giảm giá
    POST /prepaid-data-coupons

    Khi gửi thông tin sản phẩm và số lượng, mã phiếu giảm giá sẽ được tạo và trừ vào tín dụng. Cùng một ID yêu cầu sẽ không bị trừ hai lần.

  • Dùng cho eSIM mới
    POST /prepaid-data-coupons/{code}/redeem

    Khi gửi mã phiếu giảm giá, eSIM sẽ được tạo và gửi liên kết kích hoạt cho khách hàng. Khách hàng sẽ tự kích hoạt trực tiếp từ liên kết.

  • Nạp thêm vào eSIM đang dùng
    POST /prepaid-data-coupons/{code}/topup

    Khi gửi mã phiếu giảm giá và ICCID, eSIM cùng nhà mạng và quốc gia sẽ được nạp thêm ngay dung lượng tương ứng của phiếu giảm giá.

  • Hoàn tiền chưa sử dụng
    POST /prepaid-data-coupons/{code}/refund

    Hủy phiếu giảm giá chưa sử dụng và nhận lại số tiền đã trừ vào tín dụng.

Ví dụ yêu cầu
# 1) issue a coupon (credit is charged now)
POST /api/v1/partner/prepaid-data-coupons
{ "requestId": "reward-000123", "packageId": "JP_1_7", "externalUserId": "user-98765" }
→ { "coupons": [ { "code": "VK7M2QXR9TAB", "priceUSD": 4.5 } ] }

# 2a) customer taps "use" → new eSIM + activation link
POST /api/v1/partner/prepaid-data-coupons/VK7M2QXR9TAB/redeem
{ "endCustomer": { "email": "user@example.com" } }
→ { "activationUrl": "https://ttok.im/Ab12", "order": { ... } }

# 2b) or top up the eSIM the customer already uses
POST /api/v1/partner/prepaid-data-coupons/VQ2N7XK4PRM9/topup
{ "iccid": "8901234567890123456" }
→ { "topup": { "dataMB": 1024, "validityDays": 7 } }

Kiểm tra các trường yêu cầu/phản hồi, mã lỗi và quy tắc lũy đẳng trong hướng dẫn và Swagger được cung cấp sau khi đối tác được phê duyệt.

Billing

Chi phí được luân chuyển như sau

  1. 1Nạp thêm tín dụng (trên trang tổng quan đối tác hoặc qua người phụ trách)
  2. 2Khi tạo phiếu giảm giá, hệ thống sẽ trừ: giá bán sản phẩm × số lượng
  3. 3Không phát sinh thêm chi phí khi khách hàng sử dụng — dù là eSIM mới hay nạp thêm
  4. 4Nếu hoàn tiền phiếu giảm giá chưa dùng, toàn bộ số tiền đó sẽ được hoàn lại
FAQ

Câu hỏi thường gặp

Không. Việc sử dụng phiếu giảm giá được máy chủ đối tác xử lý qua API, khách hàng chỉ cần mở liên kết kích hoạt nhận được. Bạn cũng có thể gửi liên kết này qua tin nhắn hoặc email.

Hãy chọn dữ liệu du lịch nước ngoàilàm phần thưởng sự kiện tiếp theo

Vui lòng để lại yêu cầu hợp tác, nhân viên phụ trách sẽ tư vấn về gói sản phẩm và tín dụng.