Partner-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.
INLOGO
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 nodigControleert je sleutel; geeft partner, modus (sandbox of live) en rechten terug.
GET /catalog/?destination=japancatalog:readBestemmingen en bundels met prijs incl. btw en jouw deel, in centen. Zonder destination: alles.
POST /orders/orders:writeBestelt 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:readStatus (pending, paid, delivered, refunded, cancelled), bedragen en per eSIM de installatielink, QR-code en ICCID.
POST /orders/{reference}/topups/topups:writeLaadt een nieuwe bundel op de eSIM van die bestelling:
{"product", "external_id"?}. Geen nieuwe installatie nodig.GET /orders/{reference}/usage/usage:readBundels op de eSIM met status, data totaal en over (kB) en einddatum.
Encomendar
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.
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"}'{
"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 lezenorders:readBestellingen, installatielink en status lezenorders:writeBestellingen plaatsentopups:writeBundels bijladen op een bestaande eSIMusage: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.
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.


