Partnership API

Bestel eSIMs vanuit je boekingssysteem, app of kassa. Je krijgt de installatielink en QR-code terug, kunt later bijladen en verbruik lezen, en hoort via webhooks wanneer een eSIM klaar staat. Versie 1.

  • Sleutels per partner

    Telie maakt je sleutels aan, met per sleutel de rechten die je nodig hebt. Intrekken werkt meteen.

  • Sandbox

    Een test-sleutel (tlp_test_) geeft echte antwoorden maar raakt nooit voorraad, geld of het netwerk.

  • Afrekenen op factuur

    Live bestellingen komen op je maandafrekening, precies zoals verkopen aan de balie.

Log in

Stuur bij elk verzoek je sleutel mee: Authorization: Bearer tlp_live_…. Basisadres: https://telie.net/api/partners/v1. Alle paden eindigen op een schuine streep. Maximaal 60 verzoeken per minuut per sleutel; daarboven krijg je 429.

Endpoints

  • GET /ping/geen recht nodig

    Controleert je sleutel; geeft partner, modus (sandbox of live) en rechten terug.

  • GET /catalog/?destination=japancatalog:read

    Bestemmingen en bundels met prijs incl. btw en jouw deel, in centen. Zonder destination: alles.

  • POST /orders/orders:write

    Bestelt een eSIM: {"product", "email", "name"?, "external_id"?}. De reiziger krijgt de eSIM per mail; jij krijgt de installatielink en QR-code.

  • GET /orders/{reference}/orders:read

    Status (pending, paid, delivered, refunded, cancelled), bedragen en per eSIM de installatielink, QR-code en ICCID.

  • POST /orders/{reference}/topups/topups:write

    Laadt een nieuwe bundel op de eSIM van die bestelling: {"product", "external_id"?}. Geen nieuwe installatie nodig.

  • GET /orders/{reference}/usage/usage:read

    Bundels op de eSIM met status, data totaal en over (kB) en einddatum.

Order

Een bestelling met een eigen external_id: een tweede verzoek met dezelfde waarde maakt geen nieuwe bestelling maar geeft de eerste terug (header Idempotent-Replay: true). Bedragen zijn in centen, inclusief 21% btw.

Verzoek
curl -X POST https://telie.net/api/partners/v1/orders/ \
  -H "Authorization: Bearer tlp_test_xxxxxxxx_…" \
  -H "Content-Type: application/json" \
  -d '{"product": "<id uit /catalog/>", "email": "reiziger@voorbeeld.nl", "external_id": "BOEKING-1001"}'
Antwoord
{
  "reference": "TEL-2611-7KQ2M",
  "external_id": "BOEKING-1001",
  "status": "delivered",
  "amounts": { "total_cents": 1000, "partner_cents": 150, "telie_cents": 850, "currency": "EUR", "vat_included": true },
  "esims": [
    { "state": "klaar", "destination": "Japan", "bundle": "5 GB · 15 dagen",
      "iccid": "89…", "install_url": "https://telie.net/esim/installeren/…/", "qr_url": "https://telie.net/api/esim/qr/…/" }
  ]
}

Rechten

  • catalog:readCatalogus en prijzen lezen
  • orders:readBestellingen, installatielink en status lezen
  • orders:writeBestellingen plaatsen
  • topups:writeBundels bijladen op een bestaande eSIM
  • usage:readVerbruik lezen

Webhooks

Geef Telie een https-adres; je krijgt een ondertekengeheim (whsec_…). Gebeurtenissen: order.paid, order.delivered, order.refunded. Controleer de handtekening en of t niet ouder is dan 5 minuten; antwoord met een 2xx-status.

Voorbeeld
Telie-Signature: t=1767225600,v1=5f2b…  (HMAC-SHA256 van "t.body" met je ondertekengeheim)

{ "id": "evt_…", "type": "order.delivered", "created": "2026-11-01T10:00:00Z",
  "data": { "reference": "TEL-2611-7KQ2M", "external_id": "BOEKING-1001", "status": "paid", "total_cents": 1000, "partner_cents": 150 } }

Fouten

Fouten hebben de vorm {"error": {"code": "…", "message": "…"}}.

  • 401De sleutel ontbreekt of klopt niet.
  • 403Het recht of de afrekenwijze ontbreekt.
  • 404Onbekend: de bestelling of het product bestaat niet.
  • 409Nog niet geleverd.
  • 422Ongeldige invoer.
  • 429Te veel verzoeken: wacht even en probeer het opnieuw.

Een sleutel aanvragen of vragen over de koppeling? Meld je aan als partner of mail help@telie.net.

Cookie settings

Choose per type. You can change this at any time via "Cookie settings" at the bottom of every page.