API de données pour partenaires

Adoptez le marketing par récompenses de données

Offrez des données mobiles pour l'étranger en récompense sur votre application, site web ou jeu. Avec un simple code promo, vos clients reçoivent une eSIM ou rechargent celle qu'ils utilisent déjà.

Demande de partenariat Découvrir les services partenaires

190+: Pays et régions couverts
4: Appels API suffisent
0: Stock ou livraison à gérer

How it works

Quatre appels API suffisent
pour offrir des données

Générez un numéro de coupon, affichez-le à votre client, et il l'utilise. TripTok s'occupe de la génération de l'eSIM, des instructions d'activation et de la recharge.

1
Créer un numéro de coupon
Choisissez le produit eSIM à offrir ainsi que la quantité, puis générez les numéros de coupon via l'API. Le coût est déduit à l'avance de vos crédits au tarif de vente TripTok.
2
Transmettre le code au client
Affichez le numéro de coupon via le canal de votre choix : écran d'application, notification push, SMS, e-mail... Le client peut l'utiliser sans inscription sur TripTok.
3
Demande d'utilisation par le client
Lorsque le client clique sur « Utiliser », un appel API supplémentaire est effectué. Il reçoit un lien d'activation pour une nouvelle eSIM ou recharge directement son eSIM existante avec le volume correspondant.
4
Activation directe par le client
Le client ouvre le lien avant son voyage pour installer et activer son eSIM en toute autonomie. Les coupons non utilisés peuvent être remboursés sous forme de crédits.

Use cases

Cas d'usage idéaux

Plus mémorable que de l'argent ou des points, et bien plus simple à gérer que des chèques-cadeaux.

Récompenses d'événements (jeux et applis)

Offrez des données de voyage pour récompenser un niveau atteint, une assiduité ou un classement. Vous pouvez également créer une boutique d'échange de monnaie de jeu contre des données.

Échange de points et fidélité

Permettez d'échanger les points cumulés contre des coupons de données, par exemple 1 Go au Japon ou 3 Go aux États-Unis. Définissez les quantités échangeables et les coûts à l'avance.

Cadeaux d'achat et récompenses d'avis

Offrez des données locales en cadeau aux clients achetant des billets d'avion, des hébergements ou des articles de voyage. Idéal également pour récompenser la rédaction d'un avis.

Récompenses pub, sondages et parrainage

Distribuez des coupons de données pour le visionnage de publicités, la participation à des sondages ou le parrainage d'amis. Le statut d'utilisation de chaque coupon est vérifiable par API.

Why data rewards

Pourquoi les gestionnaires l'adorent

Les coûts sont fixés à l'avance

Le tarif de vente TripTok est déduit de vos crédits lors de la création du coupon. Même si les prix évoluent plus tard, les coupons créés conservent leur montant initial.

Remboursement si non utilisé

Si un client n'utilise pas son coupon, vos crédits sont restaurés d'un simple appel à l'API de remboursement, même après expiration. Aucune perte de stock.

Zéro stock, zéro livraison

Comme il s'agit d'un produit numérique, il n'y a ni stock ni livraison, et TripTok fournit les instructions d'installation et d'activation de l'eSIM dans la langue du client.

Faites-les revenir grâce aux recharges

Un même coupon permet aux clients d'ajouter des données à leur eSIM existante. Une excellente raison d'offrir des récompenses même pendant leur voyage.

Plus de 190 pays, uniquement les produits souhaités

Choisissez des produits de récompense dans le catalogue TripTok (Japon, États-Unis, Europe, Asie du Sud-Est, etc.). Le pays, le volume de données et la durée sont définis par l'opérateur.

Suivi complet de chaque numéro

L'historique d'émission, d'utilisation, de recharge, de remboursement et l'identifiant client sont enregistrés pour chaque numéro de coupon. Cela simplifie la facturation et le support client.

Partner API

Intégration via 4 appels REST

Utilisez directement votre clé API partenaire et vos crédits existants. La documentation détaillée et Swagger vous seront fournis après approbation du compte partenaire.

Créer un coupon
POST /prepaid-data-coupons
Indiquez le produit et la quantité pour générer des numéros de coupon et déduire des crédits. Un même identifiant de requête n'est jamais débité deux fois.
Utiliser pour une nouvelle eSIM
POST /prepaid-data-coupons/{code}/redeem
Envoyez le numéro de coupon pour créer une eSIM et recevoir un lien d'activation client. Le client effectue lui-même l'activation depuis ce lien.
Recharger une eSIM existante
POST /prepaid-data-coupons/{code}/topup
Envoyez le numéro de coupon et l'ICCID pour recharger instantanément une eSIM du même fournisseur et pour le même pays avec le volume de données du coupon.
Remboursement des coupons non utilisés
POST /prepaid-data-coupons/{code}/refund
Annulez un coupon non utilisé pour récupérer le montant débité sous forme de crédits.

Exemple de requête

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

Consultez le guide et le Swagger fournis après approbation du partenaire pour connaître les champs de requête/réponse, les codes d'erreur et les règles d'idempotence.

Billing

Fonctionnement de la facturation

1Rechargez vos crédits (sur le tableau de bord partenaire ou auprès de votre responsable)
2Lors de la création du coupon, le montant (prix de vente × quantité) est débité
3Aucun frais supplémentaire lors de l'utilisation par le client, qu'il s'agisse d'une nouvelle eSIM ou d'une recharge
4Si vous faites rembourser un coupon non utilisé, le montant vous est intégralement reversé

FAQ

Foire aux questions

Non. L'utilisation du coupon est gérée via l'API par le serveur du partenaire, et le client n'a qu'à ouvrir le lien d'activation reçu. Vous pouvez aussi envoyer ce lien par Alimtalk, SMS ou e-mail.

Pour vos prochaines récompenses d'événement,
choisissez des données pour les voyages à l'étranger

Laissez une demande de partenariat et un conseiller vous présentera nos offres de produits ainsi que nos crédits.

Demande de partenariat Voir les services partenaires