Verkoop eSIM's via onze API

U krijgt een partneraccount. Meld aan en open "API en saldo" in het portaal. Maak daar 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, bewaar hem veilig op uw server.

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.

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"}'

Basis-URL: https://travel.netcommobile.com/api/public/partner/v1. Authenticatie via de header Authorization: Bearer uw_sleutel.

export BASE_URL="https://travel.netcommobile.com"
export PARTNER_API_KEY="ntp_uw_sleutel"

# 1. Bundels zoeken (met uw nettoprijs)
curl -s "$BASE_URL/api/public/partner/v1/plans?destination=Japan&limit=20" \
  -H "Authorization: Bearer $PARTNER_API_KEY"

# 2. Bestelling plaatsen
curl -s -X POST "$BASE_URL/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",
    "quantity": 1,
    "reference": "uw-referentie-001"
  }'

# 3. Bestellingen opvolgen
curl -s "$BASE_URL/api/public/partner/v1/orders?limit=25" \
  -H "Authorization: Bearer $PARTNER_API_KEY"

Het antwoord van stap 2 bevat meteen iccid, activation_code, qr_code_url en een status_url die u aan uw klant kunt geven.

• De sleutel blijft op uw server, roep de API nooit vanuit de browser aan.
• 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.

Fouten hebben altijd dezelfde vorm:

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

Limieten: catalogus 120 per minuut, bestellen 20 per minuut, opvolgen 120 per minuut, saldo 60 per minuut. Elk antwoord bevat X-RateLimit headers.

Verbind Claude, ChatGPT, Cursor of Lovable met https://travel.netcommobile.com/mcp. U meldt zich eenmalig aan met uw account, daarna werkt de assistent in uw naam met 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.

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

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.