Reseller API

Schnellstart

1. 1. API-Schlüssel erstellen

   Nach der Freigabe Ihres Wiederverkäuferkontos erstellen Sie im Dashboard einen Schlüssel. Ein prk_live_-Schlüssel erzeugt echte Bestellungen, ein prk_test_-Schlüssel ist eine Sandbox ohne Abrechnung und ohne Produktion. Der vollständige Schlüssel wird nur einmal angezeigt.

2. 2. Preis abfragen

   POST /quotes mit Positionen und Lieferland liefert Ihren Preis inklusive Rabatt, MwSt. und Versand.

3. 3. Bestellung aufgeben

   POST /orders mit einem Idempotency-Key-Header (zum Beispiel Ihrer eigenen Bestellnummer). Eine Wiederholung mit demselben Schlüssel erzeugt nie eine zweite Bestellung.

4. 4. Webhooks empfangen

   Registrieren Sie einen https-Endpunkt und erhalten Sie Statusänderungen, etwa „versendet“ mit Sendungsnummer.

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

Authentifizierung

Senden Sie Ihren Schlüssel als Authorization: Bearer prk_live_... Schlüssel können Scopes haben; ein Schlüssel ohne Scopes darf alles.

Mit einem prk_test_-Schlüssel werden Bestellungen angelegt, aber weder abgerechnet noch an die Produktion übergeben.

Pro Schlüssel höchstens 120 Anfragen pro Minute, dazu Kontingente pro Konto für Angebote und Bestellungen. Jede Antwort enthält RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset (Sekunden) für das strengste geltende Limit; darüber folgt 429 mit einem Retry-After-Header.

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

Endpunkte

So funktioniert die API

Webhooks

Wir senden einen POST mit JSON an Ihren Endpunkt, mit den Headern X-Printen-Event, X-Printen-Delivery, X-Printen-Timestamp und X-Printen-Signature. Antworten Sie innerhalb von 10 Sekunden mit einem 2xx-Status. Schlägt das fehl, versuchen wir es etwa 24 Stunden lang erneut. Ein Event kann mehrfach ankommen: deduplizieren Sie über das Feld id.

Events

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

Signatur prüfen

X-Printen-Signature ist v1= gefolgt vom hex HMAC-SHA256 von „Zeitstempel.roher Body“ mit dem Geheimnis Ihres Endpunkts. Lehnen Sie Nachrichten mit einem Zeitstempel älter als 5 Minuten ab.

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)

Fehler

Jeder Fehler hat die Form {"error": {"code": "...", "message": "...", "details": [...]}}. 400 = fehlerhafte Anfrage; 422 = gültige Anfrage, die nicht ausführbar ist (siehe details); 401, 403, 404, 409 und 429 wie üblich; 500 nur bei einem Fehler auf unserer Seite. Beträge sind immer in Eurocent.