API Dati per Partner

Fai marketing con premi in dati

Offri dati per viaggi all'estero come ricompensa nella tua app, sul tuo sito o nel tuo gioco. Con un solo codice coupon, i clienti ricevono un'eSIM o possono persino ricaricare quella già in uso.

190+
Paesi e regioni supportati
4
Chiamate API e hai fatto
0
Zero inventario e spedizioni
How it works

Bastano 4 chiamate APIper distribuire i dati premio

Genera il codice coupon, mostralo al cliente e lascia che lo utilizzi. Alla creazione dell'eSIM, alle istruzioni di attivazione e alla ricarica ci pensa TripTok.

  1. 1

    Genera il codice coupon

    Scegli il prodotto eSIM e la quantità da premiare, quindi genera il codice coupon tramite API. L'importo viene detratto in anticipo dai tuoi crediti in base al prezzo di vendita di TripTok.

  2. 2

    Comunica il codice al cliente

    Mostra il codice coupon sul canale che preferisci: schermata dell'app, notifica push, SMS o email. I clienti possono usarlo senza registrarsi a TripTok.

  3. 3

    Il cliente richiede l'uso

    Quando il cliente tocca "Usa", viene effettuata un'altra chiamata API. Riceverà un link di attivazione per una nuova eSIM oppure il volume verrà subito ricaricato sulla sua eSIM già in uso.

  4. 4

    Attivazione diretta per il cliente

    Prima di partire, il cliente apre il link per installare e attivare l'eSIM in autonomia. I coupon non utilizzati possono essere rimborsati e riaccreditati.

Use cases

Ideale per questi scenari

Più memorabile di contanti o punti, più semplice da gestire rispetto ai buoni regalo tradizionali.

Premi per eventi su app e giochi

Offri dati di viaggio per il raggiungimento di livelli, accessi giornalieri o traguardi in classifica. Puoi anche creare un negozio per convertire le valute di gioco in dati.

Conversione punti e programmi fedeltà

Converti i punti accumulati in coupon dati, come 1 GB per il Giappone o 3 GB per gli USA. Puoi stabilire in anticipo quantità di conversione e costi.

Omaggi con acquisto e premi recensione

Regala dati locali a chi acquista biglietti aerei, alloggi o accessori da viaggio. Perfetto anche come ricompensa per chi lascia una recensione.

Premi per annunci, sondaggi e referral

Distribuisci coupon dati per la visione di annunci, la compilazione di sondaggi o l'invito di amici. Lo stato di utilizzo di ciascun codice è verificabile via API.

Why data rewards

Perché i gestori lo adorano

Costi stabiliti in anticipo

Quando generi un coupon, il prezzo di vendita di TripTok viene detratto dai crediti. Anche se i prezzi cambiano in seguito, i coupon già creati mantengono lo stesso valore.

Se non utilizzati, vieni rimborsato

Per i coupon non utilizzati dai clienti, i crediti vengono ripristinati anche dopo la scadenza con una semplice chiamata API di rimborso. Nessuna perdita di magazzino.

Zero inventario e spedizioni

Nessun prodotto fisico significa zero scorte e zero spedizioni. TripTok fornisce le istruzioni di installazione e attivazione dell'eSIM nella lingua del cliente.

Tornano da te grazie alla ricarica

Con lo stesso coupon, i clienti possono aggiungere più dati all'eSIM che stanno già usando. Un ottimo motivo per premiarli anche durante il viaggio.

Oltre 190 Paesi, solo i prodotti che desideri

Scegli i prodotti premio dal catalogo TripTok: Giappone, Stati Uniti, Europa, Sud-est asiatico e non solo. Sei tu a decidere Paese, dati e durata.

Tracciamento completo di ogni codice

Lo stato di emissione, utilizzo, ricarica e rimborso, insieme all'identificativo del cliente, vengono registrati per ogni codice coupon. Riconciliazione e assistenza clienti semplicissime.

Partner API

Integrazione con solo quattro chiamate REST

Usa direttamente la tua chiave API partner e i crediti esistenti. La documentazione dettagliata e Swagger saranno disponibili dopo l'approvazione del partner.

  • Crea coupon
    POST /prepaid-data-coupons

    Invia prodotto e quantità per generare i codici coupon e scalare i crediti. Lo stesso ID richiesta non verrà mai addebitato due volte.

  • Usa come nuova eSIM
    POST /prepaid-data-coupons/{code}/redeem

    Invia il codice coupon per creare un'eSIM e ricevere un link di attivazione per il cliente. Il cliente effettua l'attivazione direttamente dal link.

  • Ricarica un'eSIM esistente
    POST /prepaid-data-coupons/{code}/topup

    Invia il codice coupon e l'ICCID per ricaricare all'istante l'eSIM dello stesso operatore e Paese con i dati previsti dal coupon.

  • Rimborso non utilizzati
    POST /prepaid-data-coupons/{code}/refund

    Annulla i coupon non utilizzati e ricevi indietro l'importo scalato sotto forma di crediti.

Esempio di richiesta
# 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 } }

Consulta i campi di richiesta e risposta, i codici di errore e le regole di idempotenza nella guida e su Swagger forniti dopo l'approvazione del partner.

Billing

Come funzionano i costi

  1. 1Ricarica i crediti (dalla dashboard partner o tramite il tuo referente)
  2. 2Alla creazione del coupon, viene scalato il prezzo di vendita del prodotto × quantità
  3. 3Nessun costo aggiuntivo quando il cliente lo usa, sia per una nuova eSIM che per una ricarica
  4. 4Rimborsando un coupon non utilizzato, l'intero importo viene riaccreditato
FAQ

Domande frequenti

No. L'utilizzo del coupon viene gestito dal server del partner tramite API, e il cliente deve solo aprire il link di attivazione ricevuto. Puoi inviare lo stesso link anche via SMS, email o app di messaggistica.

Per il prossimo premio evento,scegli i dati per i viaggi all'estero

Invia una richiesta di partnership e un responsabile ti guiderà sui pacchetti e sui crediti.