On this page

Create Order

Synchronize ecommerce orders with Brevo to automatically calculate loyalty points, update customer tiers, and trigger personalized marketing campaigns.

Quick Start

Basic Order Creation 

POST https://api.brevo.com/v3/ecommerce/orders
Content-Type: application/json
api-key: YOUR_API_KEY


{
  "id": "ORD-2024-001",
  "email": "[email protected]",
  "billing": {
    "address": "123 Main St",
    "city": "New York",
    "country": "US",
    "phone": "+1234567890"
  },
  "products": [
    {
      "id": "PROD-123",
      "name": "Premium Widget",
      "quantity": 2,
      "price": 149.99,
      "category": ["Electronics", "Gadgets"]
    }
  ],
  "revenue": 309.97,
  "date": "2024-01-25T14:30:00Z"
}

Response 

{
  "id": "ORD-2024-001",
  "created": true,
  "loyaltyPointsAwarded": 310
}

Tajo Loyalty Integration

Order with Loyalty Calculation 

{
  "id": "ORD-2024-001",
  "email": "[email protected]",
  "customerId": "CUST-12345",
  "loyaltyId": "LYL-2024-001",


  "billing": {
    "name": "John Doe",
    "address": "123 Main St",
    "city": "New York",
    "state": "NY",
    "country": "US",
    "zipCode": "10001",
    "phone": "+1234567890"
  },


  "shipping": {
    "name": "John Doe",
    "address": "456 Oak Ave",
    "city": "Brooklyn",
    "state": "NY",
    "country": "US",
    "zipCode": "11201",
    "method": "Standard Shipping",
    "cost": 9.99
  },


  "products": [
    {
      "id": "PROD-123",
      "name": "Smart Watch Pro",
      "variant": "Black/42mm",
      "sku": "SW-PRO-BLK-42",
      "quantity": 1,
      "price": 299.99,
      "category": ["Electronics", "Wearables"],
      "brand": "TechBrand",
      "loyaltyPointsEarned": 300,
      "loyaltyMultiplier": 1.0
    },
    {
      "id": "PROD-456",
      "name": "Wireless Charger",
      "sku": "WC-FAST-01",
      "quantity": 1,
      "price": 49.99,
      "category": ["Electronics", "Accessories"],
      "loyaltyPointsEarned": 50,
      "loyaltyMultiplier": 1.0
    }
  ],


  "financial": {
    "subtotal": 349.98,
    "shipping": 9.99,
    "tax": 28.00,
    "discount": 35.00,
    "total": 352.97,
    "currency": "USD",
    "paymentMethod": "Credit Card",
    "paymentStatus": "Completed"
  },


  "loyalty": {
    "pointsEarned": 353,
    "bonusPoints": 50,
    "pointsMultiplier": 1.2,
    "tierBefore": "Silver",
    "tierAfter": "Gold",
    "tierUpgraded": true,
    "totalPointsBalance": 2853,
    "couponUsed": "SAVE10",
    "couponDiscount": 35.00
  },


  "metadata": {
    "source": "Website",
    "campaign": "Summer Sale",
    "referrer": "Google Ads",
    "userAgent": "Mobile App",
    "firstPurchase": false,
    "returningCustomer": true
  },


  "date": "2024-01-25T14:30:00Z",
  "status": "Completed"
}

Advanced Loyalty Features

Birthday Bonus Order 

{
  "loyalty": {
    "pointsEarned": 200,
    "birthdayBonus": 500,
    "bonusReason": "Birthday Month",
    "totalBonusPoints": 500,
    "pointsMultiplier": 2.0,
    "specialOffer": "Double Points Week"
  }
}

Referral Order 

{
  "loyalty": {
    "pointsEarned": 150,
    "referralBonus": 250,
    "referredBy": "CUST-67890",
    "referralCode": "REF-FRIEND50",
    "firstPurchaseBonus": 100
  },
  "metadata": {
    "isReferralOrder": true,
    "referralSource": "Friend Referral"
  }
}

Subscription Order 

{
  "subscription": {
    "id": "SUB-2024-001",
    "type": "Monthly",
    "frequency": 30,
    "nextBilling": "2024-02-25",
    "isRecurring": true
  },
  "loyalty": {
    "pointsEarned": 100,
    "subscriptionBonus": 50,
    "loyaltyMultiplier": 1.1
  }
}

Product Categories for Loyalty

Category-based Point Multipliers 

{
  "products": [
    {
      "id": "PROD-LUXURY-001",
      "category": ["Luxury", "Fashion"],
      "loyaltyMultiplier": 2.0,
      "loyaltyPointsEarned": 400
    },
    {
      "id": "PROD-ECO-001",
      "category": ["Eco-Friendly", "Sustainable"],
      "loyaltyMultiplier": 1.5,
      "loyaltyBonus": "Eco Warrior"
    }
  ]
}

Order Status Updates

Order Fulfillment 

{
  "id": "ORD-2024-001",
  "status": "Shipped",
  "tracking": {
    "number": "TRK123456789",
    "carrier": "UPS",
    "url": "https://tracking.ups.com/TRK123456789"
  },
  "fulfillment": {
    "date": "2024-01-26T10:00:00Z",
    "warehouse": "NYC-01",
    "method": "Ground Shipping"
  }
}

Order Completion 

{
  "id": "ORD-2024-001",
  "status": "Delivered",
  "delivery": {
    "date": "2024-01-28T16:30:00Z",
    "signature": "Customer",
    "location": "Front Door"
  },
  "loyalty": {
    "reviewIncentive": 25,
    "reviewIncentiveExpiry": "2024-02-28"
  }
}

Batch Order Processing

Create multiple orders for bulk sync:

{
  "orders": [
    {
      "id": "ORD-2024-001",
      "email": "[email protected]",
      "products": [...],
      "revenue": 199.99
    },
    {
      "id": "ORD-2024-002",
      "email": "[email protected]",
      "products": [...],
      "revenue": 299.99
    }
  ]
}

Error Handling 

{
  "code": "duplicate_order",
  "message": "Order ID already exists",
  "details": {
    "orderId": "ORD-2024-001",
    "existingDate": "2024-01-25T14:30:00Z"
  }
}
{
  "code": "invalid_customer",
  "message": "Customer email not found",
  "details": {
    "email": "[email protected]",
    "suggestion": "Create contact first"
  }
}

Webhooks Integration

Set up webhooks to sync order status changes:

{
  "webhookUrl": "https://your-tajo-app.com/webhooks/brevo",
  "events": [
    "order.created",
    "order.updated",
    "order.shipped",
    "order.delivered",
    "loyalty.points.awarded"
  ]
}

Best Practices for Tajo

  1. Real-time Sync: Create orders immediately after checkout
  2. Complete Data: Include all loyalty-relevant information
  3. Status Updates: Keep order status current for accurate tracking
  4. Error Recovery: Handle duplicate orders and missing customers gracefully
  5. Point Calculation: Verify loyalty point calculations match your system
  6. Customer Segmentation: Use order data for targeted campaigns

Analytics & Reporting

Track key metrics:

  • Order value trends
  • Loyalty point redemption rates
  • Customer lifetime value
  • Tier upgrade patterns
  • Campaign effectiveness

Next Steps