API Data Rakan Kongsi

Mulakan pemasaran ganjaran data

Berikan data perjalanan luar negara sebagai ganjaran dalam aplikasi, web atau permainan anda. Cukup dengan satu nombor kupon, pelanggan boleh menerima eSIM atau menambah nilai eSIM sedia ada.

Pertanyaan Kerjasama Lihat Perkhidmatan Rakan Kongsi

190+: Negara & Kawasan Tersedia
4: Selesai dengan Panggilan API
0: Beban Inventori & Penghantaran

Cara ia berfungsi

Hanya empat panggilan API
untuk selesaikan ganjaran data

Cipta nombor kupon, paparkan kepada pelanggan, dan biarkan mereka menggunakannya. TripTok mengendalikan penjanaan eSIM, panduan pengaktifan, dan tambah nilai.

1
Cipta nombor kupon
Pilih produk eSIM ganjaran dan kuantiti, kemudian cipta nombor kupon melalui API. Kos ditolak terlebih dahulu daripada kredit berdasarkan harga jualan TripTok.
2
Maklumkan nombor kepada pelanggan
Tunjukkan nombor kupon melalui saluran pilihan anda seperti skrin aplikasi, pemberitahuan tolak, SMS, atau e-mel. Pelanggan boleh menggunakannya tanpa mendaftar di TripTok.
3
Permintaan penggunaan oleh pelanggan
Apabila pelanggan mengetik 'Gunakan', panggil API sekali lagi. Mereka akan menerima pautan pengaktifan eSIM baharu, atau kuantiti data tersebut akan terus ditambah nilai ke eSIM sedia ada.
4
Pengaktifan dilakukan oleh pelanggan
Pelanggan membuka pautan untuk memasang dan mengaktifkan eSIM sendiri sebelum perjalanan. Kupon yang tidak digunakan boleh dibayar balik ke dalam baki kredit.

Contoh penggunaan

Gunakan untuk situasi ini

Lebih diingati berbanding wang tunai atau mata ganjaran, dan pengurusannya lebih mudah daripada baucar hadiah.

Ganjaran acara permainan & aplikasi

Berikan data perjalanan sebagai ganjaran pencapaian tahap, log masuk harian, atau kedudukan. Anda juga boleh membina pusat pertukaran barangan permainan kepada data.

Penebusan keahlian & mata ganjaran

Tukarkan mata terkumpul kepada kupon data seperti Jepun 1GB atau AS 3GB. Kuantiti pertukaran dan kos boleh ditetapkan lebih awal.

Hadiah pembelian & ganjaran ulasan

Berikan data tempatan percuma kepada pelanggan yang membeli tiket penerbangan, penginapan atau kelengkapan perjalanan. Sesuai juga sebagai ganjaran menulis ulasan.

Ganjaran iklan, tinjauan & rujukan

Berikan kupon data untuk tontonan iklan, penyertaan tinjauan atau rujukan rakan. Status penggunaan setiap nombor boleh disemak melalui API.

Kelebihan ganjaran data

Sebab ia digemari pengendali

Kos ditetapkan lebih awal

Harga jualan TripTok ditolak daripada kredit semasa mencipta kupon. Walaupun harga berubah kemudian, kupon yang telah dicipta kekal pada kos asal.

Boleh dikembalikan jika tidak digunakan

Bagi kupon yang tidak digunakan oleh pelanggan, kredit boleh dipulihkan selepas tamat tempoh dengan hanya satu panggilan API bayaran balik. Tiada kerugian inventori.

Tiada inventori atau penghantaran

Tiada barangan fizikal bermakna tiada inventori dan penghantaran, dan TripTok menyediakan panduan pemasangan serta pengaktifan eSIM dalam bahasa pelanggan.

Kembali semula dengan tambah nilai

Pelanggan boleh menambah lebih banyak data pada eSIM sedia ada menggunakan kupon yang sama. Memberi anda sebab untuk menawarkan ganjaran walaupun semasa perjalanan.

190+ negara, hanya produk yang anda inginkan

Pilih produk ganjaran daripada katalog TripTok seperti Jepun, AS, Eropah, Asia Tenggara dan banyak lagi. Pengendali menetapkan negara, kuota data dan tempoh sah.

Setiap nombor dijejaki

Status pengeluaran, penggunaan, tambah nilai dan bayaran balik serta pengecam pelanggan direkodkan bagi setiap nombor kupon. Memudahkan penyelarasan dan perkhidmatan pelanggan.

Partner API

Penyepaduan dengan hanya empat panggilan REST

Gunakan kunci API rakan kongsi dan kredit sedia ada anda. Dokumentasi terperinci dan Swagger disediakan selepas kelulusan rakan kongsi.

Cipta kupon
POST /prepaid-data-coupons
Hantar produk dan kuantiti untuk menjana nombor kupon dan menolak kredit. ID permintaan yang sama tidak akan ditolak dua kali.
Gunakan sebagai eSIM baharu
POST /prepaid-data-coupons/{code}/redeem
Hantar nombor kupon untuk mencipta eSIM dan menerima pautan pengaktifan pelanggan. Pelanggan mengaktifkannya sendiri melalui pautan tersebut.
Tambah nilai pada eSIM sedia ada
POST /prepaid-data-coupons/{code}/topup
Hantar nombor kupon dan ICCID untuk menambah nilai kuota kupon serta-merta pada eSIM daripada pembekal dan negara yang sama.
Bayaran balik belum diguna
POST /prepaid-data-coupons/{code}/refund
Batalkan kupon yang tidak digunakan dan dapatkan semula jumlah yang ditolak sebagai kredit.

Contoh permintaan

# 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 } }

Medan permintaan dan respons, kod ralat, serta peraturan keteguhan idempoten boleh disemak dalam panduan dan Swagger yang diberikan selepas kelulusan rakan kongsi.

Billing

Begini aliran kos berfungsi

1Tambah nilai kredit (papan pemuka rakan kongsi atau pengurus akaun)
2Apabila mencipta kupon, (harga jualan produk × kuantiti) akan ditolak
3Tiada kos tambahan apabila pelanggan menggunakannya — sama ada untuk eSIM baharu atau tambah nilai
4Apabila membuat bayaran balik kupon yang belum digunakan, jumlah tersebut dikembalikan sepenuhnya

FAQ

Soalan Lazim

Tidak. Penebusan kupon dikendalikan oleh pelayan rakan kongsi melalui API, dan pelanggan hanya perlu membuka pautan pengaktifan yang diterima. Pautan yang sama juga boleh dihantar melalui Alimtalk, SMS, atau e-mel.

Gunakan data perjalanan luar negara
sebagai ganjaran acara seterusnya

Tinggalkan pertanyaan perkongsian dan pegawai bertugas akan membimbing anda tentang pakej produk dan kredit.

Pertanyaan Perkongsian Lihat Perkhidmatan Rakan Kongsi