Protégez vos clients contre la fraude et la contrefaçon avec notre API de vérification par unboxing vidéo.
Intégrez UnboxProof en 3 étapes simples
Inscrivez-vous gratuitement et obtenez votre clé API en moins d'une minute. Aucune carte bancaire requise.
Votre clé API est générée automatiquement à l'inscription. Elle ressemble à sk_live_...
Appelez POST /api/b2b/orders lors de chaque commande. Envoyez l'URL d'unboxing à votre client.
// Exemple d'intégration Node.js — 1 seule requête API suffit
app.post('/checkout/complete', async (req, res) => {
const order = await createOrder(req.body);
// Appel UnboxProof
const safeRes = await fetch('https://unboxproof.com/api/b2b/orders', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk_live_votre_cle_api',
'Content-Type': 'application/json'
},
body: JSON.stringify({
external_order_id: order.id,
customer_email: order.customer.email,
customer_name: order.customer.name,
product_name: order.product.name,
order_amount: order.total,
currency: 'EUR'
})
});
const { verification_code, unboxing_url } = await safeRes.json();
// Envoyez l'URL par email à votre client
await sendEmail({
to: order.customer.email,
subject: 'Votre commande — Commencez votre unboxing',
html: `<a href="${unboxing_url}">Démarrer l'unboxing</a>`
});
res.json({ order, unboxing_url });
});Base URL: https://votre-domaine.com — Authentification: Authorization: Bearer sk_live_...
Crée une commande et génère un code de vérification unique. Retourne l'URL d'unboxing à envoyer au client.
# Requête
curl -X POST https://votre-domaine.com/api/b2b/orders \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"external_order_id": "ORDER-2024-001", // requis — votre ID de commande
"customer_email": "client@example.com", // requis
"customer_name": "Jean Dupont", // optionnel
"product_name": "Air Max 90 Blanc T42", // requis
"product_description": "Taille 42, blanc", // optionnel
"order_amount": 129.99, // requis
"currency": "EUR", // optionnel, défaut: EUR
"tracking_number": "FR700000001", // optionnel
"carrier": "Colissimo", // optionnel
"webhook_url": "https://votre-site.com/webhook" // optionnel
}'
# Réponse 201 Created
{
"order_id": 42,
"external_order_id": "ORDER-2024-001",
"verification_code": "A3F9",
"unboxing_url": "https://unboxproof.com/unboxing-customer.html?code=A3F9&order=42",
"qr_code_url": "https://unboxproof.com/api/b2b/orders/42/qr",
"message": "Commande créée. Partagez le verification_code ou unboxing_url avec votre client."
}Récupère la liste paginée de vos commandes. Filtrage par statut disponible.
curl "https://votre-domaine.com/api/b2b/orders?status=unboxing_submitted&page=1&limit=20" \
-H "Authorization: Bearer sk_live_..."
# Statuts possibles: pending, shipped, unboxing_pending,
# unboxing_submitted, completed, disputed, refundedRécupère une commande avec son unboxing associé si disponible.
curl "https://votre-domaine.com/api/b2b/orders/42" \
-H "Authorization: Bearer sk_live_..."
# Réponse inclut l'objet "unboxing" si soumis:
{
"id": 42,
"status": "unboxing_submitted",
...
"unboxing": {
"ai_confidence": 0.91,
"code_visible": 1,
"condition_ok": 1,
"photo_urls": ["/uploads/..."],
"customer_notes": "Tout est parfait"
}
}Passe la commande en statut "shipped". Appelable uniquement depuis le statut "pending".
curl -X PATCH https://votre-domaine.com/api/b2b/orders/42/ship \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"tracking_number": "FR700000001", "carrier": "Colissimo"}'Confirme la livraison et ouvre une fenêtre de 48h pour que le client soumette son unboxing. Idéalement appelé sur webhook de votre transporteur.
curl -X PATCH https://votre-domaine.com/api/b2b/orders/42/deliver \
-H "Authorization: Bearer sk_live_..."
# Réponse
{
"message": "Livraison confirmée. Fenêtre unboxing de 48h ouverte.",
"unboxing_deadline": "2024-12-20T14:30:00.000Z"
}Finalise une commande après examen de l'unboxing. "completed" = tout est OK. "refunded" = problème détecté.
curl -X PATCH https://votre-domaine.com/api/b2b/orders/42/resolve \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"resolution": "completed"}' // ou "refunded"Récupère vos statistiques globales: commandes totales, fraudes prévenues, répartition par statut.
curl "https://votre-domaine.com/api/b2b/stats" \
-H "Authorization: Bearer sk_live_..."
# Réponse
{
"company": { "name": "Nike", "plan": "enterprise", "monthly_orders_used": 247 },
"total_orders": 1842,
"fraud_prevented": 23,
"status_breakdown": [
{ "status": "completed", "count": 1756 },
{ "status": "unboxing_submitted", "count": 43 },
...
]
}Démarrez gratuitement, évoluez selon vos besoins