Developer hub

Verkoop eSIM's via onze API

Een koppeling: catalogus met uw nettoprijs, bestellingen die meteen geleverd worden, opvolging en saldo. Testen doet u gratis in de sandbox. Liever geen vaste integratie? Dezelfde mogelijkheden staan klaar als MCP-tools voor uw AI-assistent.

Partner worden Snelstart bekijken

U vraagt een partneraccount aan via het formulier. Na goedkeuring maakt u in uw paneel meteen API-sleutels aan en test u gratis in de sandbox.

5: endpoints
REST: JSON over HTTPS
Gratis: sandbox

Basis-URL

https://travel.netcommobile.com/api/public/partner/v1

Eerste bestelling

export PARTNER_API_KEY="ntp_uw_sleutel"

curl -s -X POST "https://travel.netcommobile.com/api/public/partner/v1/orders" \
  -H "Authorization: Bearer $PARTNER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"package_code":"JP-30D-10GB","customer_email":"klant@voorbeeld.be"}'

Snelstart

Vraag een partneraccount aan via Partner worden. Na goedkeuring meldt u aan in het partnerportaal en opent u "API en saldo".
Maak een sleutel met de rechten die u nodig heeft: catalog.read, orders.write, orders.read en wallet.read. De sleutel wordt maar één keer getoond.
Plaats uw eerste bestelling met de code hierboven, eerst in de sandbox.

Authenticatie

Authenticatie en conventies

Headers

Authorization: Bearer ntp_uw_sleutel
Content-Type: application/json
Idempotency-Key: 6b1e9f0c-6a2f-4d7f-9a1b-1f0d2c3e4a5b

De sleutel blijft op uw server, roep de API nooit vanuit de browser aan.
Werkt uw client niet met Bearer-tokens? Dan mag de sleutel ook in de header X-API-Key.
Stuur altijd een Idempotency-Key mee bij bestellingen: een herhaalde aanvraag levert nooit een tweede eSIM en boekt niet twee keer af.
Alle bedragen zijn eurocent (integers, inclusief btw), tijdstippen zijn ISO 8601 UTC.

Sandbox

Zet bij het aanmaken de schakelaar "Testsleutel (sandbox)" aan. Die sleutel begint met ntp_test_ en werkt op exact dezelfde endpoints. Bestellingen verbruiken geen echt saldo en leveren geen echte eSIM, u krijgt fictieve activatiegegevens terug. Elke sandbox start met 1.000 euro fictief saldo en kan met één knop teruggezet worden.

Sandbox

curl -s -X POST https://travel.netcommobile.com/api/public/partner/v1/orders \
  -H "Authorization: Bearer ntp_test_uw_sleutel" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: test-001" \
  -d '{"package_code":"JP-30D-10GB","customer_email":"test@voorbeeld.be"}'

Endpoints

Klik een endpoint open voor parameters en een voorbeeldantwoord.

Dekking per leverancier

Wij kopen bij twee leveranciers in en kiezen per bundel automatisch de goedkoopste. Dit overzicht toont per land hoeveel bundels elke leverancier op dit moment aanbiedt.

Dekking laden...

Live uit de catalogus, ververst om de vijf minuten.

Fouten en limieten

Fouten hebben altijd dezelfde vorm:

Foutantwoord

{ "error": { "code": "insufficient_balance", "message": "Onvoldoende saldo." } }

HTTP	Code	Betekenis
400	invalid_body	ontbrekend of ongeldig veld, of ongeldige JSON
401	unauthorized	sleutel ontbreekt, onbekend of ingetrokken
402	insufficient_balance	te weinig prepaid saldo
403	forbidden	sleutel mist de scope
404	not_found	bestelling bestaat niet voor deze partner
429	rate_limited	te veel aanvragen, zie Retry-After
500	server_error	onverwachte fout bij ons
502		levering mislukt: antwoord bevat error en status failed, saldo teruggeboekt

GET /plans120 per minuut

POST /orders20 per minuut

GET /orders60 per minuut

GET /orders/{id}120 per minuut

GET /wallet60 per minuut

Elk antwoord bevat X-RateLimit headers met uw resterende quota.

MCP en AI-assistenten

Verbind Claude, ChatGPT of Cursor met https://travel.netcommobile.com/mcp. U meldt zich eenmalig aan met uw account, daarna werkt de assistent in uw naam met search_plans, partner_search_plans, partner_create_order, list_my_orders, get_my_order en partner_wallet_balance. Stap voor stap uitleg per assistent staat op onze koppelpagina.

mcp.json

{
  "mcpServers": {
    "netcom-travel": {
      "type": "http",
      "url": "https://travel.netcommobile.com/mcp"
    }
  }
}

Status en hulp

GET /api/public/health geeft onze dienststatus, bruikbaar voor uw eigen alerting. Vragen of een levertest? Mail support@netcommobile.com of uw vaste contactpersoon bij Netcom.