Marques & white-label

Le principe

Une marque est l'unité de white-label de votre compte : son nom apparaît comme expéditeur sur l'étiquette et le bon de livraison. Un compte peut avoir plusieurs marques (une par boutique, par exemple) ; chaque commande est rattachée à une marque via brand_id.

Votre client final ne voit jamais FRED : il achète chez vous, il reçoit un colis de votre marque.

Gérer vos marques

Dans le dashboard (Marques) ou par l'API :

• POST /v1/brands — créer : { "name": "Atelier Luna", "sender_name": "Luna Studio" }. sender_name (le nom imprimé sur les documents) vaut par défaut le nom de la marque.
• GET /v1/brands / GET /v1/brands/{id} — lister, consulter.
• PATCH /v1/brands/{id} — modifier nom, expéditeur, fenêtre de revue.

Fenêtre de revue

review_window_minutes (0 à 1440, défaut 60) : le délai pendant lequel une commande importée attend avant de partir en production — le temps de vérifier une personnalisation, corriger une adresse ou annuler. 0 = production immédiate.

Commander pour une marque

curl -X POST https://api.fredpod.com/v1/orders \
  -H "X-API-Key: sk_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_id": "brand_79d82ec662432f04",
    "items": [{ "quote_id": "quote_def456" }],
    "confirm": true,
    "shipping_address": { "name": "Camille Dupont", "line1": "10 rue de la Paix", "postal_code": "75002", "city": "Paris", "country": "FR" }
  }'

Une marque appartient à votre compte : commander avec le brand_id d'un autre compte renvoie 404 brand_not_found.