Reseller API

Snel aan de slag

1. 1. Maak een API-sleutel

   Na goedkeuring van je wederverkopersaccount maak je in je dashboard een sleutel. Een prk_live_-sleutel plaatst echte orders, een prk_test_-sleutel is een sandbox die niets afrekent en niets laat produceren. De volledige sleutel zie je maar één keer.

2. 2. Vraag een prijs op

   POST /quotes met regels en het afleverland geeft je inkoopprijs inclusief korting, btw en verzending.

3. 3. Plaats een order

   POST /orders met een Idempotency-Key header (bijvoorbeeld je eigen ordernummer). Een herhaling met dezelfde sleutel maakt nooit een tweede order.

4. 4. Ontvang webhooks

   Registreer een https-endpoint en ontvang statuswijzigingen, zoals verzonden met tracking.

# Product: customer options with defaults and allowed values (id or any slug)
curl https://www.printen.eu/api/reseller/v1/products/flyers?lang=en \
  -H "Authorization: Bearer prk_test_..." -H "User-Agent: MyShop-Integration/1.0"

# Prijs / quote: only customer options; omitted options get the product-page default.
# quantity = number of pieces (for run-priced products the run: here 1000 flyers)
curl -X POST https://www.printen.eu/api/reseller/v1/quotes \
  -H "Authorization: Bearer prk_test_..." -H "Content-Type: application/json" \
  -H "User-Agent: MyShop-Integration/1.0" \
  -d '{"country":"BE","lines":[{"productId":"<product id>","quantity":1000,"options":{"size":"a5","material":"135gr_gesatineerd_mc","printtype":"44"}},{"resellerSku":"POSTER-A2","quantity":1}]}'

# Order
curl -X POST https://www.printen.eu/api/reseller/v1/orders \
  -H "Authorization: Bearer prk_test_..." -H "Content-Type: application/json" \
  -H "Idempotency-Key: shop-order-1001" \
  -d '{"externalOrderId":"1001","lines":[{"resellerSku":"POSTER-A2","quantity":1,"fileUrl":"https://example.com/design.pdf"}],
       "recipient":{"name":"Anna de Vries","email":"anna@example.com","phone":"+31612345678","address1":"Dorpsstraat 1","postalCode":"1234 AB","city":"Utrecht","country":"NL"}}'

# Webhook
curl -X POST https://www.printen.eu/api/reseller/v1/webhooks \
  -H "Authorization: Bearer prk_live_..." -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/printen-webhook","events":["order.shipped","order.delivered"]}'

Authenticatie

Stuur je sleutel mee als Authorization: Bearer prk_live_... Sleutels kunnen scopes hebben; een sleutel zonder scopes mag alles.

Met een prk_test_-sleutel worden orders aangemaakt maar niet afgerekend en niet doorgezet naar productie.

Per sleutel maximaal 120 verzoeken per minuut, plus accountlimieten voor offertes en orders. Elk antwoord bevat RateLimit-Limit, RateLimit-Remaining en RateLimit-Reset (seconden) voor de strengste limiet die geldt; daarboven volgt 429 met een Retry-After-header.

Base URL: https://www.printen.eu/api/reseller/v1

Endpoints

Zo werkt de API

Webhooks

We sturen een POST met JSON naar je endpoint, met de headers X-Printen-Event, X-Printen-Delivery, X-Printen-Timestamp en X-Printen-Signature. Antwoord binnen 10 seconden met een 2xx-status. Mislukt dat, dan proberen we het ongeveer 24 uur lang opnieuw. Een event kan vaker aankomen: ontdubbel op het veld id.

Events

• order.created
• order.submitted
• order.awaiting_funds
• order.payment_failed
• order.in_production
• order.shipped
• order.delivered
• order.cancelled
• order.file_problem

Handtekening controleren

X-Printen-Signature is v1= gevolgd door de hex HMAC-SHA256 van "timestamp.ruwe body" met het geheim van je endpoint. Weiger berichten met een tijdstempel ouder dan 5 minuten.

Node.js

import crypto from 'node:crypto';

export function verifyPrintenWebhook(rawBody, headers, secret) {
  const timestamp = headers['x-printen-timestamp'];
  const signature = headers['x-printen-signature'] || '';
  if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
  const expected = 'v1=' + crypto.createHmac('sha256', secret)
    .update(`${timestamp}.${rawBody}`).digest('hex');
  return signature.length === expected.length
    && crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
}

PHP

<?php
function verify_printen_webhook(string $rawBody, string $timestamp, string $signature, string $secret): bool {
    if (abs(time() - (int) $timestamp) > 300) return false;
    $expected = 'v1=' . hash_hmac('sha256', $timestamp . '.' . $rawBody, $secret);
    return hash_equals($expected, $signature);
}

Python

import hashlib, hmac, time

def verify_printen_webhook(raw_body: bytes, timestamp: str, signature: str, secret: str) -> bool:
    if abs(time.time() - int(timestamp)) > 300:
        return False
    expected = "v1=" + hmac.new(secret.encode(), timestamp.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature)

Fouten

Elke fout heeft de vorm {"error": {"code": "...", "message": "...", "details": [...]}}. 400 = kapotte aanvraag; 422 = geldige aanvraag die niet uit te voeren is (zie details); 401, 403, 404, 409 en 429 zoals gebruikelijk; 500 alleen bij een fout aan onze kant. Bedragen zijn altijd in eurocenten.